npm.io
1.4.1 • Published 8 years ago

listview-navigator

Licence
MIT
Version
1.4.1
Deps
4
Vulns
0
Weekly
0

listview-navigator

Delegate arrow key down or up operation on list container. For a list, it will be a more friendly interaction if it could react to uparrow or downarrow event. That's why this package exist. However, for this packages it has some constraints and requirement:

  1. The length of list should be set on initial state.

  2. List item should have fixed height.

usage

import ListViewNavigator from 'listview-navigator';

this.listNavigator = new ListViewNavigator({
  target: this.listNode,
  max: this.dataSource.length,
  itemHeight: this.itemHeight,
});

On press uparrow or downarrow, it will emit change event. The arguments on callback function will nextIndex and index;

this.listNavigator.on('change', (nextIndex, index) => {
  // ...
})

On press Enter, it will emit commit event. The arguments on callback function will nextIndex and index;

this.listNavigator.on('commit', (nextIndex, index) => {
  // ...
})

API

ListViewNavigator
Arguments
  • target(HTMLElement): The list container which will delegated to.
  • itemHeight(Number): The list item height.
  • max(Number): The count of list items