Updated: December 20, 2016

Object Display Components

sap.m.ObjectStatus | sap.m.ObjectIdentifier | sap.m.ObjectNumber | sap.m.ObjectMarker (since 1.38)

Intro

There are three types of object display component: object status, object identifier and object number.

Object Status

The object status is a short text that represents the semantic status of an object. It has a semantic color and an optional icon. As such, you can generally find the object status in the object header and in the table as a status attribute of a line item.

Object Identifier

The object identifier is a short text that represents the key identifier of an object.

You can find the object identifier in a table as an identifier of the line item.

Object Number

The object number is a short text that represents the numeric (key) attribute of an object and its unit. The number has a semantic color, and the unit inherits the same color from its number. The number can be emphasized (default setting) when it is used for the key attribute, and non-emphasized when it is used for any other numeric attribute of the item.

The object number is generally used to indicate the key attribute of an object in the object header, and as an attribute of a line item in a table.

Object Marker

The object marker allows you to express the technical status of an object.

The technical status can be represented as icon, icon and text, or as text only, depending on the screen size. See the guidelines section below to find out when to use which visibility option.

Currently, the following technical statuses can be visualized by the object marker:

  • Flag
  • Favorite
  • Editing Status (Draft, Locked, Unsaved Changes)

Usage

Use the object status if:

  • You need to display the semantic status of an object: negative (property: error), critical (property: warning), positive (property: success), or neutral (property: none).
  • You need to show that the current object instance is locked by another user.

Use the object number if:

  • You want to display the key attribute of an object. In this case, keep the emphasized default setting (property: emphasized).
  • You need to display one or more numeric attributes of an object that, for example, you want to compare (property: emphasized set to “false”).

Use the object identifier if:

  • You want to indicate the key identifier of the object.

Do not use the object status or object number if:

  • You want to display system messages.

Do not use the object display components if:

  • They are for decoration purposes only.

Responsiveness

  • The object status wraps if it is too long for the screen width available.
  • The object identifier text wraps if the size of the screen becomes too small to display the entire text on one line.
  • The object number does not wrap or truncate. For large numbers, you need to consider using the appropriate formatting.

Components

Object Status

The object status consists of the following:

  • A semantically-colored text (property: text)
  • An optional icon (property: icon)
  • A title that serves as a label (property: title)

It is mainly used with semantically-colored text only.

Semantic colors for object status
Semantic colors for object status

Object Identifier

The object identifier has the following properties:

  • A title text (property: title)
Object identifier – Text only
Object identifier – Text only
  • An optional additional descriptive text (property: text)
Object identifier – With subtitle
Object identifier – With subtitle
  • The title can be set to active. In this case, it looks like a link and can fire an event (property: titleActive).
Object identifier – Actionable
Object identifier – Actionable
  • Both texts wrap if the space available is insufficient to fit each of them on one line.
Object identifier – Long texts wrap
Object identifier – Long texts wrap

Object Number

The object number consists of the following:

  • A semantically-colored text (property: number), which can be set to non-emphasized when used in the content area (property: emphasized)
  • An optional unit (property: unit)
Object numbers
Object numbers

Guidelines

Object Status

  • Use semantic text only, and avoid using it with an icon.
  • Use the following semantics to indicate the status: negative (property: error), critical (property: warning), positive (property: success), and neutral (property: none).
Preferably use semantic text only
Preferably use semantic text only
  • Only use icons if they are unambiguous and easily understood (such as a padlock for locked items). If you feel your icon would need a descriptive text to be understood, use text only.
  • For locked items, you may also add information about who is currently locking the item.
Status locked
Status locked
Status locked by a certain user
Status locked by a certain user
  • Do not use the title of the object status outside the object header. Even though the title and the status text wrap, keep them both as short as possible.
Avoid long title and text where possible
Avoid long title and text where possible
  • When used in a table, the object status should be center-aligned.
Object status should be center-aligned
Object status should be center-aligned

Object Identifier

  • The object identifier should be easily readable (preferably the display text and not the ID). If the ID is necessary to distinguish between items that use the same title, it should appear in brackets, such as Product ABC (1234567). Whether you include the ID in the text property can also depend on how long you expect the text to be.
  • The object identifier can also be shown as a link. In this case, the event opens the quick view of the object.

Object Number

  • Use the following semantics to indicate the status: negative (property: error), critical (property: warning), positive (property: success), and neutral (property: none).
Neutral object number (856.49 EUR) used as a key attribute in the object header
Neutral object number (856.49 EUR) used as a key attribute in the object header
  • If the object number is the key attribute of the object inside the content area, the number should be emphasized when it is used as a line item status in a table.
Object number with key attribute
Object number with key attribute
  • The object number can also be used to visualize other semantic numeric attributes. In this case, they are not emphasized unless they are the key attribute, such as a sum.
Object number used as an attribute (weight) and as a key attribute (price)
Object number used as an attribute (weight) and as a key attribute (price)

Resources

Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

Elements and Controls

  • No link

Implementation