Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Extends: LabelList 

Description

The CheckList node class is a simple list class that displays a list of items, some of which include checkboxes that allow the user to select or unselect that item. Each item in the list displays a text string and an optional checkbox icon positioned to the left of the text string. If the checkbox is displayed, it is shown as either an empty box, or a box with a checkmark indicator inside, indicating where the item is in the checked or unchecked state.

Fields

FieldTypeDefaultUse
checkedStatearray of booleansarray of all false values

Specifies the checked state of each item in the list. A value of true indicates the item is in the checked state. A value of false indicates that the item is in the unchecked state.

When reading the value of the field, checkedState will always include one value for each item in the list.

When writing the value of the field, if the specified array includes fewer values than items in the list, the list items that are unspecified will remain in their current state. For example, if there are 10 items in the list and checkedState is set to [ true, true ], items 0 and 1 will have their checked state set to true and the checked state of the remaining items (items 3 to 9) will be unchanged.

checkOnSelectbooleantrue

Controls whether or not pressing the Select/OK key causes the checkedItems field to automatically toggle the checked state of the currently focused list item.

By default, checkOnSelect is set to true, but there are use cases where other behavior may be desired. In those cases, it is up to the developer to manage the checked state of the list items by setting the checkedItems field to the desired index.

checkedIconUriuri stringSystem DefaultSpecifies the checkbox icon to use for list items that are in the checked state when that list item does not the key focus. Typically, the icon will include the outline of a box with a checkmark indicator inside.
uncheckedIconUriuri stringSystem DefaultSpecifies the checkbox icon to use for list items that are in the unchecked state when that list item does not have the key focus. Typically, the icon will include the outline of an empty box.
focusedCheckedIconUriuri stringSystem DefaultSpecifies the checkbox icon to use for list items that are in the checked state when that list item has the key focus. Typically, the icon will include the outline of a box with a checkmark indicator inside.
focusedUncheckedIconUriuri stringSystem DefaultSpecifies the checkbox icon to use for list items that are in the unchecked state when that list item has the key focus. Typically, the icon will include the outline of an empty box.

Data Bindings

The data model for the LabelList node should have a single ContentNode node as the root node. The structure of the rest of the data model depends on whether or not the list items are to be grouped into sections.

No Sections

If the list items are not to be grouped into sections, one child ContentNode node should be added to the root node for each item in the list (these child nodes can be thought of as item nodes). Item nodes should have their content meta-data attributes set as shown in the table below.

AttributeTypeDescription
TITLEstringThe label for the list item
HIDEICONbooleanWhen set to true, the default, the list item displays the checkbox icon, reflecting the item's current selection state. When set to false, no checkbox icon is displayed, allowing the list to contain a mix of checkbox and regular list items.

Has Sections

If the list items are to be grouped into sections, one child ContentNode node should be added to the root node for each section in the list (these child nodes can be thought of as section roots). Each section root should contain one child ContentNode node for each item in the section (that is, item nodes). Each item ContentNode node uses the same content meta-data as the item nodes when there are no sections, as shown in the table above.

The section root ContentNode node uses the following content meta-data attributes:

AttributeTypeDescription
CONTENTTYPE

content meta-data

Must be set to SECTION
TITLEstringLabel for the section divider
HDGRIDPOSTERURLURI stringThe image file for the icon to be displayed to the left of the section label when the screen resolution is set to HD.
SDGRIDPOSTERURLstringThe image file for the icon to be displayed to the left of the section label when the screen resolution is set to SD.
  • No labels