Saltar al contenido

Selector nativo

El selector HTML nativo rediseñado para formularios, filtros y selectores de países: un menú desplegable renderizado por el sistema operativo con bordes y sombras de estilo neobrutalista.

import {
  NativeSelect,
  NativeSelectOption,

El select nativo es una capa fina de estilos sobre el propio elemento <select> del navegador: sin primitiva, sin portal, sin JavaScript. El control cerrado recibe la receta neobrutalista —bordes gruesos, sombras marcadas y tipografía en negrita—, mientras que la lista abierta sigue siendo el selector del sistema operativo.

Recurre a este componente cuando:

  • Selectores de país, zona horaria y moneda — listas largas de opciones que el sistema operativo renderiza más rápido que cualquier popover a medida.
  • Formularios con mucho tráfico móvil — iOS y Android muestran su rueda de selección nativa, que en una pantalla pequeña gana a cualquier desplegable a medida.
  • Envíos de formulario clásicos — es un <select name="…"> real, así que el valor se envía con el formulario y funciona antes de la hidratación.

Instalación

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/native-select.json
npx shadcn@latest add https://neobrutalism.com/r/base/native-select.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/native-select.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/native-select.json

Copia y pega el siguiente código en tu proyecto.

components/ui/native-select.tsx
import * as React from "react"
import { ChevronDownIcon } from "lucide-react"

import { cn } from "@/lib/utils"

type NativeSelectProps = Omit<React.ComponentProps<"select">, "size"> & {
  size?: "sm" | "default"
}

function NativeSelect({
  className,
  size = "default",
  ...props
}: NativeSelectProps) {
  return (
    <div
      className={cn(
        "group/native-select relative w-fit has-[select:disabled]:opacity-50",
        className
      )}
      data-slot="native-select-wrapper"
      data-size={size}
    >
      <select
        data-slot="native-select"
        data-size={size}
        className="h-8 w-full min-w-0 appearance-none rounded border-2 bg-input py-2 pr-8 pl-3 text-sm shadow-sm transition-colors outline-none select-none selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:cursor-not-allowed aria-invalid:border-destructive data-[size=sm]:h-7 data-[size=sm]:rounded data-[size=sm]:py-0.5"
        {...props}
      />
      <ChevronDownIcon
        className="pointer-events-none absolute top-1/2 right-2.5 size-4 -translate-y-1/2 text-muted-foreground select-none"
        aria-hidden="true"
        data-slot="native-select-icon"
      />
    </div>
  )
}

function NativeSelectOption({
  className,
  ...props
}: React.ComponentProps<"option">) {
  return (
    <option
      data-slot="native-select-option"
      className={cn("bg-[Canvas] text-[CanvasText]", className)}
      {...props}
    />
  )
}

function NativeSelectOptGroup({
  className,
  ...props
}: React.ComponentProps<"optgroup">) {
  return (
    <optgroup
      data-slot="native-select-optgroup"
      className={cn("bg-[Canvas] text-[CanvasText]", className)}
      {...props}
    />
  )
}

export { NativeSelect, NativeSelectOptGroup, NativeSelectOption }

Actualiza las rutas de importación según la configuración de tu proyecto.

Uso

import {
  NativeSelect,
  NativeSelectOptGroup,
  NativeSelectOption,
} from "@/components/ui/native-select"
<NativeSelect>
  <NativeSelectOption value="">Select a fruit</NativeSelectOption>
  <NativeSelectOption value="apple">Apple</NativeSelectOption>
  <NativeSelectOption value="banana">Banana</NativeSelectOption>
  <NativeSelectOption value="blueberry">Blueberry</NativeSelectOption>
  <NativeSelectOption value="pineapple">Pineapple</NativeSelectOption>
</NativeSelect>

Composición

Simple

Opciones colocadas directamente dentro de NativeSelect (sin NativeSelectOptGroup).

NativeSelect
├── NativeSelectOption
├── NativeSelectOption
├── NativeSelectOption
└── NativeSelectOption

Con grupos

Usa NativeSelectOptGroup para organizar las opciones en categorías.

NativeSelect
├── NativeSelectOptGroup
│   ├── NativeSelectOption
│   └── NativeSelectOption
└── NativeSelectOptGroup
    ├── NativeSelectOption
    └── NativeSelectOption

Ejemplos

Grupos

Usa NativeSelectOptGroup para organizar las opciones en categorías.

import {
  NativeSelect,
  NativeSelectOptGroup,

Deshabilitado

Añade la prop disabled al componente NativeSelect para deshabilitar el select.

import {
  NativeSelect,
  NativeSelectOption,

No válido

Usa aria-invalid para mostrar los errores de validación y el atributo data-invalid en el componente Field para aplicar estilos.

import {
  NativeSelect,
  NativeSelectOption,

Native Select vs Select

  • Usa NativeSelect para un comportamiento nativo del navegador, un mejor rendimiento o listas desplegables optimizadas para móvil.
  • Usa Select para estilos personalizados, animaciones o interacciones complejas.

RTL

Para activar el soporte RTL en Neobrutalism, consulta la guía de configuración de RTL.

"use client"

import * as React from "react"

Accesibilidad

Este es el <select> propio de la plataforma, que los navegadores ya exponen a la tecnología de asistencia: es el control que el patrón de combobox de solo selección de WAI-ARIA existe para emular. No hace falta configuración ARIA; solo dale un nombre accesible mediante <Label htmlFor> o aria-label.

El comportamiento de teclado lo aporta el navegador, así que las combinaciones varían ligeramente según el sistema y el navegador. El conjunto común:

TeclaAcción
Space / Alt + ArrowDownAbre la lista de opciones
ArrowDown / ArrowUpResalta la opción siguiente / anterior
Home / EndSalta a la primera / última opción
EnterConfirma la opción resaltada y cierra la lista
EscapeCierra la lista sin cambiar el valor
Caracteres imprimiblesTypeahead: salta a la siguiente opción que coincide con lo que escribes

Referencia de API

NativeSelect

El componente select principal, que envuelve el elemento select nativo de HTML.

<NativeSelect>
  <NativeSelectOption value="option1">Option 1</NativeSelectOption>
  <NativeSelectOption value="option2">Option 2</NativeSelectOption>
</NativeSelect>

NativeSelectOption

Representa una opción individual dentro del select.

PropTypeDefault
valuestring
disabledbooleanfalse

NativeSelectOptGroup

Agrupa opciones relacionadas para una mejor organización.

PropTypeDefault
labelstring
disabledbooleanfalse
<NativeSelectOptGroup label="Fruits">
  <NativeSelectOption value="apple">Apple</NativeSelectOption>
  <NativeSelectOption value="banana">Banana</NativeSelectOption>
</NativeSelectOptGroup>