전체 카탈로그
Data InputSelector19 props

Selector

A dropdown selector for choosing a single value from a list of options. Supports labels, validation, descriptions, and required/optional states. Use it in forms and settings whe...

공식 문서 열기
live previewData Input

Preview

Design
Engineering
Operations
Selection is valid

Import

import {Selector} from '@astryxdesign/core/Selector';

Astryx 문서 권장 방식대로 root barrel이 아니라 컴포넌트 subpath에서 가져옵니다.

When to use

A dropdown selector for choosing a single value from a list of options. Supports labels, validation, descriptions, and required/optional states. Use it in forms and settings whe...

selectorselectdropdowncomboboxpickerlistboxchooserautocomplete

Important props

sizesm | md | lgoptional
status{type: error | warning | success, message?: string}optional

Theming targets

astryx-selectorastryx-selector-option

Best practices

  • DoProvide a visible label so users understand what they are selecting.
  • DoUse sections and dividers to organize options when the list exceeds ~8 items.
  • DoUse renderOption for custom option rows. Do not pass SelectorOption directly as JSX children.
  • DoSet a meaningful placeholder that hints at the expected selection (e.g. "Choose a country" not "Select...").