Select (Native)

A styled version of the browser's own select menu.

Usage

Code
import { NativeSelect } from '@leverui/components';
Code
<NativeSelect.Root>
  <NativeSelect.Field>
    <option value="1">Option 1</option>
    <option value="2">Option 2</option>
  </NativeSelect.Field>
  <NativeSelect.Indicator />
</NativeSelect.Root>

For one ready-made component, see the snippet below.

Examples

Sizes

Use the size prop to change the size of the select component.

Variants

Use the variant prop to change the appearance of the select component.

Controlled

Use the value and onChange props to control the select component.

Disabled

Pass the disabled prop to the NativeSelect.Root component to disable the select component.

Invalid

Compose the native and Field component to set the invalid set and show the error text.

Select an option to continue.

Alternatively, you can use the invalid prop on the NativeSelect.Root component as well.

Hook Form

Here is an example of how to use the NativeSelect component with Solid form state.

Ref

Code
import { NativeSelect } from '@leverui/components';

export function Demo() {
  let ref: HTMLSelectElement | undefined;

  return (
    <NativeSelect.Root>
      <NativeSelect.Field ref={ref}>
        <option value="1">Option 1</option>
        <option value="2">Option 2</option>
      </NativeSelect.Field>
      <NativeSelect.Indicator />
    </NativeSelect.Root>
  );
}

Closed Component

Code
import { For, omit } from 'solid-js';
import type { JSX } from '@solidjs/web';
import {
  NativeSelect as Select,
  type NativeSelectFieldProps,
  type NativeSelectRootProps,
} from '@leverui/components';

type FieldProp = 'name' | 'value' | 'onChange' | 'defaultValue';

type RootProps = Extract<NativeSelectRootProps, { as?: never; asChild?: never }>;
type FieldProps = Extract<NativeSelectFieldProps, { as?: never; asChild?: never }>;

export type NativeSelectProps = Omit<RootProps, FieldProp> &
  Pick<FieldProps, FieldProp> & {
    icon?: JSX.Element | undefined;
    ref?: ((element: HTMLSelectElement) => void) | undefined;
    items: readonly { label: string; value: string; disabled?: boolean | undefined }[];
  };

export function NativeSelect(props: NativeSelectProps) {
  const root = omit(
    props,
    'icon',
    'children',
    'name',
    'items',
    'value',
    'defaultValue',
    'onChange',
    'ref',
  );

  return (
    <Select.Root {...root}>
      <Select.Field
        ref={props.ref}
        name={props.name}
        value={props.value}
        defaultValue={props.defaultValue}
        onChange={props.onChange}
      >
        {props.children}
        <For each={props.items}>
          {(item) => (
            <option value={item.value} disabled={item.disabled}>
              {item.label}
            </option>
          )}
        </For>
      </Select.Field>
      <Select.Indicator>{props.icon}</Select.Indicator>
    </Select.Root>
  );
}

Props

Root

PropDefaultTypeDescription
variantoutline'outline' | 'subtle' | 'plain' | 'ghost'Select style.
sizemd'xs' | 'sm' | 'md' | 'lg' | 'xl'Select size.
disabled—boolean | undefinedDisable the select.
invalid—boolean | undefinedMark the select as invalid.
asdivNative tagHTML tag to render.
asChild—Solid render functionRender your own element with the root's props.
unstyled—booleanTurn off the component's styles.

NativeSelect.Field takes the standard select attributes, a ref, and an optional placeholder. The placeholder becomes the first option, with an empty value. size goes on the root only, not the field.

Pass children to NativeSelect.Indicator to replace the default chevron.

To control the selection, pass value from a Solid signal. For the starting selection only, pass defaultValue. A form reset goes back to it. For a multiple select, defaultValue takes an array of option values.

Inside a Field.Root, the field sets the disabled and invalid state and wins over the matching props on the root. It also supplies the label, the required state, and the text that describes the error. Without one, set disabled and invalid on NativeSelect.Root.

NativeSelect.PropsProvider sets default props for the roots inside it. The defaults can change over time. A prop on a root wins.

Customize with CSS

Import @leverui/components/styles.css once, then override the tokens or the part classes in your own stylesheet.

Code
.leverui-native-select__field {
  border-color: rebeccapurple;
}

Classes: .leverui-native-select__root, .leverui-native-select__field, and .leverui-native-select__indicator.

unstyled on the root or on a single part turns off its default styles. The native behavior, the classes, and the native select stay.

Inside an InputGroup, the group sets the padding of NativeSelect.Field to make room for the element before or after it, at every supported breakpoint.

Explorer

Click a part name in the sidebar to highlight it in the preview.

Component Anatomy

Hover to highlight, click to select parts