ข้ามไปเนื้อหา
WhereUI

ค้นหาในเอกสาร

ค้นหาชื่อ component หรือหน้าเอกสาร

Toggle

จาก shadcn

ปุ่มสลับสถานะเดี่ยวที่ค้างสถานะกดไว้ เช่น ปักหมุดรายการหรือเปิดโหมดดูร่าง เป็นส่วนเดียวกับ ToggleGroup แต่ใช้เดี่ยว ๆ

สถานะปัจจุบัน: เรียงตามวันที่ปกติ

ติดตั้ง

Terminal
pnpm dlx shadcn@latest add @whereui/toggle

ต้องผูก registry และติดตั้ง @whereui/theme นำหน้าเสมอเมื่อติดตั้งครั้งแรก

การใช้งาน

import * as React from "react"import { Toggle } from "@/components/ui/toggle"const [pinned, setPinned] = React.useState(false)<Toggle pressed={pinned} onPressedChange={setPinned} aria-label="ปักหมุด">  ปักหมุด</Toggle>

ตัวอย่างเพิ่มเติม

ขนาดและสถานะ

ข้อควรรู้

  • variant มี default (พื้นโปร่ง) และ outline (มีขอบ) ส่วนขนาดมี sm, default, lg
  • กดค้างสถานะไว้ด้วย pressed/onPressedChange หรือปล่อยเป็น uncontrolled ก็ได้
  • ควรใส่ aria-label เมื่อปุ่มมีแต่ไอคอน

ซอร์สโค้ด

components/ui/toggle.tsx
"use client"import { Toggle as TogglePrimitive } from "@base-ui/react/toggle"import { cva, type VariantProps } from "class-variance-authority"import { cn } from "cn"const toggleVariants = cva(  "group/toggle inline-flex items-center justify-center gap-1 rounded-lg text-sm font-medium whitespace-nowrap transition-all outline-none hover:bg-muted hover:text-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 aria-pressed:bg-muted data-[state=on]:bg-muted dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",  {    variants: {      variant: {        default: "bg-transparent",        outline: "border border-input bg-transparent hover:bg-muted",      },      size: {        default:          "h-8 min-w-8 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",        sm: "h-7 min-w-7 rounded-[min(var(--radius-md),12px)] px-2.5 text-[0.8rem] has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3.5",        lg: "h-9 min-w-9 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",      },    },    defaultVariants: {      variant: "default",      size: "default",    },  })function Toggle({  className,  variant = "default",  size = "default",  ...props}: TogglePrimitive.Props & VariantProps<typeof toggleVariants>) {  return (    <TogglePrimitive      data-slot="toggle"      className={cn(toggleVariants({ variant, size, className }))}      {...props}    />  )}export { Toggle, toggleVariants }