import { Badge } from 'terra-form-select/package.json?dev-site-package';

import SingleSelectFieldExample from './example/single/SingleSelectField?dev-site-example';
import InlineLabelFieldExample from './example/single/InlineLabelField?dev-site-example';
import RequiredSingleSelectFieldExample from './example/single/RequiredSingleSelectField?dev-site-example';
import IncompleteSingleSelectFieldExample from './example/single/IncompleteSingleSelectField?dev-site-example';

import SingleSelectFieldPropsTable from 'terra-form-select/lib/SingleSelectField?dev-site-props-table';

<Badge />

# Terra Form Single Select Field

A convenience wrapper assembling a [terra-form-select SingleSelect](https://github.com/cerner/terra-core/tree/main/packages/terra-form-select/src/SingleSelect.jsx) within a [terra-form-field](https://github.com/cerner/terra-core/tree/main/packages/terra-form-field).

To close the combobox while using JAWS with VPC **ON** mode, user have to press escape key twice. The first escape key press loses the VPC focus and the second escape key press closes the single select as it has control focus.

## Getting Started

- Install with [npmjs](https://www.npmjs.com):
  - `npm install terra-form-select`

## Usage

```jsx
import { SingleSelectField } from 'terra-form-select';
```

## Component Features

- [Cross-Browser Support](https://engineering.cerner.com/terra-ui/about/terra-ui/component-standards#cross-browser-support)
- [Responsive Support](https://engineering.cerner.com/terra-ui/about/terra-ui/component-standards#responsive-support)
- [Mobile Support](https://engineering.cerner.com/terra-ui/about/terra-ui/component-standards#mobile-support)
- [Internationalization Support](https://engineering.cerner.com/terra-ui/about/terra-ui/component-standards#internationalization-i18n)
- [Localization Support](https://engineering.cerner.com/terra-ui/about/terra-ui/component-standards#internationalization-i18n)
- [LTR/RTL Support](https://engineering.cerner.com/terra-ui/about/terra-ui/component-standards#ltr--rtl)

## Examples
<SingleSelectFieldExample title="Single Select Field Example" />
<RequiredSingleSelectFieldExample title="Required Single Select Field Example" />
<IncompleteSingleSelectFieldExample title="Incomplete Single Select Field Example" description="Applies theme-specific styling for incomplete. ***Note: Only use incomplete if given specific guidance, reserved for specific applications when no value has been provided. Not for general use.***" />
<InlineLabelFieldExample title="Single Select Field with Inline Label" />

## Single Select Field Props
<SingleSelectFieldPropsTable />