Select

Displays a list of options for the user to pick from—triggered by a button.

Anatomy

<Select.Root>
  <Select.Trigger>
    <Select.Value />
  </Select.Trigger>
  <Select.Content>
    <Select.Item value="value">
      Label
    </Select.Item>
  </Select.Content>
</Select.Root>

Usage

import { Select } from '@ivaldi/ui'
<Select.Root>
  <Select.Trigger>
    <Select.Value placeholder="Select an option" />
  </Select.Trigger>
  <Select.Content>
    <Select.Item value="1">Option 1</Select.Item>
    <Select.Item value="2">Option 2</Select.Item>
    <Select.Item value="3">Option 3</Select.Item>
  </Select.Content>
</Select.Root>

Select.Composed Props

A complete select component that combines all select primitives into a cohesive component.

PropTypeDefault

Select.Root Props

PropTypeDefault
childrenReactNode—
openboolean—
defaultOpenboolean—
onOpenChangefunction—
direnum—
namestring—
autoCompletestring—
disabledboolean—
requiredboolean—
formstring—
valuestring—
defaultValuestring—
onValueChangefunction—

Select.Button Props

A button component specifically designed for use as a select trigger.

PropTypeDefault

Select.Content Props

A component that renders the content of a select dropdown.

PropTypeDefault
onCloseAutoFocusfunction—
onEscapeKeyDownfunction—
onPointerDownOutsidefunction—
positionenum—
classNamestring—
childrenReactNode—
asChildboolean—
sideenum—
sideOffsetnumber"4"
alignenum—
alignOffsetnumber—
arrowPaddingnumber—
avoidCollisionsboolean—
collisionBoundaryElement | Element[]—
collisionPaddingsee more—
stickyenum—
hideWhenDetachedboolean—
updatePositionStrategyenum—
panelPropsany"{}"

Select.Group Props

PropTypeDefault
classNamestring—
childrenReactNode—
asChildboolean—

Select.Item Props

A component that renders a selectable item within a select dropdown.

PropTypeDefault

Select.Label Props

A component that renders a label within a select dropdown.

PropTypeDefault

Select.Separator Props

A component that renders a separator line between select items.

PropTypeDefault

Select.Trigger Props

PropTypeDefault
typeenum—
classNamestring—
childrenReactNode—
asChildboolean—

Select.Value Props

PropTypeDefault
placeholderReactNode—
classNamestring—
childrenReactNode—
asChildboolean—