Skip to content

Latest commit

 

History

History
27 lines (20 loc) · 1.09 KB

README.md

File metadata and controls

27 lines (20 loc) · 1.09 KB
Raw

@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