Кнопка
Активная кнопка для отправки форм, панелей инструментов и подтверждений удаления данных — с толстыми рамками и тенью, которая появляется при нажатии.
import { ArrowUpIcon } from "lucide-react"
import { Button } from "@/components/ui/button"Кнопка запускает действие — отправить, подтвердить, удалить. Построена на компоненте Base UI Button и оформлена по рецепту необрутализма: толстые рамки, жёсткая тень со смещением и нажатие, которое вдавливает кнопку в эту тень.
Когда это пригодится:
- Отправка форм и главные призывы к действию —
defaultберёт на себя основное действие, аsecondaryиoutline— всё, что стоит рядом. - Панели инструментов и действия-иконки — размеры
iconдают квадратные кнопки, аButtonGroupсобирает их в сегментированные ряды. - Подтверждение опасных действий —
destructiveдля удаления, обычно за диалогом.
Установка#
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
Установите следующие зависимости:
pnpm add @base-ui/reactnpm install @base-ui/reactyarn add @base-ui/reactbun add @base-ui/react
Скопируйте и вставьте следующий код в свой проект.
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>Cursor#
В Tailwind v4 для компонента кнопки сменили cursor: pointer на cursor: default.
Если вы хотите сохранить поведение cursor: pointer, добавьте следующий код в свой CSS-файл:
Вы также можете включить это при настройке проекта командой npx shadcn@latest init --pointer.
@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 /> внутри кнопки, чтобы показать состояние загрузки. Не забудьте добавить спиннеру атрибут 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"Доступность#
Кнопка следует паттерну WAI-ARIA Button. По умолчанию она рендерит нативный <button>; если через render подставить другой элемент, Base UI сам добавит role="button", tabindex и активацию с клавиатуры, чтобы для вспомогательных технологий замена вела себя как настоящая кнопка (единственный случай, когда эта роль неуместна, описан выше в разделе «Как ссылка»).
Управление с клавиатуры:
| Клавиша | Действие |
|---|---|
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" |