כפתור

כפתור לחיצה לשליחת טפסים, סרגלי כלים ואישורי ביטול — עם מסגרות עבות וצל שהוא יוצר בעת הלחיצה.

import { ArrowUpIcon } from "lucide-react"

import { Button } from "@/components/ui/button"

ה-button מפעיל פעולה — שליחה, אישור, מחיקה. נבנה על גבי רכיב Base UI Button ומעוצב לפי המתכון הנאו-ברוטליסטי: מסגרות עבות, צל היסט חד, ולחיצה פעילה שדוחפת את הכפתור אל תוך הצל.

השתמשו בו כש:

שליחת טפסים ו-CTA ראשי — default נושא את הפעולה המרכזית; secondary ו-outline לכל מה שלידה.
סרגלי כלים ופעולות אייקון — גודלי icon יוצרים כפתורים מרובעים; ButtonGroup מסדר אותם לשורות מקטעות.
אישורי פעולות הרסניות — destructive למחיקה והסרה, בדרך כלל מאחורי dialog.

התקנה


pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/button.json
npx shadcn@latest add https://neobrutalism.com/r/base/button.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/button.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/button.json

התקינו את התלויות הבאות:


pnpm add @base-ui/react
npm install @base-ui/react
yarn add @base-ui/react
bun add @base-ui/react

העתיקו והדביקו את הקוד הבא לתוך הפרויקט שלכם.

components/ui/button.tsx

import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { Slot } from "radix-ui"

import { cn } from "@/lib/utils"

const buttonVariants = cva(
  cn(
    "group/button font-head font-medium inline-flex cursor-pointer items-center justify-center gap-2 rounded whitespace-nowrap select-none transition-all duration-200",
    "disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-60",
    "focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary aria-invalid:border-destructive",
    // Icons keep their own size; we only set a default when none is given so
    // Neobrutalism's h-4/size-4 icons aren't overridden.
    "[&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4"
  ),
  {
    variants: {
      variant: {
        default:
          "border-2 border-black bg-primary text-primary-foreground shadow-md transition duration-200 hover:-translate-x-0.5 hover:-translate-y-0.5 hover:bg-primary-hover hover:shadow-lg active:translate-x-1 active:translate-y-1 active:shadow-none",
        secondary:
          "border-2 border-black bg-secondary text-secondary-foreground shadow-md transition duration-200 hover:-translate-x-0.5 hover:-translate-y-0.5 hover:bg-secondary-hover hover:shadow-lg active:translate-x-1 active:translate-y-1 active:shadow-none",
        destructive:
          "border-2 border-black bg-destructive text-destructive-foreground shadow-md transition duration-200 hover:-translate-x-0.5 hover:-translate-y-0.5 hover:bg-destructive/90 hover:shadow-lg active:translate-x-1 active:translate-y-1 active:shadow-none",
        outline:
          "border-2 bg-transparent shadow-md transition duration-200 hover:-translate-x-0.5 hover:-translate-y-0.5 hover:shadow-lg active:translate-x-1 active:translate-y-1 active:shadow-none",
        ghost: "bg-transparent hover:bg-accent",
        link: "bg-transparent hover:underline",
      },
      size: {
        default: "px-4 py-1.5 text-base",
        xs: "px-2 py-0.5 text-xs",
        sm: "px-3 py-1 text-sm",
        lg: "px-6 py-2 text-base lg:px-8 lg:py-3 lg:text-lg",
        icon: "p-2",
        "icon-xs": "p-1",
        "icon-sm": "p-1.5",
        "icon-lg": "p-3",
      },
    },
    defaultVariants: {
      variant: "default",
      size: "default",
    },
  }
)

function Button({
  className,
  variant = "default",
  size = "default",
  asChild = false,
  ...props
}: React.ComponentProps<"button"> &
  VariantProps<typeof buttonVariants> & {
    asChild?: boolean
  }) {
  const Comp = asChild ? Slot.Root : "button"

  return (
    <Comp
      data-slot="button"
      data-variant={variant}
      data-size={size}
      className={cn(buttonVariants({ variant, size, className }))}
      {...props}
    />
  )
}

export { Button, buttonVariants }

עדכנו את נתיבי הייבוא כך שיתאימו למבנה הפרויקט שלכם.

