Botão
Um botão clicável para enviar formulários, barras de ferramentas e confirmações de exclusão — com bordas grossas e uma sombra que se aprofunda quando você clica nele.
import { ArrowUpIcon } from "lucide-react"
import { Button } from "@/components/ui/button"O botão dispara uma ação — enviar, confirmar, excluir. Construído sobre o componente Base UI Button e estilizado seguindo a receita neobrutalista: bordas grossas, uma sombra dura deslocada e um estado ativo que pressiona o botão para dentro dela.
Use quando:
- Envios de formulário e CTAs principais —
defaultcarrega a ação principal;secondaryeoutlinepara tudo o que fica ao lado dela. - Barras de ferramentas e ações com ícone — os tamanhos
iconcriam botões quadrados; oButtonGroupos alinha em fileiras segmentadas. - Confirmações destrutivas —
destructivepara excluir e remover, geralmente atrás de um diálogo.
Instalação#
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
Instale as seguintes dependências:
pnpm add @base-ui/reactnpm install @base-ui/reactyarn add @base-ui/reactbun add @base-ui/react
Copie e cole o código a seguir no seu projeto.
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 }
Atualize os caminhos de importação para corresponder à estrutura do seu projeto.
Uso#
import { Button } from "@/components/ui/button"<Button variant="outline">Button</Button>Cursor#
O Tailwind v4 mudou de cursor: pointer para cursor: default no componente de botão.
Se você quiser manter o comportamento cursor: pointer, adicione o código a seguir ao seu arquivo CSS:
Você também pode ativá-lo durante a configuração do projeto com npx shadcn@latest init --pointer.
@layer base {
button:not(:disabled),
[role="button"]:not(:disabled) {
cursor: pointer;
}
}Exemplos#
Tamanho#
Use a prop size para alterar o tamanho do botão.
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"Com ícone#
Lembre-se de adicionar o atributo data-icon="inline-start" ou data-icon="inline-end" ao ícone para que o espaçamento fique correto.
import { IconGitBranch, IconGitFork } from "@tabler/icons-react"
import { Button } from "@/components/ui/button"Arredondado#
Use a classe rounded-full para arredondar o botão.
import { ArrowUpIcon } from "lucide-react"
import { Button } from "@/components/ui/button"Spinner#
Renderize um componente <Spinner /> dentro do botão para mostrar um estado de carregamento. Lembre-se de adicionar o atributo data-icon="inline-start" ou data-icon="inline-end" ao spinner para que o espaçamento fique correto.
import { Button } from "@/components/ui/button"
import { Spinner } from "@/components/ui/spinner"
Button Group#
Para criar um grupo de botões, use o componente ButtonGroup. Consulte a documentação de Button Group para mais detalhes.
"use client"
import * as React from "react"Como link#
Você pode usar o helper buttonVariants para dar a um link a aparência de um botão.
Não use <Button render={<a />} nativeButton={false} /> para links. O componente Button do Base UI sempre aplica role="button", o que anula o papel semântico de link nos elementos <a>. Use buttonVariants com uma tag <a> simples no lugar.
import { buttonVariants } from "@/components/ui/button"
export function ButtonRender() {RTL#
Para ativar o suporte a RTL no Neobrutalism, consulte o guia de configuração de RTL.
"use client"
import { ArrowRightIcon, PlusIcon } from "lucide-react"Acessibilidade#
O botão segue o padrão Button do WAI-ARIA. Ele renderiza um <button> nativo por padrão; quando render o troca por outro elemento, o Base UI conecta role="button", tabindex e a ativação por teclado para que o substituto se comporte como um botão de verdade para a tecnologia assistiva (veja a observação em Como link acima para o único caso em que esse role é errado).
Interações de teclado:
| Tecla | Ação |
|---|---|
Tab / Shift + Tab | Move o foco para o botão / para fora dele |
Space / Enter | Aciona o botão |
Referência da API#
Button#
O componente Button é um invólucro do elemento button que adiciona uma variedade de estilos e funcionalidades.
| Prop | Type | Default |
|---|---|---|
variant | "default" | "outline" | "ghost" | "destructive" | "secondary" | "link" | "default" |
size | "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | "default" |