devsnips
Search docs, APIs, guides…

Component

Native Select

Genuine native select element styled to match the DevSnips select language.

  • Component
  • React
  • TSX
  • Tailwind CSS
  • MIT

What it does

Capabilities

  • Semantic HTML
  • ARIA
  • Associated labels

Preview

Live component

Interactive preview
Open preview
9:41 100%
devsnips.site/library/react/components/selects/native-select/
fluid · no fixed width 100%
No dependencies Responsive · Light/dark · Focus-visible

Install

Add to your project

terminal
npx devsnips add React/Components/Selects/native-select
registry path: React/Components/Selects/native-select

Source

Implementation

code.tsx 
import type { ChangeEvent, ReactNode } from "react";
import { useId, useState } from "react";

export type SelectSize = "sm" | "md" | "lg";

export interface SelectOption {
  value: string;
  label: string;
  disabled?: boolean;
}

export interface NativeSelectProps {
  label?: string;
  helperText?: string;
  error?: string;
  success?: string;
  options: SelectOption[];
  value?: string;
  defaultValue?: string;
  onChange?: (value: string, option: SelectOption) => void;
  size?: SelectSize;
  placeholder?: string;
  disabled?: boolean;
  leadingIcon?: ReactNode;
  id?: string;
  className?: string;
  name?: string;
}

function cx(...parts: Array<string | false | null | undefined>): string {
  return parts.filter(Boolean).join(" ");
}

const SIZES: Record<SelectSize, string> = {
  sm: "h-8 text-[13px] [&_svg]:size-[14px]",
  md: "h-9 text-sm [&_svg]:size-4",
  lg: "h-11 text-sm [&_svg]:size-[18px]",
};

function ChevronDown({ className }: { className?: string }) {
  return (
    <svg className={className} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth={1.75} strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
      <path d="m6 9 6 6 6-6" />
    </svg>
  );
}

/**
 * Native HTML <select> styled to match the custom select visual language.
 * Uses the real native control (full keyboard support, native OS menu,
 * native form participation via `name`) but visually consistent with the
 * custom listbox select: same height/border/radius/tokens, a hidden native
 * arrow via `appearance-none`, and an absolutely-positioned chevron SVG
 * overlay that mirrors the custom variant. Controlled (value/onChange) and
 * uncontrolled (defaultValue) modes both supported; onChange receives the
 * chosen value plus the matching option object. A `placeholder` is
 * rendered as a disabled first <option> when nothing is selected.
 */
export function NativeSelect({
  label = "Select",
  helperText,
  error,
  success,
  options,
  value,
  defaultValue = "",
  onChange,
  size = "md",
  placeholder = "Select an option",
  disabled,
  leadingIcon,
  id,
  className,
  name,
}: NativeSelectProps) {
  const generatedId = useId();
  const selectId = id ?? `native-select-${generatedId}`;
  const messageId = `${selectId}-message`;
  const message = error ?? success ?? helperText;

  const [internalValue, setInternalValue] = useState(defaultValue);
  const selectedValue = value ?? internalValue;
  const selected = options.find((o) => o.value === selectedValue) ?? null;

  function handleChange(event: ChangeEvent<HTMLSelectElement>) {
    const next = event.target.value;
    const option = options.find((o) => o.value === next) ?? { value: next, label: next };
    if (value === undefined) setInternalValue(next);
    onChange?.(next, option);
  }

  return (
    <div className="w-full">
      <label
        htmlFor={selectId}
        className={cx(
          "mb-2 block text-[13px] font-medium leading-5 text-[var(--ds-color-foreground)]",
          disabled && "text-[var(--ds-color-muted-foreground)]",
        )}
      >
        {label}
      </label>
      {message ? (
        <p
          id={messageId}
          className={cx(
            "mb-2 text-xs",
            error ? "text-[var(--ds-color-destructive)]" : success ? "text-[var(--ds-color-success)]" : "text-[var(--ds-color-muted-foreground)]",
          )}
        >
          {error ? `Error: ${error}` : success ? `Success: ${success}` : helperText}
        </p>
      ) : null}
      <div className="relative">
        {leadingIcon ? (
          <span className="pointer-events-none absolute left-3 z-10 text-[var(--ds-color-muted-foreground)]">{leadingIcon}</span>
        ) : null}
        <select
          id={selectId}
          name={name}
          value={selectedValue}
          defaultValue={value === undefined ? defaultValue : undefined}
          onChange={handleChange}
          disabled={disabled}
          aria-invalid={error ? true : undefined}
          aria-describedby={message ? messageId : undefined}
          className={cx(
            "w-full appearance-none rounded-[var(--ds-radius-sm)] border bg-[var(--ds-color-input)] pr-9 text-[var(--ds-color-foreground)] transition-colors duration-150 ease-out hover:bg-[var(--ds-color-input-hover,var(--ds-color-input))] focus:bg-[var(--ds-color-input-focus,var(--ds-color-input))] focus:border-[var(--ds-color-border-strong)] focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-[var(--ds-color-focus-ring)] disabled:pointer-events-none disabled:bg-[var(--ds-color-muted)] disabled:text-[var(--ds-color-muted-foreground)] disabled:opacity-60 motion-reduce:transition-none",
            error ? "border-[var(--ds-color-destructive)]" : success ? "border-[var(--ds-color-success)]" : "border-[var(--ds-color-border)]",
            SIZES[size],
            leadingIcon ? "pl-9" : "pl-3",
            className,
          )}
        >
          {!selected ? (
            <option value="" disabled>
              {placeholder}
            </option>
          ) : null}
          {options.map((option) => (
            <option key={option.value} value={option.value} disabled={option.disabled}>
              {option.label}
            </option>
          ))}
        </select>
        <ChevronDown
          className={cx(
            "pointer-events-none absolute right-3 top-1/2 -translate-y-1/2 shrink-0 text-[var(--ds-color-muted-foreground)] transition-transform duration-150 motion-reduce:transition-none",
            disabled && "opacity-60",
          )}
        />
      </div>
    </div>
  );
}

export default NativeSelect;
157 lines UTF-8 · LF · Spaces: 2
DevSnips AI ready Claude · Cursor · Windsurf

Agent skill & Model Context Protocol

Pass this component straight into your AI workflow. DevSnips exposes each resource as a structured, addressable registry entry, so your agent installs the real files instead of approximating them.

devsnips://components/selects/native-select
Prompt instruction 
I want to use this DevSnips resource in production:

Page:
https://devsnips.site/library/react/components/selects/native-select/

Install: npx devsnips add
React/Components/Selects/native-select

This is the Native Select — Genuine native select element styled to match the DevSnips select language.

Use this DevSnips resource as the starting point for my project.
Adapt it to my project's stack and conventions, fix any issues,
and make it production-ready while preserving its intended design
and behavior.

Paste into ChatGPT, Claude or your agent — it already carries the page URL and the exact install path.

Resource URI
devsnips://components/selects/native-select