react-toolbox/components/dropdown
Javi Velasco 0cb8d8bdb2 Get rid of jsx extensions 🔮 2016-04-10 21:23:04 +02:00
..
Dropdown.js Get rid of jsx extensions 🔮 2016-04-10 21:23:04 +02:00
_config.scss Added !default to all config values as per #424 2016-04-02 00:47:39 +02:00
index.js Remove jsx extension from imports in components 2015-11-28 20:24:46 +01:00
readme.md Merge branch 'dev' of https://github.com/react-toolbox/react-toolbox into update-docs 2016-04-06 20:50:12 -04:00
style.scss Fix #425 2016-04-10 19:15:29 +02:00

readme.md

Dropdown

The Dropdown selects an option between multiple selections. The element displays the current state and a down arrow. When it is clicked, it displays the list of available options.

import Dropdown from 'react-toolbox/lib/dropdown';

const countries = [
  { value: 'EN-gb', label: 'England' },
  { value: 'ES-es', label: 'Spain'},
  { value: 'TH-th', label: 'Thailand' },
  { value: 'EN-en', label: 'USA'}
];

class DropdownTest extends React.Component {
  state = {
    value: 'ES-es',
  };

  handleChange = (value) => {
    this.setState({value: value});
  };

  render () {
    return (
      <Dropdown
        auto
        onChange={this.handleChange}
        source={countries}
        value={this.state.value}
      />
    );
  }
}

Properties

Name Type Default Description
allowBlank Boolean true If true the dropdown will preselect the first item if the supplied value matches none of the options' values.
auto Boolean true If true, the dropdown will open up or down depending on the position in the screen.
className String '' Set the class to give custom styles to the dropdown.
disabled Boolean false Set the component as disabled.
error String Give an error string to display under the field.
label String The text string to use for the floating label element.
onBlur Function Callback function that is fired when the component is blurred.
onChange Function Callback function that is fired when the component's value changes.
onFocus Function Callback function that is fired when the component is focused.
source Array Array of data objects with the data to represent in the dropdown.
template Function Callback function that returns a JSX template to represent the element.
value String Default value using JSON data.