דילוג לתוכן
1.6k

בחירה מקורית

רכיב ה-select המובנה ב-HTML שעבר עיצוב מחדש עבור טפסים, מסננים ובוחרי מדינות — תפריט נפתח המוצג על ידי מערכת ההפעלה, עם מסגרות וצללים בסגנון ניאו-ברוטליסטי.

import {
  NativeSelect,
  NativeSelectOption,

ה-native select הוא שכבת עיצוב דקה מעל אלמנט ה-<select> של הדפדפן — בלי פרימיטיב, בלי portal, בלי JavaScript. הבקרה הסגורה מקבלת את המתכון הנאו-ברוטליסטי — מסגרות עבות, צללים חדים וטיפוגרפיה מודגשת — בעוד הרשימה הפתוחה נשארת בוחר ה-OS.

השתמשו בו כש:

  • בוחרי מדינה, אזור זמן ומטבע — רשימות אפשרויות ארוכות שה-OS מרנדר מהר יותר מכל popover מותאם.
  • טפסים כבדי-מובייל — iOS ו-Android מחליפים לגלגל בוחר מקורי, שעדיף על dropdown מותאם במסך קטן.
  • שליחות טופס רגילות — זה <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,

מושבת

הוסיפו את המאפיין disabled לרכיב NativeSelect כדי להשבית את ה-select.

import {
  NativeSelect,
  NativeSelectOption,

לא תקין

השתמשו ב-aria-invalid כדי להציג שגיאות אימות, וב-attribute data-invalid על רכיב Field לצורך העיצוב.

import {
  NativeSelect,
  NativeSelectOption,

Native Select vs Select

  • השתמשו ב-NativeSelect עבור התנהגות נייטיב של הדפדפן, ביצועים טובים יותר או רשימות נפתחות המותאמות למובייל.
  • השתמשו ב-Select עבור עיצוב מותאם אישית, אנימציות או אינטראקציות מורכבות.

RTL

כדי להפעיל RTL ב-Neobrutalism, עיינו במדריך ההגדרה של RTL.

"use client"

import * as React from "react"

נגישות

זה ה-<select> של הפלטפורמה עצמה, שדפדפנים כבר חושפים לטכנולוגיה מסייעת — זו הבקרה שדפוס combobox select-only של WAI-ARIA קיים כדי לחקות. אין צורך בחיווט ARIA; רק תנו לו שם נגיש דרך <Label htmlFor> או aria-label.

התנהגות מקלדת מסופקת על ידי הדפדפן, כך שהקישורים משתנים מעט בין OS לדפדפן. הסט הנפוץ:

מקשפעולה
Space / Alt + ArrowDownפותחים את רשימת האפשרויות
ArrowDown / ArrowUpמדגישים את האפשרות הבאה / הקודמת
Home / Endקופצים לאפשרות הראשונה / האחרונה
Enterמאשרים את האפשרות המודגשת וסוגרים את הרשימה
Escapeסוגרים את הרשימה בלי לשנות את הערך
תווים ניתנים להדפסהTypeahead — קופצים לאפשרות הבאה שתואמת למה שמקלידים

תיעוד ה-API

NativeSelect

רכיב ה-select הראשי, העוטף את אלמנט ה-select הנייטיב של HTML.

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