Button
Create actions in many different styles
import { Button } from "@plexui/ui/components/Button";Examples
Overview
Colors & variants
Sizing & roundness
size
Icons
variant
size
gutterSize
iconSize
Block
Disabled
Inert
Loading
Selected
variant
Optical alignment
Default gutters
opticallyAlign="start"
Button shares the unified 9-step size scale with Input, Select, SelectControl, and SegmentedControl.
Reference
| Prop | Type | Default | Description |
|---|---|---|---|
color | "primary" | "secondary" | "danger" | "success" | "info" | "discovery" | "caution" | "warning" | "primary" | Visual color scheme |
variant | "solid" | "soft" | "outline" | "ghost" | "solid" | Button style variant |
size | "3xs" | "2xs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "md" | Control height and default gutter/icon size |
pill | boolean | true | Fully rounded corners |
block | boolean | false | Full width |
uniform | boolean | false | Square icon button (width equals height) |
disabled | boolean | false | Visually and accessibly disabled |
loading | boolean | false | Shows loading indicator |
inert | boolean | false | Accessibly disabled without visual change |
selected | boolean | false | Selected state styling |
opticallyAlign | "start" | "end" | — | Offset gutter for optical alignment |
gutterSize | string | — | Horizontal padding size |
iconSize | string | — | Size of icons in children |