diff --git a/packages/button/src/vaadin-button.d.ts b/packages/button/src/vaadin-button.d.ts index 9a2d3fbe4b2..be15a29e009 100644 --- a/packages/button/src/vaadin-button.d.ts +++ b/packages/button/src/vaadin-button.d.ts @@ -38,13 +38,12 @@ import { ButtonMixin } from './vaadin-button-mixin.js'; */ declare class Button extends ButtonMixin(ElementMixin(ThemableMixin(ControllerMixin(HTMLElement)))) { /** - * When true, disables all user interactions with the button such as - * clicking, focusing, etc. + * When set to true, prevents any user interaction with the button + * such as clicking, focusing, etc. * - * However, for better accessibility, it's strongly recommended to keep - * disabled buttons focusable so that screen readers can reach and properly - * announce them to users. This behavior is currently available behind the - * feature flag: + * To improve accessibility, disabled buttons can be made focusable + * so that screen readers can reach and properly announce them to + * users. This behavior can be enabled with the feature flag: * * ``` * // Enable before any button is attached to the DOM. diff --git a/packages/button/src/vaadin-button.js b/packages/button/src/vaadin-button.js index 27359723211..2df87962663 100644 --- a/packages/button/src/vaadin-button.js +++ b/packages/button/src/vaadin-button.js @@ -53,13 +53,12 @@ class Button extends ButtonMixin(ElementMixin(ThemableMixin(ControllerMixin(Poly static get properties() { return { /** - * When true, disables all user interactions with the button such as - * clicking, focusing, etc. + * When set to true, prevents any user interaction with the button + * such as clicking, focusing, etc. * - * However, for better accessibility, it's strongly recommended to keep - * disabled buttons focusable so that screen readers can reach and properly - * announce them to users. This behavior is currently available behind the - * feature flag: + * To improve accessibility, disabled buttons can be made focusable + * so that screen readers can reach and properly announce them to + * users. This behavior can be enabled with the feature flag: * * ``` * // Enable before any button is attached to the DOM.