Bouton
Un élément cliquable pour l'envoi de formulaires, les barres d'outils et les confirmations d'actions irréversibles — doté de bordures épaisses et d'une ombre qui s'accentue lorsque vous cliquez dessus.
import { ArrowUpIcon } from "lucide-react"
import { Button } from "@/components/ui/button"Le bouton déclenche une action — envoyer, confirmer, supprimer. Construit sur le composant Base UI Button et habillé du style néobrutaliste : bordures épaisses, une ombre décalée marquée et un état actif qui enfonce le bouton dans celle-ci.
À privilégier pour :
- Envois de formulaire et CTA principaux —
defaultporte l’action principale ;secondaryetoutlinepour tout ce qui l’accompagne. - Barres d’outils et actions à icône — les tailles
icondonnent des boutons carrés ;ButtonGrouples aligne en rangées segmentées. - Confirmations destructrices —
destructivepour supprimer et retirer, le plus souvent derrière une boîte de dialogue.
Installation#
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
Installez les dépendances suivantes :
pnpm add @base-ui/reactnpm install @base-ui/reactyarn add @base-ui/reactbun add @base-ui/react
Copiez et collez le code suivant dans votre projet.
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 }
Adaptez les chemins d’import à la structure de votre projet.
Utilisation#
import { Button } from "@/components/ui/button"<Button variant="outline">Button</Button>Curseur#
Tailwind v4 est passé de cursor: pointer à cursor: default pour le composant bouton.
Si vous souhaitez conserver le comportement cursor: pointer, ajoutez le code suivant à votre fichier CSS :
Vous pouvez aussi l’activer lors de la configuration du projet avec npx shadcn@latest init --pointer.
@layer base {
button:not(:disabled),
[role="button"]:not(:disabled) {
cursor: pointer;
}
}Exemples#
Taille#
Utilisez la prop size pour changer la taille du bouton.
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"Avec icône#
Pensez à ajouter l’attribut data-icon="inline-start" ou data-icon="inline-end" à l’icône pour un espacement correct.
import { IconGitBranch, IconGitFork } from "@tabler/icons-react"
import { Button } from "@/components/ui/button"Arrondi#
Utilisez la classe rounded-full pour arrondir le bouton.
import { ArrowUpIcon } from "lucide-react"
import { Button } from "@/components/ui/button"Spinner#
Affichez un composant <Spinner /> à l’intérieur du bouton pour indiquer un état de chargement. Pensez à ajouter l’attribut data-icon="inline-start" ou data-icon="inline-end" au spinner pour un espacement correct.
import { Button } from "@/components/ui/button"
import { Spinner } from "@/components/ui/spinner"
Button Group#
Pour créer un groupe de boutons, utilisez le composant ButtonGroup. Consultez la documentation Button Group pour en savoir plus.
"use client"
import * as React from "react"En tant que lien#
Vous pouvez utiliser l’utilitaire buttonVariants pour donner à un lien l’apparence d’un bouton.
N’utilisez pas <Button render={<a />} nativeButton={false} /> pour les liens. Le composant Button de Base UI applique toujours role="button", ce qui remplace le rôle sémantique de lien sur les éléments <a>. Utilisez plutôt buttonVariants avec une simple balise <a>.
import { buttonVariants } from "@/components/ui/button"
export function ButtonRender() {RTL#
Pour activer le RTL dans Neobrutalism, consultez le guide de configuration RTL.
"use client"
import { ArrowRightIcon, PlusIcon } from "lucide-react"Accessibilité#
Le bouton suit le modèle WAI-ARIA Button. Il rend un <button> natif par défaut ; quand render y substitue un autre élément, Base UI câble role="button", tabindex et l’activation clavier pour que l’élément de remplacement se comporte comme un vrai bouton vis-à-vis des technologies d’assistance (voir la note « En tant que lien » plus haut pour le seul cas où ce rôle n’est pas le bon).
Interactions clavier :
| Touche | Action |
|---|---|
Tab / Shift + Tab | Amène le focus sur le bouton / l’en éloigne |
Space / Enter | Active le bouton |
Référence API#
Button#
Le composant Button enveloppe l’élément button en y ajoutant divers styles et fonctionnalités.
| Prop | Type | Default |
|---|---|---|
variant | "default" | "outline" | "ghost" | "destructive" | "secondary" | "link" | "default" |
size | "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | "default" |