ComboboxSeparator

Deprecated: Use ComboboxGroup with CSS borders instead.

Renders a divider between ComboboxItem elements.

Code examples

<ComboboxProvider>
  <Combobox />
  <ComboboxPopover>
    <ComboboxItem value="Item 1" />
    <ComboboxSeparator />
    <ComboboxItem value="Item 2" />
    <ComboboxItem value="Item 3" />
  </ComboboxPopover>
</ComboboxProvider>
<ComboboxProvider>
  <Combobox />
  <ComboboxPopover>
    <ComboboxItem value="Item 1" />
    <ComboboxSeparator />
    <ComboboxItem value="Item 2" />
    <ComboboxItem value="Item 3" />
  </ComboboxPopover>
</ComboboxProvider>

Optional Props

`orientation`

"horizontal" | "vertical" | undefined
"horizontal" | "vertical" | undefined

The orientation of the separator. By default, this is the opposite of the orientation state of the composite widget. Which means it doesn't need to be explicitly set in most cases.

`render`

RenderProp<React.HTMLAttributes<any> & { ref?: React.Ref<any> | undefined; }> | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | undefined
RenderProp<React.HTMLAttributes<any> & { ref?: React.Ref<any> | undefined; }> | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | undefined

Allows the component to be rendered as a different HTML element or React component. The value can be a React element or a function that takes in the original component props and gives back a React element with the props merged.

Some Ariakit components detect the type of the underlying element when they mount. If the render element's type may change while the component is mounted, pass a key⁠ prop that changes with the element type so React remounts the component with the new element. Remounting resets uncontrolled state, so keep the relevant state controlled:

<Checkbox
  key={custom ? "custom" : "native"}
  checked={checked}
  onChange={() => setChecked(!checked)}
  render={custom ? <div /> : <input />}
/>
<Checkbox
  key={custom ? "custom" : "native"}
  checked={checked}
  onChange={() => setChecked(!checked)}
  render={custom ? <div /> : <input />}
/>

Check out the Composition guide for more details.

`store`

ComboboxStore<ComboboxStoreSelectedValue> | undefined
ComboboxStore<ComboboxStoreSelectedValue> | undefined

Object returned by the useComboboxStore hook. If not provided, the closest ComboboxList or ComboboxPopover components' context will be used.

ComboboxSeparator

Code examples

Optional Props

orientation

render

store

Stay tuned

`orientation`

`render`

`store`