Düğme
Form gönderimleri, araç çubukları ve geri dönüşü olmayan onaylar için tıklanabilir bir tetikleyici — kalın kenarlıklarla ve tıklandığında içine gölge düşen bir tasarıma sahip.
import { ArrowUpIcon } from "lucide-react"
import { Button } from "@/components/ui/button"Buton bir eylemi tetikler — gönderme, onaylama, silme. Base UI Button bileşeni üzerine kuruludur ve neobrütalist reçeteye göre biçimlendirilmiştir: kalın kenarlıklar, sert bir ofset gölge ve butonu gölgesinin içine iten bir basılma efekti.
Şu durumlarda tercih edin:
- Form gönderimleri ve birincil CTA'lar — ana eylemi
defaulttaşır; onun yanındaki her şey içinsecondaryveoutline. - Araç çubukları ve simge eylemleri —
iconboyutları kare butonlar üretir;ButtonGroupbunları bölmeli sıralara dizer. - Yıkıcı onaylar — silme ve kaldırma için
destructive; genellikle bir diyaloğun arkasında.
Kurulum#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/button.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/button.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/button.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/button.json
Şu bağımlılıkları kurun:
pnpm add @base-ui/reactnpm install @base-ui/reactyarn add @base-ui/reactbun add @base-ui/react
Aşağıdaki kodu kopyalayıp projenize yapıştırın.
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 yollarını projenizin yapısına uyacak şekilde güncelleyin.
Kullanım#
import { Button } from "@/components/ui/button"<Button variant="outline">Button</Button>Cursor#
Tailwind v4, buton bileşeni için cursor: pointer'dan cursor: default'a geçti.
cursor: pointer davranışını korumak istiyorsanız, aşağıdaki kodu CSS dosyanıza ekleyin:
Bunu proje kurulumu sırasında npx shadcn@latest init --pointer ile de etkinleştirebilirsiniz.
@layer base {
button:not(:disabled),
[role="button"]:not(:disabled) {
cursor: pointer;
}
}Örnekler#
Boyut#
Butonun boyutunu değiştirmek için size prop'unu kullanın.
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"Simgeli#
Doğru aralık için simgeye data-icon="inline-start" veya data-icon="inline-end" özniteliğini eklemeyi unutmayın.
import { IconGitBranch, IconGitFork } from "@tabler/icons-react"
import { Button } from "@/components/ui/button"Yuvarlatılmış#
Butonu yuvarlatmak için rounded-full sınıfını kullanın.
import { ArrowUpIcon } from "lucide-react"
import { Button } from "@/components/ui/button"Spinner#
Bir yükleme durumu göstermek için butonun içinde bir <Spinner /> bileşeni render edin. Doğru aralık için spinner'a data-icon="inline-start" veya data-icon="inline-end" özniteliğini eklemeyi unutmayın.
import { Button } from "@/components/ui/button"
import { Spinner } from "@/components/ui/spinner"
Button Group#
Bir buton grubu oluşturmak için ButtonGroup bileşenini kullanın. Daha fazla ayrıntı için Button Group dokümanlarına bakın.
"use client"
import * as React from "react"Link Olarak#
Bir link'i buton gibi göstermek için buttonVariants yardımcısını kullanabilirsiniz.
Link'ler için <Button render={<a />} nativeButton={false} /> kullanmayın. Base UI Button bileşeni her zaman role="button" uygular; bu da <a> öğelerindeki anlamsal link rolünü geçersiz kılar. Bunun yerine düz bir <a> etiketiyle buttonVariants kullanın.
import { buttonVariants } from "@/components/ui/button"
export function ButtonRender() {RTL#
Neobrutalism'de RTL desteğini etkinleştirmek için RTL yapılandırma kılavuzuna bakın.
"use client"
import { ArrowRightIcon, PlusIcon } from "lucide-react"Erişilebilirlik#
Buton, WAI-ARIA Button desenini izler. Varsayılan olarak doğal bir <button> işler; render yerine başka bir öğe koyduğunuzda Base UI role="button", tabindex ve klavye etkinleştirmesini kendisi bağlar, böylece yeni öğe yardımcı teknolojilere gerçek bir buton gibi görünür (bu rolün yanlış olduğu tek durum için yukarıdaki Link Olarak notuna bakın).
Klavye etkileşimleri:
| Tuş | Eylem |
|---|---|
Tab / Shift + Tab | Odağı butona taşır / butondan alır |
Space / Enter | Butonu etkinleştirir |
API Referansı#
Button#
Button bileşeni, button öğesinin etrafında çeşitli stiller ve işlevsellik ekleyen bir sarmalayıcıdır.
| Prop | Type | Default |
|---|---|---|
variant | "default" | "outline" | "ghost" | "destructive" | "secondary" | "link" | "default" |
size | "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | "default" |