Intro
Object cells consist of text, images, or icons. They can be configured in various ways to accommodate a wide range of use cases.
Object cell on compact (left) and expanded screen (right)
Usage
Do
Use an object cell to preview information about an item in a list format.
Don't
Don’t use an object cell to compare attributes from different list items. Use a data table instead.
Anatomy
An object cell may contain text labels, images, or icons each with a specific purpose. These content types are structured in the following way and can be reconfigured, added or removed:
A. Container
The container holds all content types. The container height depends on the height of the tallest vertical element while the container width is defined by the view.
B. Unread Indicator (Optional)
The unread indicator informs users about new or unseen object cells. It automatically disappears after the user views the content or interacts with it.
C. Left Icon Stack (Optional)
A set of up to two vertically stacked icons can be displayed on the far left. These icons provide information about the object, such as whether it is unread or if it has attachments.
D. Title Area
The title area is used to place the main text content related to the object. The title area is limited to three lines of text, (title, subtitle, and caption) and is the only mandatory content for the object cell.
E. Main Content
The main content is the main area for text content. It allows for a title, subtitle, caption, description, rating control, avatar row, status info label and tags. The title is the only mandatory content for the object cell.
F. Description (Optional)
A description can be used to provide additional information about the object. The description label can wrap up to three lines and will truncate after that. On compact and medium screens, it appears at the bottom of the main content. On expanded screens, the description is displayed in its own column.
G. Status Info (Optional)
The status info is a vertically stacked arrangement consisting of labels and/or icon types that are displayed towards the right. The icons or labels can be used to indicate the condition of the item, such as its priority or status.
H. Action Area (Optional)
The action area is used to add secondary actions in addition to the primary action of drilling down. These secondary actions can include information disclosure, download options, or an overflow menu.
Anatomy of the object cell
Behavior and Interaction
The following are behaviors found throughout all object cells. These behaviors can be enabled or disabled depending on the app’s needs.
Drill-Down
Navigating to another page using drill down
Selection Mode
Selecting items within a list
Swipe
Deleting an item with a swipe action
Overflow Menu
The direction in which the overflow menu opens is determined by the native Android system.
selecting the overflow icon of an object cell and opening the action menu
Variations
Different variations of the object cell can be created by reconfiguring different content types. Moving in this modular approach allows it to cover simple as well as complex requirements.
Navigation
Single-line object cell used to navigate to a specific page
Preview
Three-line object cell used to surface an object's detail
Contact
The contact variation is similar to the preview variation but provides quick access to various methods of communicating with a contact. This variation consists of but is not limited to a container, image, title area, and actions.
See Contact Cell for more information.
A two-line object cell with multiple inline actions on the right
Single Action
Object cell with single action on the right
Control
A single-line object cell with a radio button on the left
Adaptive Design
The object cell is supported in both mobile and tablet devices. All content types are supported in both device sizes (i.e. Description is now supported in mobile).
Object cell on compact (top) and expanded screen (bottom)
Resources
Development: FioriObjectCell, ObjectCell, GridObjectCell, GridTableRow, ContactCell
SAP Fiori for iOS: Object Cell
Material Design: Lists
Related Components/Patterns: Checkbox, Radio Button, Card Cell, Rating Control, Tags, Status Info Label, Menu