material-components · copybara-service · Apr 28, 2026 · Apr 28, 2026 · Apr 28, 2026 · Apr 28, 2026
diff --git a/button/internal/button.ts b/button/internal/button.ts
@@ -35,11 +35,6 @@ export abstract class Button extends buttonBaseClass {
     delegatesFocus: true,
   };
 
-  /**
-   * Whether or not the button is disabled.
-   */
-  declare disabled: boolean; // for jsdoc until lit-analyzer is updated
-
   /**
    * Whether or not the button is "soft-disabled" (disabled but still
    * focusable).

diff --git a/checkbox/internal/checkbox.ts b/checkbox/internal/checkbox.ts
@@ -178,10 +178,6 @@ export class Checkbox extends checkboxBaseClass {
     redispatchEvent(this, event);
   }
 
-  // Writable mixin properties for lit-html binding, needed for lit-analyzer
-  declare disabled: boolean;
-  declare name: string;
-
   override [getFormValue]() {
     if (!this.checked || this.indeterminate) {
       return null;

diff --git a/docs/components/button.md b/docs/components/button.md
@@ -734,17 +734,18 @@ Token                               | Default value
 
 | Property | Attribute | Type | Default | Description |
 | --- | --- | --- | --- | --- |
-| `disabled` | `disabled` | `boolean` | `false` | Whether or not the button is disabled. |
 | `softDisabled` | `soft-disabled` | `boolean` | `false` | Whether or not the button is "soft-disabled" (disabled but still focusable).<br>Use 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. |
 | `href` | `href` | `string` | `''` | The URL that the link button points to. |
 | `download` | `download` | `string` | `''` | The filename to use when downloading the linked resource. If not specified, the browser will determine a filename. This is only applicable when the button is used as a link (`href` is set). |
-| `target` | `target` | `string` | `''` | Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab. |
+| `target` | `target` | `"" \| "_blank" \| "_parent" \| "_self" \| "_top"` | `''` | Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab. |
 | `trailingIcon` | `trailing-icon` | `boolean` | `false` | Whether to render the icon at the inline end of the label rather than the inline start.<br>_Note:_ Link buttons cannot have trailing icons. |
 | `hasIcon` | `has-icon` | `boolean` | `false` | Whether to display the icon or not. |
-| `type` | `type` | `string` | `'submit'` | The default behavior of the button. May be "button", "reset", or "submit" (default). |
-| `value` | `value` | `string` | `''` | The value added to a form with the button's name when the button submits a form. |
-| `name` |  | `string` | `undefined` |  |
-| `form` |  | `HTMLFormElement` | `undefined` |  |
+| `name` | `name` | `string` | `undefined` | The HTML name to use in form submission. |
+| `disabled` | `disabled` | `boolean` | `undefined` | Whether or not the element is disabled. |
+| `type` | `type` | `string` | `'submit'` | A string indicating the form submission behavior of the element.<br>- submit: The element submits the form. This is the default value if the attribute is not specified, or if it is dynamically changed to an empty or invalid value. - reset: The element resets the form. - button: The element does nothing. |
+| `value` | `value` | `string` | `''` | The value of the button. When combined with a `name`, the submitting button's name/value will be added to the form. |
+| `form` |  | `HTMLFormElement` | `undefined` | The associated form element with which this element's value will submit. |
+| `labels` |  | `NodeList` | `undefined` | The labels this element is associated with. |
 
 <!-- mdformat on(autogenerated might break rendering in catalog) -->
 
@@ -756,17 +757,18 @@ Token                               | Default value
 
 | Property | Attribute | Type | Default | Description |
 | --- | --- | --- | --- | --- |
-| `disabled` | `disabled` | `boolean` | `false` | Whether or not the button is disabled. |
 | `softDisabled` | `soft-disabled` | `boolean` | `false` | Whether or not the button is "soft-disabled" (disabled but still focusable).<br>Use 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. |
 | `href` | `href` | `string` | `''` | The URL that the link button points to. |
 | `download` | `download` | `string` | `''` | The filename to use when downloading the linked resource. If not specified, the browser will determine a filename. This is only applicable when the button is used as a link (`href` is set). |
-| `target` | `target` | `string` | `''` | Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab. |
+| `target` | `target` | `"" \| "_blank" \| "_parent" \| "_self" \| "_top"` | `''` | Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab. |
 | `trailingIcon` | `trailing-icon` | `boolean` | `false` | Whether to render the icon at the inline end of the label rather than the inline start.<br>_Note:_ Link buttons cannot have trailing icons. |
 | `hasIcon` | `has-icon` | `boolean` | `false` | Whether to display the icon or not. |
-| `type` | `type` | `string` | `'submit'` | The default behavior of the button. May be "button", "reset", or "submit" (default). |
-| `value` | `value` | `string` | `''` | The value added to a form with the button's name when the button submits a form. |
-| `name` |  | `string` | `undefined` |  |
-| `form` |  | `HTMLFormElement` | `undefined` |  |
+| `name` | `name` | `string` | `undefined` | The HTML name to use in form submission. |
+| `disabled` | `disabled` | `boolean` | `undefined` | Whether or not the element is disabled. |
+| `type` | `type` | `string` | `'submit'` | A string indicating the form submission behavior of the element.<br>- submit: The element submits the form. This is the default value if the attribute is not specified, or if it is dynamically changed to an empty or invalid value. - reset: The element resets the form. - button: The element does nothing. |
+| `value` | `value` | `string` | `''` | The value of the button. When combined with a `name`, the submitting button's name/value will be added to the form. |
+| `form` |  | `HTMLFormElement` | `undefined` | The associated form element with which this element's value will submit. |
+| `labels` |  | `NodeList` | `undefined` | The labels this element is associated with. |
 
 <!-- mdformat on(autogenerated might break rendering in catalog) -->
 
@@ -778,17 +780,18 @@ Token                               | Default value
 
 | Property | Attribute | Type | Default | Description |
 | --- | --- | --- | --- | --- |
-| `disabled` | `disabled` | `boolean` | `false` | Whether or not the button is disabled. |
 | `softDisabled` | `soft-disabled` | `boolean` | `false` | Whether or not the button is "soft-disabled" (disabled but still focusable).<br>Use 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. |
 | `href` | `href` | `string` | `''` | The URL that the link button points to. |
 | `download` | `download` | `string` | `''` | The filename to use when downloading the linked resource. If not specified, the browser will determine a filename. This is only applicable when the button is used as a link (`href` is set). |
-| `target` | `target` | `string` | `''` | Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab. |
+| `target` | `target` | `"" \| "_blank" \| "_parent" \| "_self" \| "_top"` | `''` | Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab. |
 | `trailingIcon` | `trailing-icon` | `boolean` | `false` | Whether to render the icon at the inline end of the label rather than the inline start.<br>_Note:_ Link buttons cannot have trailing icons. |
 | `hasIcon` | `has-icon` | `boolean` | `false` | Whether to display the icon or not. |
-| `type` | `type` | `string` | `'submit'` | The default behavior of the button. May be "button", "reset", or "submit" (default). |
-| `value` | `value` | `string` | `''` | The value added to a form with the button's name when the button submits a form. |
-| `name` |  | `string` | `undefined` |  |
-| `form` |  | `HTMLFormElement` | `undefined` |  |
+| `name` | `name` | `string` | `undefined` | The HTML name to use in form submission. |
+| `disabled` | `disabled` | `boolean` | `undefined` | Whether or not the element is disabled. |
+| `type` | `type` | `string` | `'submit'` | A string indicating the form submission behavior of the element.<br>- submit: The element submits the form. This is the default value if the attribute is not specified, or if it is dynamically changed to an empty or invalid value. - reset: The element resets the form. - button: The element does nothing. |
+| `value` | `value` | `string` | `''` | The value of the button. When combined with a `name`, the submitting button's name/value will be added to the form. |
+| `form` |  | `HTMLFormElement` | `undefined` | The associated form element with which this element's value will submit. |
+| `labels` |  | `NodeList` | `undefined` | The labels this element is associated with. |
 
 <!-- mdformat on(autogenerated might break rendering in catalog) -->
 
@@ -800,17 +803,18 @@ Token                               | Default value
 
 | Property | Attribute | Type | Default | Description |
 | --- | --- | --- | --- | --- |
-| `disabled` | `disabled` | `boolean` | `false` | Whether or not the button is disabled. |
 | `softDisabled` | `soft-disabled` | `boolean` | `false` | Whether or not the button is "soft-disabled" (disabled but still focusable).<br>Use 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. |
 | `href` | `href` | `string` | `''` | The URL that the link button points to. |
 | `download` | `download` | `string` | `''` | The filename to use when downloading the linked resource. If not specified, the browser will determine a filename. This is only applicable when the button is used as a link (`href` is set). |
-| `target` | `target` | `string` | `''` | Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab. |
+| `target` | `target` | `"" \| "_blank" \| "_parent" \| "_self" \| "_top"` | `''` | Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab. |
 | `trailingIcon` | `trailing-icon` | `boolean` | `false` | Whether to render the icon at the inline end of the label rather than the inline start.<br>_Note:_ Link buttons cannot have trailing icons. |
 | `hasIcon` | `has-icon` | `boolean` | `false` | Whether to display the icon or not. |
-| `type` | `type` | `string` | `'submit'` | The default behavior of the button. May be "button", "reset", or "submit" (default). |
-| `value` | `value` | `string` | `''` | The value added to a form with the button's name when the button submits a form. |
-| `name` |  | `string` | `undefined` |  |
-| `form` |  | `HTMLFormElement` | `undefined` |  |
+| `name` | `name` | `string` | `undefined` | The HTML name to use in form submission. |
+| `disabled` | `disabled` | `boolean` | `undefined` | Whether or not the element is disabled. |
+| `type` | `type` | `string` | `'submit'` | A string indicating the form submission behavior of the element.<br>- submit: The element submits the form. This is the default value if the attribute is not specified, or if it is dynamically changed to an empty or invalid value. - reset: The element resets the form. - button: The element does nothing. |
+| `value` | `value` | `string` | `''` | The value of the button. When combined with a `name`, the submitting button's name/value will be added to the form. |
+| `form` |  | `HTMLFormElement` | `undefined` | The associated form element with which this element's value will submit. |
+| `labels` |  | `NodeList` | `undefined` | The labels this element is associated with. |
 
 <!-- mdformat on(autogenerated might break rendering in catalog) -->
 
@@ -822,17 +826,18 @@ Token                               | Default value
 
 | Property | Attribute | Type | Default | Description |
 | --- | --- | --- | --- | --- |
-| `disabled` | `disabled` | `boolean` | `false` | Whether or not the button is disabled. |
 | `softDisabled` | `soft-disabled` | `boolean` | `false` | Whether or not the button is "soft-disabled" (disabled but still focusable).<br>Use 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. |
 | `href` | `href` | `string` | `''` | The URL that the link button points to. |
 | `download` | `download` | `string` | `''` | The filename to use when downloading the linked resource. If not specified, the browser will determine a filename. This is only applicable when the button is used as a link (`href` is set). |
-| `target` | `target` | `string` | `''` | Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab. |
+| `target` | `target` | `"" \| "_blank" \| "_parent" \| "_self" \| "_top"` | `''` | Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab. |
 | `trailingIcon` | `trailing-icon` | `boolean` | `false` | Whether to render the icon at the inline end of the label rather than the inline start.<br>_Note:_ Link buttons cannot have trailing icons. |
 | `hasIcon` | `has-icon` | `boolean` | `false` | Whether to display the icon or not. |
-| `type` | `type` | `string` | `'submit'` | The default behavior of the button. May be "button", "reset", or "submit" (default). |
-| `value` | `value` | `string` | `''` | The value added to a form with the button's name when the button submits a form. |
-| `name` |  | `string` | `undefined` |  |
-| `form` |  | `HTMLFormElement` | `undefined` |  |
+| `name` | `name` | `string` | `undefined` | The HTML name to use in form submission. |
+| `disabled` | `disabled` | `boolean` | `undefined` | Whether or not the element is disabled. |
+| `type` | `type` | `string` | `'submit'` | A string indicating the form submission behavior of the element.<br>- submit: The element submits the form. This is the default value if the attribute is not specified, or if it is dynamically changed to an empty or invalid value. - reset: The element resets the form. - button: The element does nothing. |
+| `value` | `value` | `string` | `''` | The value of the button. When combined with a `name`, the submitting button's name/value will be added to the form. |
+| `form` |  | `HTMLFormElement` | `undefined` | The associated form element with which this element's value will submit. |
+| `labels` |  | `NodeList` | `undefined` | The labels this element is associated with. |
 
 <!-- mdformat on(autogenerated might break rendering in catalog) -->
 

diff --git a/docs/components/checkbox.md b/docs/components/checkbox.md
@@ -180,8 +180,13 @@ Token                                    | Default value
 | `indeterminate` | `indeterminate` | `boolean` | `false` | Whether or not the checkbox is indeterminate.<br>https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox#indeterminate_state_checkboxes |
 | `required` | `required` | `boolean` | `false` | When true, require the checkbox to be selected when participating in form submission.<br>https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox#validation |
 | `value` | `value` | `string` | `'on'` | The value of the checkbox that is submitted with a form when selected.<br>https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox#value |
-| `disabled` |  | `boolean` | `undefined` |  |
-| `name` |  | `string` | `undefined` |  |
+| `name` | `name` | `string` | `undefined` | The HTML name to use in form submission. |
+| `disabled` | `disabled` | `boolean` | `undefined` | Whether or not the element is disabled. |
+| `form` |  | `HTMLFormElement` | `undefined` | The associated form element with which this element's value will submit. |
+| `labels` |  | `NodeList` | `undefined` | The labels this element is associated with. |
+| `validity` |  | `ValidityState` | `undefined` | Returns a ValidityState object that represents the validity states of the element.<br>https://developer.mozilla.org/en-US/docs/Web/API/ValidityState |
+| `validationMessage` |  | `string` | `undefined` | Returns a validation error message or an empty string if the element is valid.<br>https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/validationMessage |
+| `willValidate` |  | `boolean` | `undefined` | Returns whether an element will successfully validate based on forms validation rules and constraints.<br>Disabled and readonly elements will not validate.<br>https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/willValidate |
 
 <!-- mdformat on(autogenerated might break rendering in catalog) -->
 
@@ -193,6 +198,9 @@ Token                                    | Default value
 | --- | --- | --- | --- |
 | `formResetCallback` | _None_ | `void` |  |
 | `formStateRestoreCallback` | `state` | `void` |  |
+| `checkValidity` | _None_ | `boolean` | Checks the element's constraint validation and returns true if the element is valid or false if not.<br>If invalid, this method will dispatch an `invalid` event.<br>https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/checkValidity |
+| `reportValidity` | _None_ | `boolean` | Checks the element's constraint validation and returns true if the element is valid or false if not.<br>If invalid, this method will dispatch a cancelable `invalid` event. If not canceled, a the current `validationMessage` will be reported to the user.<br>https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/reportValidity |
+| `setCustomValidity` | `error` | `void` | Sets the element's constraint validation error message. When set to a non-empty string, `validity.customError` will be true and `validationMessage` will display the provided error.<br>Use this method to customize error messages reported.<br>https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setCustomValidity |
 
 <!-- mdformat on(autogenerated might break rendering in catalog) -->