NV Elements Catalog Starters Repo System Themes About Getting Started Changelog Metrics Support Accessibility Contributions Requests Migration Integrations Installation MCP CLI Lint Angular Bundles Extensions Golang Hugo Import Maps Lit NextJS Nuxt Preact React SolidJS Svelte TypeScript Vue Foundations 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 Panel 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 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 Documentation Examples TypeScript Testing Unit Testing Accessibility Testing Lighthouse Testing SSR Testing Visual Testing Troubleshooting Component Creation Internal Examples All Examples

Icon Button

stable:  0.1.1 Coverage: 100.00% Bundle: 18.22kb Lighthouse: 100 Axe Core Released: 0.2.1
Overview API Examples

An icon button is a button that displays only an icon without a visual label.

Installation
CLI / MCP

Interactions

Icon buttons with different interaction styles including default, emphasis, destructive, and disabled states.

Flat Interactions

Flat container icon buttons with interaction styles for minimal visual weight in dense toolbars.

Pressed/Toggle

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.

Icon buttons with pressed state for toggle functionality like filters or visibility controls.

Pressed Flat

Flat icon buttons with pressed state for low-emphasis toggles and compact toggle controls.

Pressed Inline

Inline icon buttons with pressed state for minimal toggle controls within text or content flows.

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.

Icon buttons with selected state for mutually exclusive options like view modes or layout choices.

Selected Flat

Flat icon buttons with selected state for low-emphasis mode selection in compact toolbars.

Selected Inline

Inline icon buttons with selected state for minimal mode selection within content flows.

Anchors can wrap button instances, but its recommended to slot the anchor into the button.

Proper implementation of icon buttons with links, showing correct and incorrect anchor placement patterns.

Custom Icon

Icon buttons with custom content like text initials, emojis, or symbols for personalized actions.

ML 🎉 🔗

Themes

Icon buttons styled for light and dark themes with all interaction states for theme consistency.

Size

Icon buttons in different sizes (small, medium, large) for varying contexts and visual hierarchy.

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