The Object Cell is a Table View Cell that fits inside the Table View container. It is highly customizable so as to accommodate a wide variety of uses.
It is intended to be used to preview information about an object and can be tapped to navigate to a full view of that object’s information, usually displayed as an Object Page. It does not always need to be used in this way, however, and can be customized to be used for object detail lists that can be found in Object Details pages.
A. Editing Control (In Edit Mode)
An editing control appears only when in edit mode. When this mode is triggered, the content shifts to the right, and the control appears on the left. Any navigational indicator, such as the chevron or information disclosure icon, disappears while in edit mode.
B. Icon Stack (Optional)
A set of up to 3 vertically stacked icons can be displayed on the far left. These icons indicate something about the object, such as its unread status or that it has attachments.
C. Detail Image (Optional)
An image representing the object can be set. The image can be square or circular and has a minimum size of 32 pixels and a maximum of 60 pixels. When using the detail image to display an individual’s profile image, it must be set as circular at 45 pixels.
The title is the main area for text content. It allows for a title, subtitle, and footnote. The title is the only mandatory content for the Object Cell.
E. Description (Optional)
If a description has been defined, it will appear in regular mode only. This is typically a longer string of text than what is displayed in the title content.
F. Attribute (Optional)
If an object has an attribute, such as a status, associated with it, it can be displayed on the right, in front of the accessory view. Up to two attributes can be displayed, stacked vertically. The attribute can be in the form of text or icon.
G. Accessory View (Optional)
The accessory view is usually a navigational icon, such as a chevron, which would trigger a push navigation, or an information disclosure icon, which would bring up a model. It can also be used for actions, such as download.
The Preview Object Cell variation is the most common variation. It is used to display a preview of an object. A chevron icon is used on the right to indicate a drill down to the complete content, usually as an Object page. The Preview variation is commonly found in the Overview, List Report, Worklist, and Object Floorplans.
The Quick View Object Cell variation is used to display a simple object that doesn’t need a full Object page. Instead, an information disclosure icon is used on the right, which brings up a modal when tapped. In the modal, some more information for the object can be viewed and a few simple actions can be performed. The Quick View variation is commonly found in the Overview, Object, and Object Details Floorplans.
The Single Action Object Cell variation is used to display an object that has a specific action associated with it, such as downloading a document or adding an item to your cart. An icon or button is used on the right, indicating what the action is. The button can also be set to act as a toggle (for example, ‘follow/unfollow’). The Action variation is commonly found in the List Report Floorplan.
The Text Display Object Cell variation is used to display complete information where the cell expands in place. This variation should be used when it does not require any further drill down. There is a collapsed state and an expanded state that is triggered by tapping the ‘More/Less’ text. The default view is the collapsed state. This variation is commonly found in the Object Details Floorplan.
Not yet available in the SDK.
Select (Edit Mode)
When Edit Mode is triggered, users can select single or multiple object cells at once to perform an action such as delete, change status, and so on.
Quick actions are activated by a gesture such as swipe to delete.
Peek & Pop
Users can activate a Peek & Pop preview of an object by holding a long press on the object cell.
The Preview and Quick View variations both include a navigational aspect. The Preview uses a chevron icon to indicate a push to the full content of the object, while the Quick View uses an information disclosure icon to indicate that a modal will pop up with the full content of the object.