v2.5.0

2.5.0 (2026-07-14)

Features

• add custom-elements.json manifest (68d3b89)
• export CSSStyleSheet as default from CSSResult-in-js files (1cbfc75)
• labs: add badge utility classes to component (b4af72e)
• labs: add card utility class component (0c8986c)
• labs: add checkbox utility class component (81807b2)
• labs: add container slot support for card (ed72d96)
• labs: add container slot support for expressive button (d59dd9d)
• labs: add divider utility class component (593705e)
• labs: add expressive button utility class component (b39e13e)
• labs: add expressive fab utility class component (c86e3a2)
• labs: add expressive icon component (b8cba86)
• labs: add expressive list utility class component (33d8df2)
• labs: add expressive menu utility class component (95dd57c)
• labs: add expressive split button (3758f46)
• labs: add expressive system stylesheets (7baa861)
• labs: add icon button utility class component (3400f36)
• labs: add Material for Tailwind theme stylesheet (917e080)
• labs: add radio utility class component (d37988b)
• labs: add spacing system stylesheet (026f39d)
• labs: add switch utility class component (f6c1871)
• labs: change form-submitter to a behavior mixin (5a9f7da)
• labs: change form-submitter to a behavior mixin (4142a69)
• labs: remove elevation from button when its outline is hidden (bbdba3b)
• list,menu: support styling gap on items (3302730)
• sass-ext: add @material/web/sass/ext helper utilities (dd87fd2)

Bug Fixes

• button,iconbutton: use form-associated mixin behavior (082faad)
• button: touch target not covering tall container height (fd17013)
• field: prevent NaN transforms when element is hidden (590ae99)
• iconbutton: use event dispatch hooks for toggle clicks (9538d26)
• labs: <md-icon> not working when md-icon.css not imported (f7fd08c)
• remove internal *-styles.js generated files (7bf4a7e)
• select: stale tabindex caused incorrect typeahead value changes (e16e2f6), closes #5913
• slider: prevent internal selection and a frozen knob. (46fc0ea)
• switch: gray overlay when disabled on Firefox v150 (3b431c9)
• tokens: add expressive token versions (9779099)
• tokens: add readme for the @material/web/tokens/versions folder (a7ba471)

Reverts

• "feat(labs): change form-submitter to a behavior mixin" (38724b9)

v2.4.1

2.4.1 (2025-10-27)

Bug Fixes

• radio: also move sibling uncheck logic after root assignment (6010e52)
• radio: move root assignment to mirror hostDisconnected (adb8d10)
• tokens: @material/web/tokens/v* moved to @material/web/tokens/versions/v* (60c0cfa)

v2.4.0

2.4.0 (2025-08-21)

Features

• button: add disabled link support (c3c4848)
• button: add gradient support to container colors (5bc1506)
• catalog: hide body if dsd-pending (bf89645)
• select: add showPicker() functionality (8808a25)

Bug Fixes

• catalog: hydrate CSR component pages (0037c14)
• menu: output menu item theme values (ca5f750)
• radio: stack overflow error when rendering many radios (688ab3c)
• ripple: misaligned when using CSS zoom (3072a9b)
• ripple: remove pointerdown contextmenu bounds check for Chrome (cd7512f)

v2.3.0

2.3.0 (2025-03-26)

Features

• button: add download filename support for link buttons (4098832)
• button: rename attribute downloadFilename to download (8aefe19)
• chip: add download attribute to assist chip (902a84f)
• icon-button: add download attribute (9e84130)
• menu: add menu padding tokens (767d1f1)
• text-field: add showPicker method (bad490c)

Bug Fixes

• catalog: add hyphen to md-evelated-button attribute (ac9b14a)
• iconbutton: href will respond to touch target (ea1134a)
• labs: add mixinCustomStateSet() for :state() compatibility (045fe94)
• listitem: click() from listItemRoot (1c60e56)
• menu: export CloseReason (29d6763)
• select: missing accessible label (1bdcbd3)

v2.2.0

2.2.0 (2024-09-17)

Features

• field,textfield: add container slot for custom background content (44c13cd)

Bug Fixes

• checkbox: add override to symbol properties (a9ee4f5)
• remove the input entirely and replace it with a touch target (cf84a27)
• remove unnecessary css variable prefixes (5044e6e)
• Replace aria-hidden attribute with inert attribute in <md-radio> component (192f17e)
• Set touch target to display: none (a696121)

v2.1.0

2.1.0 (2024-08-20)

Features

• switch: add touch target token (b8f362a)
• textfield,field: add leading/trailing icon spacing tokens (c1991c4)

Bug Fixes

• changed checkmark to check in md-icon selected slot (2e2817b)

v2.0.0

2.0.0 (2024-07-23)

⚠ BREAKING CHANGES

• tokens: Sass component tokens, such as tokens.md-comp-checkbox-values(), return var(--md-<component>, <value>) instead of just the CSS value. Use $exclude-custom-properties: true to remove them.
• querySelector for [role] and [aria-*] attributes may no longer work. See @material/web/migrations/v2/README.md and @material/web/migrations/v2/query-selector-aria.ts.

Features

• button: add soft-disabled attribute for focusable disabled buttons (48124ba)
• check for server before creating treewalker from document (0d50ed9)
• chips: add label slot (7ec70c4)
• chips: add new soft-disabled attribute for focusable disabled chips (750b886)
• iconbutton: add soft-disabled attribute for focusable disabled icon buttons (281c092)

Bug Fixes

• add typecast (1482bff)
• aria-labels announcing twice with "group" on components (5df9410)
• chips: add truncation support (713f0a8)
• tokens: tokens.md-comp-*-values() include custom properties by default (55b4650)

v1.5.1

1.5.1 (2024-06-25)

Bug Fixes

• checkbox: sass theme mixin not working (46d66ed), closes #5651
• dialog: have content expand to fill height (17aa21a)
• menu: resolve aborted animations as false rather than reject (4f7ff4f), closes #5638
• switch: pressing enter toggles the switch (99ec9e2)

v1.5.0

1.5.0 (2024-05-23)

Features

• menu: allow customizing scrollbar-width (1bf8b5f)
• select: make required asterisk optional (8f194a5)
• textfield: make required asterisk optional (be5bb43)

Bug Fixes

• button: add part attribute to button (a2b5c91)
• dialog: focus is trapped for a11y, use no-focus-trap to disable (0aea436)
• docs: progress.webp not playing (2f0c99a), closes #5569
• menu: getBoundingClientRect() and getClientRects() not working (e1f9cbc)

v1.4.1

1.4.1 (2024-04-15)

Bug Fixes

• dialog: update info comment with autocomplete -> autofocus (fc4c999)
• select: select.click() opens the menu (7a6cf16)