{"schemaVersion":1,"id":"2026-10-12-toolbar-button-names","status":"draft","source":{"kind":"entry-mdx","path":"apps/www/src/registry/changelog/entries/2026-10-12-toolbar-button-names.mdx"},"change":{"type":"source","date":"2026-10-12","commits":[]},"release":{"status":"unresolved"},"kind":"fix","summary":"Name icon-only toolbar buttons for assistive tech","targets":[{"name":"toolbar","files":["apps/www/src/registry/bases/base/toolbar.tsx","apps/www/src/registry/bases/radix/toolbar.tsx","apps/www/src/registry/components/editor/toolbar-overlay.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"turn-into-toolbar-button","files":["apps/www/src/registry/components/editor/turn-into-toolbar-button.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"mode-toolbar-button","files":["apps/www/src/registry/components/editor/mode-toolbar-button.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"list-toolbar-button","files":["apps/www/src/registry/components/editor/list-toolbar-button.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"media-toolbar-button","files":["apps/www/src/registry/components/editor/media-toolbar-button.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"history-toolbar-button","files":["apps/www/src/registry/components/editor/history-toolbar-button.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"import-toolbar-button","files":["apps/www/src/registry/components/editor/import-toolbar-button.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"export-toolbar-button","files":["apps/www/src/registry/components/editor/export-toolbar-button.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"table-toolbar-button","files":["apps/www/src/registry/components/editor/table-toolbar-button.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"comment-toolbar-button","files":["apps/www/src/registry/components/editor/comment-toolbar-button.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"more-toolbar-button","files":["apps/www/src/registry/components/editor/more-toolbar-button.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"emoji-toolbar-button","files":["apps/www/src/registry/components/editor/emoji-toolbar-button.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"table","files":["apps/www/src/registry/components/editor/table.tsx"],"definitionFiles":["apps/www/src/registry/registry-features.ts"],"diagnostics":[]}],"entries":[{"id":"2026-10-12-toolbar-button-tooltip-name","kind":"fix","summary":"`ToolbarButton` uses a string `tooltip` as the button's accessible name when you pass no `aria-label`. Screen readers announce icon-only buttons such as Link by that name, and `getByRole('button', { name: 'Link' })` finds them.","details":[],"migrationNotes":[],"targets":["toolbar"],"source":{"line":14,"row":1,"legacyRelease":{"date":"2026-10-12","entry":"2026-10-12-toolbar-button-names","section":null}}},{"id":"2026-10-12-toolbar-button-value-names","kind":"fix","summary":"Name the button with its label and current value, such as \"Turn into: Text\" and \"Editing mode: Editing\". The mode button keeps its name when narrow screens hide its text.","details":[],"migrationNotes":[],"targets":["turn-into-toolbar-button","mode-toolbar-button"],"source":{"line":16,"row":2,"legacyRelease":{"date":"2026-10-12","entry":"2026-10-12-toolbar-button-names","section":null}}},{"id":"2026-10-12-toolbar-split-button-names","kind":"fix","summary":"Name both halves of each split button, such as \"Bulleted list\" and \"Bulleted list styles\", or \"Image\" and \"Image options\".","details":[],"migrationNotes":[],"targets":["list-toolbar-button","media-toolbar-button"],"source":{"line":18,"row":3,"legacyRelease":{"date":"2026-10-12","entry":"2026-10-12-toolbar-button-names","section":null}}},{"id":"2026-10-12-toolbar-duplicate-labels","kind":"wiring","summary":"Remove each `aria-label` that repeated the button's `tooltip`. The accessible names stay the same.","details":[],"migrationNotes":[],"targets":["history-toolbar-button","import-toolbar-button","export-toolbar-button","table-toolbar-button","comment-toolbar-button","more-toolbar-button","emoji-toolbar-button","table"],"source":{"line":20,"row":4,"legacyRelease":{"date":"2026-10-12","entry":"2026-10-12-toolbar-button-names","section":null}}}],"diagnostics":[]}