List Item Base Widgets

Most of the list item widgets follow similar UI traits. To provide ease of implementation and uniform behavior, a set of abstract classes is used to build the list item widgets. These are classified as list item base widgets.

List Item Title Widget

This widget defines the UI elements that each list item should have.

The UI elements can be customized to match the style of the user's application. The customizations can be done programmatically using the APIs.

APIs

List of the customization APIs

• UIFont *titleFont; - The font/size to use for the title.
• UIColor *titleColor; - The color to draw the title with.
• UIColor *disconnectedValueColor; - The color to draw the information area text when disconnected.
• UIColor *normalValueColor; - The color to draw the information area text when active.
• UIColor *warningValueColor; - The color to draw the information area text when in a warning state.
• UIColor *errorValueColor; - The color to draw the information area text when in an error or danger state.
• UIColor *iconTintColor; - The tint color applied to the icon.
• UIColor *backgroundColor; - The background color for the widget.
• UIImage *iconImage; - The icon to be drawn on the left side of the widget.

Hooks

The widget provides hooks for users to add functionality based on state changes in the widget.

The list item base widget provides the following hooks:

1. ListItemTitleModelState - Provides hooks in events received by the widget from the widget model updates.

• + (instancetype)productConnected:(BOOL)isConnected - Event sent when product is connected or disconnected.

2. ListItemTitleUIState - Provides hooks in events received by the widget from the user interface interactions.

• + (instancetype)dialogDisplayed:(id)info; - Sends the string identifier for a dialog being displayed (usually in response to a button tap or edit value update).
• + (instancetype)dialogActionConfirmed:(id)info; - Sends the string identifier for a dialog after the OK/Confirmation button was tapped in the displayed dialog.
• + (instancetype)dialogActionCanceled:(id)info; - Sends the string identifier for a dialog after the Cancel button was tapped in the displayed dialog.
• + (instancetype)dialogActionDismissed:(id)info; - Sends the string identifier for a dialog after the Cancel/Dismiss button was tapped in the displayed dialog.

This widget has been further expanded into:

1. List Item Label Button Widget
2. List Item Edit Text Button Widget
3. List Item Radio Button Widget