You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/components/button.md
+55-55
Original file line number
Diff line number
Diff line change
@@ -710,17 +710,17 @@ Token | Default value
710
710
711
711
<!-- mdformat off(autogenerated might break rendering in catalog) -->
712
712
713
-
Property | Attribute | Type | Default | Description
714
-
--- | --- | --- | --- | ---
715
-
`disabled` | `disabled` | `boolean` | `false` | Whether or not the button is disabled.
716
-
`href` | `href` | `string` | `''` | The URL that the link button points to.
717
-
`target` | `target` | `string` | `''` | Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab.
718
-
`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.
719
-
`hasIcon` | `has-icon` | `boolean` | `false` | Whether to display the icon or not.
720
-
`type` | `type` | `string` | `'submit'` |
721
-
`value` | `value` | `string` | `''` |
722
-
`name` | | `string` | `undefined` |
723
-
`form` | | `HTMLFormElement` | `undefined` |
713
+
|Property | Attribute | Type | Default | Description|
714
+
|--- | --- | --- | --- | ---|
715
+
|`disabled`|`disabled`|`boolean`|`false`| Whether or not the button is disabled.|
716
+
|`href`|`href`|`string`|`''`| The URL that the link button points to.|
717
+
|`target`|`target`|`string`|`''`| Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab.|
718
+
|`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.|
719
+
|`hasIcon`|`has-icon`|`boolean`|`false`| Whether to display the icon or not.|
720
+
|`type`|`type`|`string`|`'submit'`| The default behavior of the button. May be "text", "reset", or "submit" (default).|
721
+
|`value`|`value`|`string`|`''`| The value added to a form with the button's name when the button submits a form.|
722
+
|`name`||`string`|`undefined`||
723
+
|`form`||`HTMLFormElement`|`undefined`||
724
724
725
725
<!-- mdformat on(autogenerated might break rendering in catalog) -->
<!-- mdformat off(autogenerated might break rendering in catalog) -->
732
732
733
-
Property | Attribute | Type | Default | Description
734
-
--- | --- | --- | --- | ---
735
-
`disabled` | `disabled` | `boolean` | `false` | Whether or not the button is disabled.
736
-
`href` | `href` | `string` | `''` | The URL that the link button points to.
737
-
`target` | `target` | `string` | `''` | Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab.
738
-
`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.
739
-
`hasIcon` | `has-icon` | `boolean` | `false` | Whether to display the icon or not.
740
-
`type` | `type` | `string` | `'submit'` |
741
-
`value` | `value` | `string` | `''` |
742
-
`name` | | `string` | `undefined` |
743
-
`form` | | `HTMLFormElement` | `undefined` |
733
+
|Property | Attribute | Type | Default | Description|
734
+
|--- | --- | --- | --- | ---|
735
+
|`disabled`|`disabled`|`boolean`|`false`| Whether or not the button is disabled.|
736
+
|`href`|`href`|`string`|`''`| The URL that the link button points to.|
737
+
|`target`|`target`|`string`|`''`| Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab.|
738
+
|`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.|
739
+
|`hasIcon`|`has-icon`|`boolean`|`false`| Whether to display the icon or not.|
740
+
|`type`|`type`|`string`|`'submit'`| The default behavior of the button. May be "text", "reset", or "submit" (default).|
741
+
|`value`|`value`|`string`|`''`| The value added to a form with the button's name when the button submits a form.|
742
+
|`name`||`string`|`undefined`||
743
+
|`form`||`HTMLFormElement`|`undefined`||
744
744
745
745
<!-- mdformat on(autogenerated might break rendering in catalog) -->
<!-- mdformat off(autogenerated might break rendering in catalog) -->
752
752
753
-
Property | Attribute | Type | Default | Description
754
-
--- | --- | --- | --- | ---
755
-
`disabled` | `disabled` | `boolean` | `false` | Whether or not the button is disabled.
756
-
`href` | `href` | `string` | `''` | The URL that the link button points to.
757
-
`target` | `target` | `string` | `''` | Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab.
758
-
`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.
759
-
`hasIcon` | `has-icon` | `boolean` | `false` | Whether to display the icon or not.
760
-
`type` | `type` | `string` | `'submit'` |
761
-
`value` | `value` | `string` | `''` |
762
-
`name` | | `string` | `undefined` |
763
-
`form` | | `HTMLFormElement` | `undefined` |
753
+
|Property | Attribute | Type | Default | Description|
754
+
|--- | --- | --- | --- | ---|
755
+
|`disabled`|`disabled`|`boolean`|`false`| Whether or not the button is disabled.|
756
+
|`href`|`href`|`string`|`''`| The URL that the link button points to.|
757
+
|`target`|`target`|`string`|`''`| Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab.|
758
+
|`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.|
759
+
|`hasIcon`|`has-icon`|`boolean`|`false`| Whether to display the icon or not.|
760
+
|`type`|`type`|`string`|`'submit'`| The default behavior of the button. May be "text", "reset", or "submit" (default).|
761
+
|`value`|`value`|`string`|`''`| The value added to a form with the button's name when the button submits a form.|
762
+
|`name`||`string`|`undefined`||
763
+
|`form`||`HTMLFormElement`|`undefined`||
764
764
765
765
<!-- mdformat on(autogenerated might break rendering in catalog) -->
<!-- mdformat off(autogenerated might break rendering in catalog) -->
772
772
773
-
Property | Attribute | Type | Default | Description
774
-
--- | --- | --- | --- | ---
775
-
`disabled` | `disabled` | `boolean` | `false` | Whether or not the button is disabled.
776
-
`href` | `href` | `string` | `''` | The URL that the link button points to.
777
-
`target` | `target` | `string` | `''` | Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab.
778
-
`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.
779
-
`hasIcon` | `has-icon` | `boolean` | `false` | Whether to display the icon or not.
780
-
`type` | `type` | `string` | `'submit'` |
781
-
`value` | `value` | `string` | `''` |
782
-
`name` | | `string` | `undefined` |
783
-
`form` | | `HTMLFormElement` | `undefined` |
773
+
|Property | Attribute | Type | Default | Description|
774
+
|--- | --- | --- | --- | ---|
775
+
|`disabled`|`disabled`|`boolean`|`false`| Whether or not the button is disabled.|
776
+
|`href`|`href`|`string`|`''`| The URL that the link button points to.|
777
+
|`target`|`target`|`string`|`''`| Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab.|
778
+
|`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.|
779
+
|`hasIcon`|`has-icon`|`boolean`|`false`| Whether to display the icon or not.|
780
+
|`type`|`type`|`string`|`'submit'`| The default behavior of the button. May be "text", "reset", or "submit" (default).|
781
+
|`value`|`value`|`string`|`''`| The value added to a form with the button's name when the button submits a form.|
782
+
|`name`||`string`|`undefined`||
783
+
|`form`||`HTMLFormElement`|`undefined`||
784
784
785
785
<!-- mdformat on(autogenerated might break rendering in catalog) -->
<!-- mdformat off(autogenerated might break rendering in catalog) -->
792
792
793
-
Property | Attribute | Type | Default | Description
794
-
--- | --- | --- | --- | ---
795
-
`disabled` | `disabled` | `boolean` | `false` | Whether or not the button is disabled.
796
-
`href` | `href` | `string` | `''` | The URL that the link button points to.
797
-
`target` | `target` | `string` | `''` | Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab.
798
-
`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.
799
-
`hasIcon` | `has-icon` | `boolean` | `false` | Whether to display the icon or not.
800
-
`type` | `type` | `string` | `'submit'` |
801
-
`value` | `value` | `string` | `''` |
802
-
`name` | | `string` | `undefined` |
803
-
`form` | | `HTMLFormElement` | `undefined` |
793
+
|Property | Attribute | Type | Default | Description|
794
+
|--- | --- | --- | --- | ---|
795
+
|`disabled`|`disabled`|`boolean`|`false`| Whether or not the button is disabled.|
796
+
|`href`|`href`|`string`|`''`| The URL that the link button points to.|
797
+
|`target`|`target`|`string`|`''`| Where to display the linked `href` URL for a link button. Common options include `_blank` to open in a new tab.|
798
+
|`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.|
799
+
|`hasIcon`|`has-icon`|`boolean`|`false`| Whether to display the icon or not.|
800
+
|`type`|`type`|`string`|`'submit'`| The default behavior of the button. May be "text", "reset", or "submit" (default).|
801
+
|`value`|`value`|`string`|`''`| The value added to a form with the button's name when the button submits a form.|
802
+
|`name`||`string`|`undefined`||
803
+
|`form`||`HTMLFormElement`|`undefined`||
804
804
805
805
<!-- mdformat on(autogenerated might break rendering in catalog) -->
Copy file name to clipboardExpand all lines: docs/components/checkbox.md
+24-18
Original file line number
Diff line number
Diff line change
@@ -168,37 +168,43 @@ Token | Default value
168
168
169
169
## API
170
170
171
+
171
172
### MdCheckbox <code><md-checkbox></code>
172
173
173
174
#### Properties
174
175
175
176
<!-- mdformat off(autogenerated might break rendering in catalog) -->
176
177
177
-
Property | Attribute | Type | Default | Description
178
-
--- | --- | --- | --- | ---
179
-
`checked` | `checked` | `boolean` | `false` | Whether or not the checkbox is selected.
180
-
`disabled` | `disabled` | `boolean` | `false` | Whether or not the checkbox is disabled.
181
-
`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
182
-
`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
183
-
`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
|`checked`|`checked`|`boolean`|`false`| Whether or not the checkbox is selected. |
181
+
|`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|
182
+
|`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|
183
+
|`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|
184
+
|`disabled`||`boolean`|`undefined`||
185
+
|`name`||`string`|`undefined`||
190
186
191
187
<!-- mdformat on(autogenerated might break rendering in catalog) -->
192
188
193
189
#### Methods
194
190
195
191
<!-- mdformat off(autogenerated might break rendering in catalog) -->
196
192
197
-
Method | Parameters | Returns | Description
198
-
--- | --- | --- | ---
199
-
`checkValidity` | _None_ | `boolean` | Checks the checkbox's native validation and returns whether or not the element is valid.<br>If invalid, this method will dispatch the `invalid` event.<br>https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/checkValidity
200
-
`reportValidity` | _None_ | `boolean` | Checks the checkbox's native validation and returns whether or not the element is valid.<br>If invalid, this method will dispatch the `invalid` event.<br>The `validationMessage` is reported to the user by the browser. Use `setCustomValidity()` to customize the `validationMessage`.<br>https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/reportValidity
201
-
`setCustomValidity` | `error` | `void` | Sets the checkbox's native validation error message. This is used to customize `validationMessage`.<br>When the error is not an empty string, the checkbox is considered invalid and `validity.customError` will be true.<br>https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setCustomValidity
193
+
| Method | Parameters | Returns | Description |
194
+
| --- | --- | --- | --- |
195
+
|`formResetCallback`|_None_|`void`||
196
+
|`formStateRestoreCallback`|`state`|`void`||
197
+
198
+
<!-- mdformat on(autogenerated might break rendering in catalog) -->
199
+
200
+
#### Events
201
+
202
+
<!-- mdformat off(autogenerated might break rendering in catalog) -->
203
+
204
+
| Event | Type |[Bubbles](https://developer.mozilla.org/en-US/docs/Web/API/Event/bubbles)|[Composed](https://developer.mozilla.org/en-US/docs/Web/API/Event/composed)| Description |
205
+
| --- | --- | --- | --- | --- |
206
+
|`change`|`Event`| Yes | No | The native `change` event on [`<input>`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event)|
207
+
|`input`|`InputEvent`| Yes | Yes | The native `input` event on [`<input>`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/input_event)|
202
208
203
209
<!-- mdformat on(autogenerated might break rendering in catalog) -->
0 commit comments