diff --git a/button/internal/button.ts b/button/internal/button.ts index 7037f80b92..bbde5f8c02 100644 --- a/button/internal/button.ts +++ b/button/internal/button.ts @@ -51,6 +51,16 @@ export abstract class Button extends buttonBaseClass implements FormSubmitter { */ @property({type: Boolean, reflect: true}) disabled = false; + /** + * When true, allows disabled buttons to be focused. + * + * Add this when a button needs increased visibility when disabled. See + * https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/#kbd_disabled_controls + * for more guidance on when this is needed. + */ + @property({type: Boolean, attribute: 'always-focusable'}) + alwaysFocusable = false; + /** * The URL that the link button points to. */ @@ -154,7 +164,8 @@ export abstract class Button extends buttonBaseClass implements FormSubmitter { return html`