List

Display items in the list

Create a data provider in MXML:

<js:List labelField="label">
    <js:dataProvider>
        <fx:Array>
            <fx:Object label="One"/>
            <fx:Object label="Two"/>
            <fx:Object label="Three"/>
            <fx:Object label="Four"/>
            <fx:Object label="Five"/>
        </fx:Array>
    </js:dataProvider>
</js:List>

The labelField specifies which property of the items will be displayed as text in the list's item renderers.

Listen to events

Listen for selection changes:

<js:List id="list" labelField="label" change="onChange(event)"/>
<fx:Script>
    <![CDATA[
        private function onChange(event:Event):void
        {
            var selectedIndex:int = list.selectedIndex;
            var selectedItem:Object = list.selectedItem;
            trace("index:", selectedIndex);
            trace("label:", selectedItem.label);
        }
    ]]>
</fx:Script>