NV NVIDIA Elements Catalog Starters GitHub System Themes Getting Started Getting Started Installation CLI MCP Skills Lint GitHub Integrations Getting Started Angular Bundles CDN Custom Elements Eleventy Golang HTMX + Go Hugo Import Maps Lit Lit Library MCP Apps NextJS Nuxt Pi Preact React SolidJS Sphinx Svelte TypeScript Vue About What’s New Changelog Metrics Support Accessibility Contributions Requests Migration Foundations Overview Typography Iconography Themes Design Tokens Size & Space Objects Interactions Support Status Color Animation Fonts Layers Custom Layout Horizontal Vertical Grid Popovers i18n Visualization View Transitions DESIGN.md Elements Accordion Alert Avatar Badge Breadcrumb Button Button Group Card Chat Message Checkbox Codeblock Color Combobox Copy Button Datagrid Getting Started Integrations Column Action Column Alignment Column Fixed Column width Container Card Display Settings Footer Heatmap Keynav Multi Select Pagination Panel Detail Panel Grid Performance Placeholder Row Action Row Groups Row Sort Scroll Height Single Select Stripe Date Datetime Dialog Divider Dot Drawer Dropdown Dropdown Group Dropzone File Format Bytes Datetime Number Relative Time Truncate Forms Getting Started Validation Actions Control Gauge Icon Icon Button Input Input Group Logo Markdown Markdown CSS Media Controller Pause Button Playback Rate Select Mute Button Seek Button Time Range Volume Range Full-screen Button Menu Month Monaco Input Diff Input Monaco Editor Diff Editor Problems Notification Page Page Header Page Loader Pagination Progressive Filter Chip Progress Bar Progress Ring Password Preferences Input Pulse Radio Range Resize Handle Search Select Skeleton Sort Button Sparkline Star Rating Steps Switch Tabs Tag Textarea Time Toast Toggletip Toolbar Tooltip Tree Viewport Week Patterns Authentication Browse Chat Dashboard Editor Empty States Heatmap Keyboard Shortcut Logging Media Navigation Onboarding Panel Responsive Search Subheader Trend Labs Responsive Layout Viewport Container Patterns Forms API Design Properties & Attributes Slots Registration CustomEvents Stateless Composition Styles Packaging Glossary Logs Internal Guidelines Agent Harness Agent Tooling Agent Ownership Documentation Examples TypeScript Testing Unit Testing Accessibility Testing Lighthouse Testing SSR Testing Visual Testing Troubleshooting Component Creation Internal Examples All Examples

Button

stable:  2.12.0 Coverage: 100.00% Bundle: 12.19kb Lighthouse: 100 Axe Core Released: 0.1.3
Overview API Examples

A button is a widget that enables users to trigger an action or event, such as submitting a form, opening a dialog, canceling an action, or performing a delete operation.

standard

Installation

CLI / MCP / CDN

Options

Interaction

The Interaction type provides a way to show the intent of an interactive element. This can help users quickly understand what each interaction does and reduce the potential for confusion or errors.

Interaction Description emphasis Shows the interaction targets emphasis or highlighting primary actions. destructive Shows the interaction targets destructive actions such as deleting or removing.

Interaction states that communicate button hierarchy, importance, and availability to users.

standard emphasis destructive

Container

Determines the container of the button. Flat suits nesting within other containers or more muted style. Inline suits inline content such as text.

Container Description flat inline

Container style variants for buttons to accommodate different visual weight and context.

inline flat default

Size

Controls the visual scale of an element to match its importance and available space.

Size Description sm Compact size for dense layouts or secondary elements with less visual prominence. md Standard size that works well in most contexts and provides balanced visibility. lg Larger size for emphasizing important elements or improving touch targets in spacious layouts.

Button size variants to accommodate layout densities and touch target requirements.

small button standard button large button

Pressed

Indicates the current state of a toggle button that switches on or off. MDN

Pressed Description true The button is in the pressed (on) state and the associated action or setting is active. false The button is in the unpressed (off) state and the associated action or setting is inactive.

Pressed state for toggle buttons marking active/selected state with clear visual feedback.

pressed inline pressed flat pressed

Selected

Indicates whether an element currently holds selection within a multi-option selection group. MDN

Selected Description true The element holds selection and represents the user's current choice within the group. false The element does not hold selection and the user can choose it.

Button selection states to accommodate different visual weight and context.

selected inline selected flat selected

Disabled

This Boolean attribute prevents the user from interacting with the element: it cannot receive press or focus events. MDN

Disabled Description true The element has a disabled state and does not accept interaction. false The element has an enabled state and accepts interaction.

Button disabled states to accommodate different visual weight and context.

disabled inline disabled flat disabled

Guidelines

Icon Usage

Button with icons positioned before or after text to enhance visual clarity and user understanding.

button button

Triggering Custom Form Controls

Use the form control option for buttons that open custom controls such as dropdowns, filter menus, or pickers within a form layout. This pattern keeps the UI cohesive and helps users recognize the button as part of the form.

filter option

Disclosing Progress

Use a progress ring within a button to communicate that an action is processing and prevent repeated submissions. Limit this pattern to short, indeterminate actions (about five seconds or less); for longer or determinate tasks, use a progress bar or ring outside the button.

Submitting

Ensure Contrast on Colored Background

Use standard interaction styling to keep buttons readable on contrasting backgrounds in light and dark themes. This pattern verifies the static button colors that deliver the intended contrast for each theme.

10 Selected
Edit Error Detected Review
Cancel action

Creating Linked Buttons

Do Don't

Button styled as a link by slotting an anchor tag inside. Use when an action needs button visual treatment while maintaining semantic link navigation and accessibility.

default

Do not wrap buttons in anchor tags.

default

Release Status

All elements and features go through 3 phases of stability, pre-release, beta and stable.

pre-release
Docs Preview API Documentation Fully Themeable
beta
Robust unit test coverages Passed API Review Passed Designer VQA Review Included in library package
stable
No known outstanding AA WCAG issues No known outstanding performance issues Adapts to different screen/container sizes No breaking API changes for at least 90 days