מתג
מתג הפעלה/כיבוי להגדרות מיידיות — התראות, מצב כהה, דגלי תכונות — עם עיצוב ניאו-ברוטליסטי המשלב מסגרות וצללים.
import { Label } from "@/components/ui/label"
import { Switch } from "@/components/ui/switch"
ה-switch הוא מתג דו-מצבי — on או off, מוחל ברגע שהוא מתהפך, בלי כפתור שליחה. נבנה על גבי רכיב Base UI Switch ומעוצב לפי המתכון הנאו-ברוטליסטי: מסגרות עבות, צללים חדים וטיפוגרפיה מודגשת.
השתמשו בו כש:
- פאנלי הגדרות — התראות, מצב כהה, autoplay: העדפות שנכנסות לתוקף מיד.
- דגלי תכונות — מפעילים תכונת beta או מחליפים בין חיוב חודשי לשנתי.
- בקרות לשורה — מפעילים או עוצרים פריטים בטבלה או ברשימה בלי לפתוח טופס.
התקנה#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/switch.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/switch.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/switch.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/switch.json
התקינו את התלויות הבאות:
pnpm add @base-ui/reactnpm install @base-ui/reactyarn add @base-ui/reactbun add @base-ui/react
העתיקו והדביקו את הקוד הבא לתוך הפרויקט שלכם.
"use client"
import * as React from "react"
import { Switch as SwitchPrimitive } from "radix-ui"
import { cn } from "@/lib/utils"
function Switch({
className,
size = "default",
...props
}: React.ComponentProps<typeof SwitchPrimitive.Root> & {
size?: "sm" | "default"
}) {
return (
<SwitchPrimitive.Root
data-slot="switch"
data-size={size}
className={cn(
"peer group/switch relative inline-flex shrink-0 cursor-pointer items-center border-2 border-foreground transition-all outline-none after:absolute after:-inset-x-3 after:-inset-y-2 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary aria-invalid:border-destructive data-[size=default]:h-6 data-[size=default]:w-11 data-[size=sm]:h-5 data-[size=sm]:w-9 data-checked:bg-primary data-disabled:cursor-not-allowed data-disabled:opacity-50",
className
)}
{...props}
>
<SwitchPrimitive.Thumb
data-slot="switch-thumb"
className="pointer-events-none mx-0.5 block border-2 border-foreground bg-primary transition-transform group-data-[size=default]/switch:size-4 group-data-[size=sm]/switch:size-3 group-data-[size=default]/switch:data-checked:translate-x-5 group-data-[size=sm]/switch:data-checked:translate-x-4 data-checked:bg-background data-unchecked:translate-x-0"
/>
</SwitchPrimitive.Root>
)
}
export { Switch }
עדכנו את נתיבי ה-import כך שיתאימו להגדרות הפרויקט שלכם.
שימוש#
import { Switch } from "@/components/ui/switch"<Switch />דוגמאות#
תיאור#
import {
Field,
FieldContent,כרטיס בחירה#
בחירה בסגנון כרטיס, שבה FieldLabel עוטף את כל ה-Field כדי ליצור תבנית של כרטיס לחיץ.
import {
Field,
FieldContent,מושבת#
הוסיפו את ה-prop disabled לרכיב Switch כדי להשבית את המתג. הוסיפו את ה-prop data-disabled לרכיב Field לצורך עיצוב.
import { Field, FieldLabel } from "@/components/ui/field"
import { Switch } from "@/components/ui/switch"
לא תקין#
הוסיפו את ה-prop aria-invalid לרכיב Switch כדי לציין מצב לא תקין. הוסיפו את ה-prop data-invalid לרכיב Field לצורך עיצוב.
import {
Field,
FieldContent,גודל#
השתמשו ב-prop size כדי לשנות את הגודל של המתג.
import { Field, FieldGroup, FieldLabel } from "@/components/ui/field"
import { Switch } from "@/components/ui/switch"
RTL#
כדי להפעיל RTL ב-Neobrutalism, עיינו במדריך ההגדרה של RTL.
"use client"
import * as React from "react"נגישות#
ה-switch עוקב אחרי דפוס Switch של WAI-ARIA: הוא מרנדר כפתור אמיתי עם role="switch" ו-aria-checked, ועוד input מוסתר כך שהערך נשלח עם טופס מסביב.
אינטראקציות מקלדת:
| מקש | פעולה |
|---|---|
Tab / Shift + Tab | מעבירים מוקד אל / מה-switch |
Space | מחליפים את ה-switch |
Enter | מחליפים את ה-switch |
תיעוד ה-API#
למידע נוסף, עיינו בתיעוד של Base UI.