שימוש

import { Button } from "@/components/ui/button"

<Button variant="outline">Button</Button>

סמן

Tailwind v4 עבר מ-cursor: pointer ל-cursor: default עבור רכיב הכפתור.

אם ברצונכם לשמור על התנהגות cursor: pointer, הוסיפו את הקוד הבא לקובץ ה-CSS שלכם:

תוכלו גם להפעיל זאת בעת הגדרת הפרויקט באמצעות npx shadcn@latest init --pointer.

globals.css

@layer base {
  button:not(:disabled),
  [role="button"]:not(:disabled) {
    cursor: pointer;
  }
}

דוגמאות

גודל

השתמשו במאפיין size כדי לשנות את גודל הכפתור.

import { ArrowUpRightIcon } from "lucide-react"

import { Button } from "@/components/ui/button"

Default

import { Button } from "@/components/ui/button"

export function ButtonDefault() {

Outline

import { Button } from "@/components/ui/button"

export function ButtonOutline() {

Secondary

import { Button } from "@/components/ui/button"

export function ButtonSecondary() {

Ghost

import { Button } from "@/components/ui/button"

export function ButtonGhost() {

Destructive

import { Button } from "@/components/ui/button"

export function ButtonDestructive() {

Link

import { Button } from "@/components/ui/button"

export function ButtonLink() {

Icon

import { CircleFadingArrowUpIcon } from "lucide-react"

import { Button } from "@/components/ui/button"

עם סמל

זכרו להוסיף לסמל את התכונה data-icon="inline-start" או data-icon="inline-end" לריווח נכון.

import { IconGitBranch, IconGitFork } from "@tabler/icons-react"

import { Button } from "@/components/ui/button"

מעוגל

השתמשו במחלקה rounded-full כדי לעגל את הכפתור.

import { ArrowUpIcon } from "lucide-react"

import { Button } from "@/components/ui/button"

Spinner

הציגו רכיב <Spinner /> בתוך הכפתור כדי להראות מצב טעינה. זכרו להוסיף ל-Spinner את התכונה data-icon="inline-start" או data-icon="inline-end" לריווח נכון.

import { Button } from "@/components/ui/button"
import { Spinner } from "@/components/ui/spinner"

Button Group

כדי ליצור קבוצת כפתורים, השתמשו ברכיב ButtonGroup. עיינו בתיעוד Button Group לפרטים נוספים.

"use client"

import * as React from "react"

כקישור

תוכלו להשתמש בפונקציית העזר buttonVariants כדי לגרום לקישור להיראות כמו כפתור.

אל תשתמשו ב-<Button render={<a />} nativeButton={false} /> עבור קישורים. רכיב ה-Button של Base UI תמיד מחיל role="button", מה שעוקף את תפקיד הקישור הסמנטי של אלמנטי <a>. במקום זאת, השתמשו ב-buttonVariants עם תגית <a> פשוטה.

import { buttonVariants } from "@/components/ui/button"

export function ButtonRender() {

RTL

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

"use client"

import { ArrowRightIcon, PlusIcon } from "lucide-react"

נגישות

ה-button עוקב אחרי דפוס Button של WAI-ARIA. הוא מרנדר <button> מקורי כברירת מחדל; כש-render מחליף לאלמנט אחר, Base UI מחבר role="button", tabindex והפעלת מקלדת כך שהתחליף מתנהג כמו כפתור אמיתי לטכנולוגיה מסייעת (ראו את ההערה As Link למעלה למקרה היחיד שבו ה-role הזה שגוי).

אינטראקציות מקלדת:

מקש	פעולה
`Tab` / `Shift + Tab`	מעבירים מוקד אל / מהכפתור
`Space` / `Enter`	מפעילים את הכפתור

תיעוד ה-API

Button

רכיב Button הוא עטיפה סביב אלמנט ה-button שמוסיפה מגוון עיצובים ופונקציונליות.

Prop	Type	Default
`variant`	`"default" \| "outline" \| "ghost" \| "destructive" \| "secondary" \| "link"`	`"default"`
`size`	`"default" \| "xs" \| "sm" \| "lg" \| "icon" \| "icon-xs" \| "icon-sm" \| "icon-lg"`	`"default"`