Yerel seçim

import {
  NativeSelect,
  NativeSelectOption,

Native select, tarayıcının kendi <select> öğesinin üzerine eklenmiş ince bir stil katmanıdır — primitif yok, portal yok, JavaScript yok. Kapalı kontrol neobrütalist reçeteyi alır — kalın kenarlıklar, keskin gölgeler ve vurgulu tipografi — açılan liste ise işletim sisteminin kendi seçicisi olarak kalır.

Şu durumlarda tercih edin:

• Ülke, saat dilimi ve para birimi seçiciler — işletim sisteminin her türlü özel popover'dan daha hızlı işlediği uzun seçenek listeleri.
• Mobil ağırlıklı formlar — iOS ve Android kendi yerel seçici tekerleklerini devreye sokar; küçük ekranda bu, özel bir açılır menüden çok daha kullanışlıdır.
• Düz form gönderimleri — gerçek bir <select name="…"> olduğundan değer formla birlikte gönderilir ve hydration öncesinde de çalışır.

Kurulum#

pnpmnpmyarnbun
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
Kopyala

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 }

Kullanım#

Kopyalaimport {
  NativeSelect,
  NativeSelectOptGroup,
  NativeSelectOption,
} from "@/components/ui/native-select"

Kopyala<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>

Kompozisyon#

Basit#

Doğrudan NativeSelect altına yerleştirilen seçenekler (NativeSelectOptGroup olmadan).

KopyalaNativeSelect
├── NativeSelectOption
├── NativeSelectOption
├── NativeSelectOption
└── NativeSelectOption

Gruplarla#

Seçenekleri kategorilere ayırmak için NativeSelectOptGroup kullanın.

KopyalaNativeSelect
├── NativeSelectOptGroup
│   ├── NativeSelectOption
│   └── NativeSelectOption
└── NativeSelectOptGroup
    ├── NativeSelectOption
    └── NativeSelectOption

Örnekler#

Gruplar#

Seçenekleri kategorilere ayırmak için NativeSelectOptGroup kullanın.

import {
  NativeSelect,
  NativeSelectOptGroup,

Devre Dışı#

Select'i devre dışı bırakmak için NativeSelect bileşenine disabled prop'unu ekleyin.

import {
  NativeSelect,
  NativeSelectOption,

Geçersiz#

Doğrulama hatalarını göstermek için aria-invalid, biçimlendirme için ise Field bileşenine data-invalid özniteliğini kullanın.

import {
  NativeSelect,
  NativeSelectOption,

Native Select vs Select#

• Yerel tarayıcı davranışı, daha iyi performans veya mobil için optimize edilmiş açılır listeler için NativeSelect kullanın.
• Özel biçimlendirme, animasyonlar veya karmaşık etkileşimler için Select kullanın.

RTL#

Neobrutalism'de RTL desteğini etkinleştirmek için RTL yapılandırma kılavuzuna bakın.

"use client"

import * as React from "react"

Erişilebilirlik#

Bu, platformun kendi <select> öğesidir ve tarayıcılar onu yardımcı teknolojilere zaten açar — WAI-ARIA salt seçimli combobox deseninin taklit etmeye çalıştığı kontrol tam da budur. ARIA bağlantısı gerekmez; yalnızca <Label htmlFor> veya aria-label ile erişilebilir bir ad verin.

Klavye davranışını tarayıcı sağlar; bu nedenle tuş atamaları işletim sistemine ve tarayıcıya göre biraz değişebilir. Ortak küme:

API Referansı#

NativeSelect#

Yerel HTML select öğesini saran ana select bileşeni.

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

NativeSelectOption#

Select içindeki tek bir seçeneği temsil eder.

NativeSelectOptGroup#

Daha iyi bir düzen için ilgili seçenekleri bir arada gruplar.

Kopyala<NativeSelectOptGroup label="Fruits">
  <NativeSelectOption value="apple">Apple</NativeSelectOption>
  <NativeSelectOption value="banana">Banana</NativeSelectOption>
</NativeSelectOptGroup>