Package Exports

select-box

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (select-box) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

select-box

A minimal DOM <select> utility. Pull requests / suggestions welcome.

//create a select box
var box = require('select-box')(['Monday', 'Tuesday', 'Wednesday'])

//select an item programmatically
box.select('Tuesday')

box.on('change', function(ev) {
    //get name of selected item
    console.log(box.selected())
})

//have it displayed on page
document.body.appendChild(box.element)

Usage

See demo for a complete example.

`box = SelectBox([items])`

Creates a new select box with the optional items to add.

`box.add(items)`

Adds a single item or an array of items to this select box. An "item" is just a string (which indicates value and name), or an object:

{
    name: 'Tuesday',
    value: 'tuesday', 
    disabled: false
}

`box.clear()`

Clears the data in the box.

`box.set(data)`

Clears the current data in the box and adds the specified data.

`box.selected()`

Gets the selected value for this combo box.

`box.selectedIndex()`

Same as selected(), but returns the index of the entry in the data list.

`box.select(value)`

Selects the item by value in this combo box, if it exists.

`box.data`

The internal data which was passed to add, set or a constructor. This should not be modified externally, although it could be used to retrieve values and names of each entry.

`box.on('change')`

Receives the onchange DOM event.

License

MIT, see LICENSE.md for details.