Overview
The List Item control is essentially like a button control that serves as an item in a Scroll List control except that it "selectable" and will remain in the active state when selected, much like a radio button. The containing scroll list will track which list item control is the currently selected item. One common use of List Items is to store them in prefab form and then either add them to a list's Prefab Items array, or instantiate them at runtime from code to populate a Scroll List. There are two main approaches you can take to using a List Item:

  1. Create a separate list item with a unique texture for each item you wish to display, or

  2. Use a single base List Item and then represent different options by different text on each item instance.

NOTE: If you want to nest multiple sub-controls, sprites, or text inside your list item, it is recommended instead to use a UIListItemContainer which is capable of clipping sub-controls to the viewable area of the scroll list. In such a case, to reproduce the radio-button like functionality of a UIListItem, use radio button controls inside your UIListItemContainer objects, then uncheck their "Use Parent For Grouping" option, then set the Radio Group setting to the same value for all radio buttons which are to be mutually exclusive with one another.
Class
Interactivity
You do not usually interact directly with a List Item through script, but rather operate through a Scroll List.
Control-specific Properties
Active Only When Selected
When this is set to true (default), the list item will only enter its Active state/appearance once it has been selected. Normally, a button (from which the list item control derives) will appear active when "held down" by a click or touch. Since list items are meant to be used in scroll lists, however, it is normally desirable that the items not take on this appearance until the user has lifted the touch/click, indicating their intent to select the item. Otherwise, a touch/click intended to scroll the list would momentarily result in the item appearing "Active", and then would return to "Normal" once the gesture was detected as a drag.
Data
(Accessible through script) This is a reference to type System.Object that can serve as a general-purpose reference to any data you wish to associate with this list item. This can be useful to determine which item the user selected from the list. This member is actually common to all controls.
States
normal
This is the state when the item has no pointing device over it and it is not disabled.
over
This state is entered when a pointing device hovers over the item and is exited when the pointing device leaves the item area (unless it is being held down, in which case, it is exited when the device is both out of the item area and no longer held down). This state is never entered when UIManager.pointerType is set to TOUCHPAD.
active
This state is entered when the item is pressed by a pointing device and is exited when the pointing device is released. "Pressed" refers to when, for example, a mouse button is held down, or a touch occurs on a touchpad. "Released" refers to when, for example, a mouse button is released, or a touch ends on a touchpad.
disabled
This state indicates that the item is disabled and will not receive input.