NV Elements Catalog Starters Repo System Themes Getting Started Getting Started Installation CLI MCP Skills Lint Integrations Getting Started Angular Bundles Custom Elements Golang Hugo Import Maps Lit Lit Library MCP Apps NextJS Nuxt Preact React SolidJS Svelte TypeScript Vue About 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 Elements Accordion Alert Avatar Badge Breadcrumb Button Button Group Card Chat Message Checkbox Color Combobox Copy Button Datagrid 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 Datetime Format Number Format Relative Time Forms Validation Actions Control Icon Icon Button Input Input Group Logo Menu Month 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 Week Patterns Authentication Browse Chat Dashboard Editor Empty States Heatmap Keyboard Shortcut Logging Media Navigation Onboarding Panel Responsive Search Subheader Trend Code Codeblock Monaco Input Diff Input Editor Diff Editor Problems Markdown Markdown CSS Utility 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:  0.2.4 Coverage: 100.00% Bundle: 12.28kb Lighthouse: 100 Axe Core Released: 0.1.3
Overview API Examples
DefaultGroupStatesInteractionContainerSizePressedSelectedDisabledInvokerCommandWithIconFlatInlineLinkSelectedFlatLinkFlatNoWrapFormSubmitFormControlPopoverBackgroundOverrideValidLinkButtonInvalidLinkButtonProgressDisclosureContrastColoredBackgrounds

Default

standard
Edit Example

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.

Group States

test-case
standard selected pressed disabled
Edit Example

Button interaction states including hover, focus, pressed, selected, and disabled.

Interaction

standard emphasis destructive
Edit Example

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.

Container

inline flat default
Edit Example

Demonstrates different container styles to accommodate visual weight and context.

Container Description flat Element has white space bounds but reduced visual container. inline Element container reduces to fit within inline content such as a block of text.

Size

small button standard button large button
Edit Example

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.

Pressed

pressed inline pressed flat pressed
Edit Example

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.

Selected

selected inline selected flat selected
Edit Example

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.

Disabled

disabled inline disabled flat disabled
Edit Example

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.

Invoker Command

Rotate left Rotate right toggle-popover
popover
Edit Example

Use the commandfor and command attributes to trigger custom Invoker Commands, such as rotating an image.

With Icon

button button
Edit Example

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

Flat

standard emphasis destructive disabled
Edit Example

Flat button style for secondary actions with minimal visual weight, maintaining clear interaction states.

Inline

standard emphasis destructive disabled
Edit Example

Inline button style for text-like actions that blend with content while maintaining button functionality.

Edit Example

Button styling applied to links for consistent visual treatment while maintaining semantic navigation behavior.

Selected Flat

selected unselected
Edit Example

Flat button selection state for choice groups where one option is active, providing clear selection feedback.

Edit Example

Flat button styling for navigation links, providing subtle visual treatment for secondary navigation actions.

No Wrap

test-case
item item item itemitemitem
Edit Example

Text wrapping behavior in constrained widths, where content adapts to available space.

Form Submit

submit
Edit Example

Form submission button with proper form integration and data handling for user input processing.

Form Control

filter option
Edit Example

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.

Popover

test-case
popover
toggle
Edit Example

Button integrated with popover API to trigger contextual overlays, providing extra information or controls.

Background Override

test-case
Create Account Create Account
Edit Example

Override button appearance with custom CSS properties for brand-specific designs while maintaining functionality.

default
Edit Example

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.

anti-pattern
default
Edit Example

Do not wrap buttons in anchor tags.

Progress Disclosure

Submitting
Edit Example

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.

Contrast Colored Backgrounds

pattern
10 Selected
Edit Error Detected Review
Cancel action
Edit Example

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.