Example Component Library
Broken components Broken button Broken quote
Demo Components
Cards (No Flattening)
Layouts
Hero
Info card
Slotted card
Product Pricing Card Dashboard Grid Showcase
Rich button Svg icon User card
Button
Destructive Action Disabled State Dark Theme Preview Dialog Action Layout
Badge
System Status Indicator Dynamic Unread Counter
Alert
Security Outage Alert Dismissible Notification Shell
Quote oneup
Hero Editorial Callout
Promoted App Demo Demo
Demo Extra Button
Demo Nav
Cards
Info card
Elements
Quote oneup Badge
Icon
Accessibility
Generic
Divider Tooltip
Action button Design guidelines
Demo Single Chip Pill
Gallery / Demo Nav / Elements / Icon / Accessibility Gallery / / Accessibility
Demo Nav / Elements / Icon /

Icon Accessibility

Screen readers

Always pair icons with a visible or visually-hidden text label. The icon component sets aria-hidden="true" so screen readers skip the icon element itself.

<button>
  {% icon "close" %}
  <span class="sr-only">Close</span>
</button>

Colour contrast

Icon fill colour must meet a minimum 3:1 contrast ratio against its background for non-text contrast (WCAG 1.4.11).