सामग्री पर जाएँ

नेटिव सेलेक्ट

फॉर्म, फ़िल्टर और देश चयनकर्ताओं के लिए मूल HTML चयन को नया रूप दिया गया — OS-रेंडर किए गए ड्रॉपडाउन के साथ नियोब्रूटलिस्ट बॉर्डर और शैडोज़।

import {
  NativeSelect,
  NativeSelectOption,

नेटिव सेलेक्ट ब्राउज़र के अपने <select> एलिमेंट पर पतली स्टाइल परत है — कोई प्रिमिटिव नहीं, कोई portal नहीं, कोई JavaScript नहीं। बंद कंट्रोल को नियोब्रूटलिस्ट रेसिपी मिलती है — मोटे बॉर्डर, कठोर छायाएँ, बोल्ड टाइप — जबकि खुली सूची OS पिकर ही रहती है।

इसे इन स्थितियों में चुनें:

  • देश, टाइमज़ोन और करेंसी पिकर — लंबी विकल्प सूची जिन्हें OS किसी कस्टम पॉपओवर से तेज़ रेंडर करता है।
  • मोबाइल-भारी फ़ॉर्म — iOS और Android अपना नेटिव पिकर व्हील लगाते हैं, छोटी स्क्रीन पर कस्टम ड्रॉपडाउन से बेहतर।
  • सादे फ़ॉर्म पोस्ट — यह असली <select name="…"> है, वैल्यू फ़ॉर्म के साथ सबमिट होती है और hydration से पहले काम करती है।

इंस्टॉलेशन

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

निम्नलिखित कोड को अपने प्रोजेक्ट में कॉपी और पेस्ट करें.

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 }

अपने प्रोजेक्ट सेटअप के अनुसार इंपोर्ट पाथ अपडेट करें.

उपयोग

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>

कंपोज़िशन

सरल

NativeSelect के सीधे अंदर रखे गए विकल्प (बिना NativeSelectOptGroup के).

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

समूहों के साथ

विकल्पों को श्रेणियों में व्यवस्थित करने के लिए NativeSelectOptGroup का उपयोग करें.

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

उदाहरण

समूह

विकल्पों को श्रेणियों में व्यवस्थित करने के लिए NativeSelectOptGroup का उपयोग करें.

import {
  NativeSelect,
  NativeSelectOptGroup,

अक्षम

select को अक्षम करने के लिए NativeSelect कंपोनेंट में disabled prop जोड़ें.

import {
  NativeSelect,
  NativeSelectOption,

अमान्य

वैलिडेशन एरर दिखाने के लिए aria-invalid का उपयोग करें और स्टाइलिंग के लिए Field कंपोनेंट में data-invalid एट्रिब्यूट का उपयोग करें.

import {
  NativeSelect,
  NativeSelectOption,

Native Select vs Select

  • नेटिव ब्राउज़र व्यवहार, बेहतर परफ़ॉर्मेंस या मोबाइल-अनुकूलित ड्रॉपडाउन के लिए NativeSelect का उपयोग करें.
  • कस्टम स्टाइलिंग, एनिमेशन या जटिल इंटरैक्शन के लिए Select का उपयोग करें.

RTL

Neobrutalism में RTL समर्थन सक्षम करने के लिए, RTL कॉन्फ़िगरेशन गाइड देखें.

"use client"

import * as React from "react"

एक्सेसिबिलिटी

यह प्लेटफ़ॉर्म का अपना <select> है, जिसे ब्राउज़र पहले से असिस्टिव टेक्नोलॉजी के सामने रखते हैं — यही कंट्रोल WAI-ARIA select-only combobox पैटर्न नक़ल करने के लिए बना है। कोई ARIA वायरिंग नहीं; बस <Label htmlFor> या aria-label से accessible name दें।

कीबोर्ड व्यवहार ब्राउज़र देता है, इसलिए OS और ब्राउज़र पर बाइंडिंग थोड़ी भिन्न हो सकती है। आम सेट:

कीबोर्ड इंटरैक्शन:

कुंजीक्रिया
Space / Alt + ArrowDownविकल्प सूची खोलें
ArrowDown / ArrowUpअगला / पिछला विकल्प हाइलाइट करें
Home / Endपहले / आख़िरी विकल्प पर जाएँ
Enterहाइलाइट विकल्प कमिट करें और सूची बंद करें
Escapeवैल्यू बदले बिना सूची बंद करें
प्रिंट करने योग्य वर्णtypeahead — टाइप से मिलते अगले विकल्प पर जाएँ

API रेफ़रेंस

NativeSelect

मुख्य select कंपोनेंट, जो नेटिव HTML select एलिमेंट को लपेटता है.

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

NativeSelectOption

select के भीतर एक व्यक्तिगत विकल्प को दर्शाता है.

PropTypeDefault
valuestring
disabledbooleanfalse

NativeSelectOptGroup

बेहतर व्यवस्था के लिए संबंधित विकल्पों को एक साथ समूहित करता है.

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