box-ui-elements/src/components/select-field/SingleSelectField.md

Box UI Elements

### Examples

```
const [state, setState] = React.useState({ selectedValue: 'b' });

const options = [
    { displayText: 'Option A', value: 'a' },
    { displayText: 'Option B', value: 'b' },
    { displayText: 'Option C', value: 'c' },
    { displayText: 'Option D', value: 'd' },
    { displayText: 'Option E', value: 'e' },
];

const separatorIndices = [2, 4];

const handleChange = selectedOption => {
    setState(prevState => ({
        ...prevState,
        selectedValue: selectedOption.value,
    }));
};

<SingleSelectField
    isDisabled={ false }
    onChange={ handleChange }
    options={ options }
    selectedValue={ state.selectedValue }
    separatorIndices={ separatorIndices }
/>
```

Clear Option Enabled

```
const [state, setState] = React.useState({ selectedValue: 'b' });

const options = [
    { displayText: 'Option A', value: 'a' },
    { displayText: 'Option B', value: 'b' },
    { displayText: 'Option C', value: 'c' },
    { displayText: 'Option D', value: 'd' },
    { displayText: 'Option E', value: 'e' },
];

const handleChange = selectedOption => {
    setState(prevState => ({
        ...prevState,
        selectedValue: selectedOption.value,
    }));
};

<SingleSelectField
    onChange={ handleChange }
    options={ options }
    selectedValue={ state.selectedValue }
    shouldShowClearOption={true}
/>
```

Search Input Enabled

```
const [state, setState] = React.useState({ selectedValue: 'b' });

const options = [
    { displayText: 'Option A', value: 'a' },
    { displayText: 'Option B', value: 'b' },
    { displayText: 'Option C', value: 'c' },
    { displayText: 'Option D', value: 'd' },
    { displayText: 'Option E', value: 'e' },
];

const handleChange = selectedOption => {
    setState(prevState => ({
        ...prevState,
        selectedValue: selectedOption.value,
    }));
};

<SingleSelectField
    onChange={ handleChange }
    options={ options }
    selectedValue={ state.selectedValue }
    shouldShowSearchInput={true}
/>
```

Search Input and Clear Option Enabled

```
const [state, setState] = React.useState({ selectedValue: 'b' });

const options = [
    { displayText: 'Option A', value: 'a' },
    { displayText: 'Option B', value: 'b' },
    { displayText: 'Option C', value: 'c' },
    { displayText: 'Option D', value: 'd' },
    { displayText: 'Option E', value: 'e' },
];

const handleChange = selectedOption => {
    setState(prevState => ({
        ...prevState,
        selectedValue: selectedOption.value,
    }));
};

<SingleSelectField
    onChange={ handleChange }
    options={ options }
    selectedValue={ state.selectedValue }
    shouldShowSearchInput={true}
    shouldShowClearOption={true}
/>
```

Disabled

```
const [state, setState] = React.useState({ selectedValue: 'b' });

const options = [
    { displayText: 'Option A', value: 'a' },
    { displayText: 'Option B', value: 'b' },
    { displayText: 'Option C', value: 'c' },
    { displayText: 'Option D', value: 'd' },
    { displayText: 'Option E', value: 'e' },
];

<SingleSelectField
    isDisabled
    onChange={ () => {} }
    options={ options }
    selectedValue={ state.selectedValue }
/>
```

Labeled

```
const [state, setState] = React.useState({ selectedValue: 'b' });

const options = [
    { displayText: 'Option A', value: 'a' },
    { displayText: 'Option B', value: 'b' },
    { displayText: 'Option C', value: 'c' },
    { displayText: 'Option D', value: 'd' },
    { displayText: 'Option E', value: 'e' },
];

const handleChange = selectedOption => {
    setState(prevState => ({
        ...prevState,
        selectedValue: selectedOption.value,
    }));
};

<Label text="Single select field">
    <SingleSelectField
        onChange={ handleChange }
        options={ options }
        selectedValue={ state.selectedValue }
    />
</Label>
```

Header Content

```
const [state, setState] = React.useState({ selectedValue: 'b' });

const options = [
    { displayText: 'Option A', value: 'a' },
    { displayText: 'Option B', value: 'b' },
    { displayText: 'Option C', value: 'c' },
    { displayText: 'Option D', value: 'd' },
    { displayText: 'Option E', value: 'e' },
];

const handleChange = selectedOption => {
    setState(prevState => ({
        ...prevState,
        selectedValue: selectedOption.value,
    }));
};

<SingleSelectField
    onChange={ handleChange }
    options={ options }
    selectedValue={ state.selectedValue }
    shouldShowClearOption={true}
/>
```

Invalid

```
const [state, setState] = React.useState({ selectedValue: 'b' });

const options = [
    { displayText: 'Option A', value: 'a' },
    { displayText: 'Option B', value: 'b' },
    { displayText: 'Option C', value: 'c' },
    { displayText: 'Option D', value: 'd' },
    { displayText: 'Option E', value: 'e' },
];

const handleChange = selectedOption => {
    setState(prevState => ({
        ...prevState,
        selectedValue: selectedOption.value,
    }));
};

<Label text="Single select field">
    <SingleSelectField
        error="oops"
        onChange={ handleChange }
        options={ options }
        selectedValue={ state.selectedValue }
    />
</Label>
```

Search Input

```
const [state, setState] = React.useState({ selectedValue: 'b' });

const options = [
    { displayText: 'Option A', value: 'a' },
    { displayText: 'Option B', value: 'b' },
    { displayText: 'Option C', value: 'c' },
    { displayText: 'Option D', value: 'd' },
    { displayText: 'Option E', value: 'e' },
];

const handleChange = selectedOption => {
    setState(prevState => ({
        ...prevState,
        selectedValue: selectedOption.value,
    }));
};

<Label text="Single select field">
    <SingleSelectField
        onChange={ handleChange }
        options={ options }
        selectedValue={ state.selectedValue }
        shouldShowSearchInput
    />
</Label>
```