# @dojo/widgets/list

Dojo's `List` provides a base widget that can be used as a List or an options List within a `Select`, `Typeahead`, etc.

## Features

- Handles keyboard interactions if given focus
- Can be controlled through `activeIndex` and `onActiveIndexChange` in conjunction with `focusable: false`.
- Handles native style scrolling
- Provides a custom renderer for more complex List items
- Active selection follows mouse as per native behavior

### Keyboard Usage

`List` supports keyboard navigation for highlighting and selecting options.

- Enter Key: selects the current option
- Space Key: selects the current option
- Up Arrow: highlights the previous option
- Down Arrow: highlights the next option
- a-z, 0-9: highlights matching entries, ie. `ne` would match `nevada` in a list of states.

### ListItem
When using a custom renderer, the `ListItem` widget supports different child properties.
- Leading: Content to display at the start of the list item, such as an icon
- Primary: Main content of the list item
- Trailing: Content to display at the end of the list item, such as minor details