Search every page in the navigation.
Displays a button or a component that looks like a button.
import { IconArrowUp } from "@tabler/icons-react"
import { Button } from "@/components/ui/button"
export default function ButtonDemo() {
return (
<div className="flex flex-wrap items-center gap-2 md:flex-row">
<Button variant="outline">Button</Button>
<Button variant="outline" size="icon" aria-label="Submit">
<IconArrowUp />
</Button>
</div>
)
}npx shadcn@latest add @ziiz/buttonimport { Button } from "@/components/ui/button"<Button variant="outline">Button</Button>Tailwind v4 switched from cursor: pointer to cursor: default for the button component.
If you want to keep the cursor: pointer behavior, add the following code to your CSS file:
You can also enable this during project setup with npx shadcn@latest init --pointer.
@layer base {
button:not(:disabled),
[role="button"]:not(:disabled) {
cursor: pointer;
}
}Use the size prop to change the size of the button.
import { IconArrowUpRight } from "@tabler/icons-react"
import { Button } from "@/components/ui/button"
export default function ButtonSize() {
return (
<div className="flex flex-col items-start gap-8 sm:flex-row">
<div className="flex items-start gap-2">
<Button size="xs" variant="outline">
Extra Small
</Button>
<Button size="icon-xs" aria-label="Submit" variant="outline">
<IconArrowUpRight />
</Button>
</div>
<div className="flex items-start gap-2">
<Button size="sm" variant="outline">
Small
</Button>
<Button size="icon-sm" aria-label="Submit" variant="outline">
<IconArrowUpRight />
</Button>
</div>
<div className="flex items-start gap-2">
<Button variant="outline">Default</Button>
<Button size="icon" aria-label="Submit" variant="outline">
<IconArrowUpRight />
</Button>
</div>
<div className="flex items-start gap-2">
<Button variant="outline" size="lg">
Large
</Button>
<Button size="icon-lg" aria-label="Submit" variant="outline">
<IconArrowUpRight />
</Button>
</div>
</div>
)
}import { Button } from "@/components/ui/button"
export default function ButtonDefault() {
return <Button>Button</Button>
}import { Button } from "@/components/ui/button"
export default function ButtonOutline() {
return <Button variant="outline">Outline</Button>
}import { Button } from "@/components/ui/button"
export default function ButtonSecondary() {
return <Button variant="secondary">Secondary</Button>
}import { Button } from "@/components/ui/button"
export default function ButtonGhost() {
return <Button variant="ghost">Ghost</Button>
}import { Button } from "@/components/ui/button"
export default function ButtonDestructive() {
return <Button variant="destructive">Destructive</Button>
}import { Button } from "@/components/ui/button"
export default function ButtonLink() {
return <Button variant="link">Link</Button>
}import { IconCircleArrowUp } from "@tabler/icons-react"
import { Button } from "@/components/ui/button"
export default function ButtonIcon() {
return (
<Button variant="outline" size="icon">
<IconCircleArrowUp />
</Button>
)
}Remember to add the data-icon="inline-start" or data-icon="inline-end" attribute to the icon for the correct spacing.
import { IconGitBranch, IconGitFork } from "@tabler/icons-react"
import { Button } from "@/components/ui/button"
export default function ButtonWithIcon() {
return (
<div className="flex gap-2">
<Button variant="outline">
<IconGitBranch data-icon="inline-start" /> New Branch
</Button>
<Button variant="outline">
Fork
<IconGitFork data-icon="inline-end" />
</Button>
</div>
)
}Use shape="rounded" to make the button a pill, or a circle with an icon size. Only the radius changes; a pill pads like a square button.
Components built on Button pass shape through: InputGroupButton, AlertDialogAction, AlertDialogCancel, PaginationLink, the Questionnaire navigation buttons, MessageScrollerButton, AttachmentAction and SidebarTrigger. CarouselPrevious and CarouselNext are rounded by default. Inside a Button Group, rounded buttons keep the group's two ends round.
import { IconArrowUp } from "@tabler/icons-react"
import { Button } from "@/components/ui/button"
export default function ButtonRounded() {
return (
<div className="flex gap-2">
<Button shape="rounded">Get Started</Button>
<Button variant="outline" size="icon" shape="rounded">
<IconArrowUp />
</Button>
</div>
)
}Render a <Spinner /> component inside the button to show a loading state. Remember to add the data-icon="inline-start" or data-icon="inline-end" attribute to the spinner for the correct spacing.
import { Button } from "@/components/ui/button"
import { Spinner } from "@/components/ui/spinner"
export default function ButtonLoading() {
return (
<div className="flex gap-2">
<Button variant="outline" disabled>
<Spinner data-icon="inline-start" />
Generating
</Button>
<Button variant="secondary" disabled>
Downloading
<Spinner data-icon="inline-start" />
</Button>
</div>
)
}To create a button group, use the ButtonGroup component. See the Button Group documentation for more details.
"use client"
import * as React from "react"
import {
IconArchive,
IconArrowLeft,
IconCalendarPlus,
IconClock,
IconDots,
IconFilter,
IconMailCheck,
IconTag,
IconTrash,
} from "@tabler/icons-react"
import { Button } from "@/components/ui/button"
import { ButtonGroup } from "@/components/ui/button-group"
import {
DropdownMenu,
DropdownMenuContent,
DropdownMenuGroup,
DropdownMenuItem,
DropdownMenuRadioGroup,
DropdownMenuRadioItem,
DropdownMenuSeparator,
DropdownMenuSub,
DropdownMenuSubContent,
DropdownMenuSubTrigger,
DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
export default function ButtonGroupDemo() {
const [label, setLabel] = React.useState("personal")
return (
<ButtonGroup>
<ButtonGroup className="hidden sm:flex">
<Button variant="outline" size="icon" aria-label="Go Back">
<IconArrowLeft />
</Button>
</ButtonGroup>
<ButtonGroup>
<Button variant="outline">Archive</Button>
<Button variant="outline">Report</Button>
</ButtonGroup>
<ButtonGroup>
<Button variant="outline">Snooze</Button>
<DropdownMenu>
<DropdownMenuTrigger
render={
<Button variant="outline" size="icon" aria-label="More Options" />
}
>
<IconDots />
</DropdownMenuTrigger>
<DropdownMenuContent align="end" className="w-40">
<DropdownMenuGroup>
<DropdownMenuItem>
<IconMailCheck />
Mark as Read
</DropdownMenuItem>
<DropdownMenuItem>
<IconArchive />
Archive
</DropdownMenuItem>
</DropdownMenuGroup>
<DropdownMenuSeparator />
<DropdownMenuGroup>
<DropdownMenuItem>
<IconClock />
Snooze
</DropdownMenuItem>
<DropdownMenuItem>
<IconCalendarPlus />
Add to Calendar
</DropdownMenuItem>
<DropdownMenuItem>
<IconFilter />
Add to List
</DropdownMenuItem>
<DropdownMenuSub>
<DropdownMenuSubTrigger>
<IconTag />
Label As...
</DropdownMenuSubTrigger>
<DropdownMenuSubContent>
<DropdownMenuRadioGroup
value={label}
onValueChange={setLabel}
>
<DropdownMenuRadioItem value="personal">
Personal
</DropdownMenuRadioItem>
<DropdownMenuRadioItem value="work">
Work
</DropdownMenuRadioItem>
<DropdownMenuRadioItem value="other">
Other
</DropdownMenuRadioItem>
</DropdownMenuRadioGroup>
</DropdownMenuSubContent>
</DropdownMenuSub>
</DropdownMenuGroup>
<DropdownMenuSeparator />
<DropdownMenuGroup>
<DropdownMenuItem variant="destructive">
<IconTrash />
Trash
</DropdownMenuItem>
</DropdownMenuGroup>
</DropdownMenuContent>
</DropdownMenu>
</ButtonGroup>
</ButtonGroup>
)
}You can use the buttonVariants helper to make a link look like a button.
Do not use <Button render={<a />} nativeButton={false} /> for links. The Base UI Button component always applies role="button", which overrides the semantic link role on <a> elements. Use buttonVariants with a plain <a> tag instead.
import { buttonVariants } from "@/components/ui/button"
export default function ButtonRender() {
return (
<a
href="#"
className={buttonVariants({ variant: "secondary", size: "sm" })}
>
Login
</a>
)
}The Button component is a wrapper around the button element that adds a variety of styles and functionality.
| Prop | Type | Default |
|---|---|---|
variant | "default" | "outline" | "ghost" | "destructive" | "secondary" | "link" | "default" |
size | "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | "default" |
shape | "default" | "rounded" | "default" |