@k8ordo/ui

Autocomplete

決まった候補から複数を選ぶ入力欄です。選んだものはタグで並び、1つずつ外せます。

インポート

ts
import { Autocomplete } from '@k8ordo/ui';

使い方

tsx
const [value, setValue] = useState<string[]>([]);

const options = [
  { label: 'Apple', value: 'apple' },
  { label: 'Banana', value: 'banana' },
  { label: 'Cherry', value: 'cherry' },
  { label: 'Grape', value: 'grape' },
  { label: 'Orange', value: 'orange' },
];

<Autocomplete
  id="autocomplete-basic"
  aria-describedby={undefined}
  disabled={false}
  invalid={false}
  required={false}
  onChange={setValue}
  options={options}
  value={value}
/>

必須

tsx
<Autocomplete
  id="autocomplete-required"
  aria-describedby={undefined}
  disabled={false}
  invalid={false}
  required
  onChange={setValue}
  options={options}
  value={value}
/>

複数選択

Apple
Cherry
tsx
const [value, setValue] = useState<string[]>(['apple', 'cherry']);

<Autocomplete
  id="autocomplete-multiple"
  aria-describedby={undefined}
  disabled={false}
  invalid={false}
  required={false}
  onChange={setValue}
  options={options}
  value={value}
/>

無効

Apple
tsx
<Autocomplete
  id="autocomplete-disabled"
  aria-describedby={undefined}
  disabled
  invalid={false}
  required={false}
  onChange={setValue}
  options={options}
  value={['apple']}
/>

エラー

tsx
<Autocomplete
  id="autocomplete-invalid"
  aria-describedby={undefined}
  disabled={false}
  invalid
  required={false}
  onChange={setValue}
  options={options}
  value={value}
/>

Props

id
Type: string
Default: -
options
Type: readonly Option[]
Default: -
defaultValue?
Type: string[]
Default: -
invalid?
Type: boolean
Default: false
onChange?
Type: (value: string[]) => void
Default: -
ref?
Type: Ref<HTMLInputElement>
Default: -
value?
Type: string[]
Default: -
PropTypeDefault
idstring-
optionsreadonly Option[]-
defaultValue?string[]-
invalid?booleanfalse
onChange?(value: string[]) => void-
ref?Ref<HTMLInputElement>-
value?string[]-

継承する属性(内部で固定するものを除く): InputHTMLAttributes<HTMLInputElement>

ラベルやプレースホルダーなど、このコンポーネントが描く文言は、propsで指定しないと文言辞書から読まれます。差し替え方は次を見てください: コンポーネントの文言

k8ordo

Baselineに入った機能を、制限なく使うReactのライブラリ群。