Tombol
Tombol pemicu yang dapat diklik untuk pengiriman formulir, bilah alat, dan konfirmasi yang membatalkan — dilengkapi dengan garis tepi tebal serta bayangan yang muncul saat tombol tersebut diklik.
import { ArrowUpIcon } from "lucide-react"
import { Button } from "@/components/ui/button"Button memicu sebuah aksi — kirim, konfirmasi, hapus. Dibangun di atas komponen Base UI Button dan ditata dengan resep neobrutalis: garis tepi tebal, bayangan offset yang keras, dan efek tekan aktif yang mendorong tombol masuk ke bayangannya.
Gunakan saat:
- Pengiriman formulir dan CTA utama —
defaultmembawa aksi utama;secondarydanoutlineuntuk semua yang mendampinginya. - Toolbar dan aksi ikon — ukuran
iconmenghasilkan tombol persegi;ButtonGroupmenjajarkannya menjadi baris tersegmentasi. - Konfirmasi destruktif —
destructiveuntuk hapus dan keluarkan, biasanya di balik sebuah dialog.
Instalasi#
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
Pasang dependensi berikut:
pnpm add @base-ui/reactnpm install @base-ui/reactyarn add @base-ui/reactbun add @base-ui/react
Salin dan tempel kode berikut ke proyek Anda.
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 }
Perbarui jalur import agar sesuai dengan struktur proyek Anda.
Penggunaan#
import { Button } from "@/components/ui/button"<Button variant="outline">Button</Button>Cursor#
Tailwind v4 beralih dari cursor: pointer ke cursor: default untuk komponen tombol.
Jika Anda ingin mempertahankan perilaku cursor: pointer, tambahkan kode berikut ke file CSS Anda:
Anda juga bisa mengaktifkannya saat penyiapan proyek dengan npx shadcn@latest init --pointer.
@layer base {
button:not(:disabled),
[role="button"]:not(:disabled) {
cursor: pointer;
}
}Contoh#
Ukuran#
Gunakan prop size untuk mengubah ukuran tombol.
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"Dengan Ikon#
Ingat untuk menambahkan atribut data-icon="inline-start" atau data-icon="inline-end" pada ikon agar jaraknya benar.
import { IconGitBranch, IconGitFork } from "@tabler/icons-react"
import { Button } from "@/components/ui/button"Membulat#
Gunakan kelas rounded-full untuk membuat tombol membulat.
import { ArrowUpIcon } from "lucide-react"
import { Button } from "@/components/ui/button"Spinner#
Render komponen <Spinner /> di dalam tombol untuk menampilkan keadaan memuat. Ingat untuk menambahkan atribut data-icon="inline-start" atau data-icon="inline-end" pada spinner agar jaraknya benar.
import { Button } from "@/components/ui/button"
import { Spinner } from "@/components/ui/spinner"
Button Group#
Untuk membuat grup tombol, gunakan komponen ButtonGroup. Lihat dokumentasi Button Group untuk detail lebih lanjut.
"use client"
import * as React from "react"Sebagai Link#
Anda bisa menggunakan helper buttonVariants untuk membuat link tampak seperti tombol.
Jangan gunakan <Button render={<a />} nativeButton={false} /> untuk link. Komponen Button dari Base UI selalu menerapkan role="button", yang menggantikan peran semantik link pada elemen <a>. Gunakan buttonVariants dengan tag <a> biasa sebagai gantinya.
import { buttonVariants } from "@/components/ui/button"
export function ButtonRender() {RTL#
Untuk mengaktifkan dukungan RTL di Neobrutalism, lihat panduan konfigurasi RTL.
"use client"
import { ArrowRightIcon, PlusIcon } from "lucide-react"Aksesibilitas#
Button mengikuti pola Button WAI-ARIA. Secara bawaan ia merender <button> natif; saat render menggantinya dengan elemen lain, Base UI memasang role="button", tabindex, dan aktivasi keyboard sehingga elemen pengganti berperilaku seperti tombol sungguhan bagi teknologi asistif (lihat catatan Sebagai Link di atas untuk satu-satunya kasus ketika role tersebut keliru).
Interaksi keyboard:
| Tombol | Aksi |
|---|---|
Tab / Shift + Tab | Memindahkan fokus ke / dari tombol |
Space / Enter | Mengaktifkan tombol |
Referensi API#
Button#
Komponen Button adalah pembungkus di sekitar elemen button yang menambahkan berbagai gaya dan fungsionalitas.
| Prop | Type | Default |
|---|---|---|
variant | "default" | "outline" | "ghost" | "destructive" | "secondary" | "link" | "default" |
size | "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | "default" |