UNPKG

mdui

Version:

实现 material you 设计规范的 Web Components 组件库

1,101 lines 273 kB
{ "version": 1.1, "tags": [ { "name": "mdui-avatar", "description": "Avatar Component \n\n```html\n<mdui-avatar src=\"https://avatars githubusercontent com/u/3030330?s=40&v=4\"></mdui-avatar>\n```", "attributes": [ { "name": "src", "description": "URL of the avatar image.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/avatar#attributes-src" } ] }, { "name": "fit", "description": "Image resizing method, similar to the native CSS [`object-fit`](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit). Possible values:\n\n* `contain`: Scales the image to fit within the box while maintaining the aspect ratio. The image will be \"letterboxed\" if the aspect ratios do not match.\n* `cover`: Scales the image to fill the box while maintaining the aspect ratio. The image will be clipped if the aspect ratios do not match.\n* `fill`: Default. Scales the image to fill the box. The image will be stretched if the aspect ratios do not match.\n* `none`: No resizing.\n* `scale-down`: Scales as if `none` or `contain` were specified, choosing the smaller result.", "values": [ { "name": "contain", "description": "Scales the image to fit within the box while maintaining the aspect ratio. The image will be \"letterboxed\" if the aspect ratios do not match." }, { "name": "cover", "description": "Scales the image to fill the box while maintaining the aspect ratio. The image will be clipped if the aspect ratios do not match." }, { "name": "fill", "description": "Default. Scales the image to fill the box. The image will be stretched if the aspect ratios do not match." }, { "name": "none", "description": "No resizing." }, { "name": "scale-down", "description": "Scales as if `none` or `contain` were specified, choosing the smaller result." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/avatar#attributes-fit" } ] }, { "name": "icon", "description": "The Material Icons name for the avatar.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/avatar#attributes-icon" } ] }, { "name": "label", "description": "Text description of the avatar.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/avatar#attributes-label" } ] } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/avatar" }, { "name": "Github", "url": "https://github.com/zdhxiong/mdui/blob/v2/packages/mdui/src/components/avatar/index.ts" } ] }, { "name": "mdui-badge", "description": "Badge Component \n\n```html\n<mdui-badge>12</mdui-badge>\n```", "attributes": [ { "name": "variant", "description": "Defines the badge shape. Possible values:\n* `small`: A small badge without text.\n* `large`: A large badge with displayed text.", "values": [ { "name": "small", "description": "A small badge without text." }, { "name": "large", "description": "A large badge with displayed text." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/badge#attributes-variant" } ] } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/badge" }, { "name": "Github", "url": "https://github.com/zdhxiong/mdui/blob/v2/packages/mdui/src/components/badge/index.ts" } ] }, { "name": "mdui-bottom-app-bar", "description": "Bottom App Bar Component \n\n```html\n<mdui-bottom-app-bar>\n <mdui-button-icon icon=\"check_box--outlined\"></mdui-button-icon>\n <mdui-button-icon icon=\"edit--outlined\"></mdui-button-icon>\n <mdui-button-icon icon=\"mic_none--outlined\"></mdui-button-icon>\n <mdui-button-icon icon=\"image--outlined\"></mdui-button-icon>\n <div style=\"flex-grow: 1\"></div>\n <mdui-fab icon=\"add\"></mdui-fab>\n</mdui-bottom-app-bar>\n```", "attributes": [ { "name": "hide", "description": "Hides the bottom app bar when set.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/bottom-app-bar#attributes-hide" } ] }, { "name": "fab-detach", "description": "When set, detaches the [`<mdui-fab>`](https://www.mdui.org/en/docs/2/components/fab) from the bottom app bar. The [`<mdui-fab>`](https://www.mdui.org/en/docs/2/components/fab) remains on the page even after the app bar is hidden.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/bottom-app-bar#attributes-fab-detach" } ] }, { "name": "scroll-behavior", "description": "Defines the scroll behavior. Possible values:\n\n* `hide`: Hides when scrolling.", "values": [ { "name": "hide" }, { "name": "shrink" }, { "name": "elevate" } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/bottom-app-bar#attributes-scroll-behavior" } ] }, { "name": "scroll-target", "description": "The element that listens for scroll events. Accepts a CSS selector, DOM element, or [JQ object](https://www.mdui.org/en/docs/2/functions/jq). Defaults to `window`.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/bottom-app-bar#attributes-scroll-target" } ] }, { "name": "scroll-threshold", "description": "The scroll distance (in pixels) that triggers the scroll behavior.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/bottom-app-bar#attributes-scroll-threshold" } ] }, { "name": "order", "description": "Specifies the layout order within the [`<mdui-layout>`](https://www.mdui.org/en/docs/2/components/layout) component. Items are sorted in ascending order. The default value is `0`.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/bottom-app-bar#attributes-order" } ] } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/bottom-app-bar" }, { "name": "Github", "url": "https://github.com/zdhxiong/mdui/blob/v2/packages/mdui/src/components/bottom-app-bar/index.ts" } ] }, { "name": "mdui-button-icon", "description": "Icon Button Component \n\n```html\n<mdui-button-icon icon=\"search\"></mdui-button-icon>\n```", "attributes": [ { "name": "variant", "description": "Defines the icon button style. Possible values:\n* `standard`: For low-priority actions.\n* `filled`: Has the strongest visual effect, suitable for high-priority actions.\n* `tonal`: A visual effect between `filled` and `outlined`, suitable for medium to high-priority actions.\n* `outlined`: For medium-priority actions.", "values": [ { "name": "standard", "description": "For low-priority actions." }, { "name": "filled", "description": "Has the strongest visual effect, suitable for high-priority actions." }, { "name": "tonal", "description": "A visual effect between `filled` and `outlined`, suitable for medium to high-priority actions." }, { "name": "outlined", "description": "For medium-priority actions." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-variant" } ] }, { "name": "icon", "description": "Specifies the Material Icons name. Alternatively, use the default slot.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-icon" } ] }, { "name": "selected-icon", "description": "Specifies the Material Icons name when selected. Alternatively, use `slot=\"selected-icon\"`.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-selected-icon" } ] }, { "name": "selectable", "description": "Indicates if the button is selectable.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-selectable" } ] }, { "name": "selected", "description": "Indicates if the button is selected.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-selected" } ] }, { "name": "href", "description": "The URL for the hyperlink. If specified, the component renders as an `<a>` element and can use link-related attributes.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-href" } ] }, { "name": "download", "description": "Instructs the browser to treat the linked URL as a download.\n\n**Note**: This is only available when `href` is specified.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-download" } ] }, { "name": "target", "description": "Defines where to display the linked URL. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context or `_self` if no parent exists.\n* `_self`: Opens in the current browsing context. (Default).\n* `_top`: Opens in the topmost browsing context or `_self` if no ancestors exist.\n\n**Note**: This is only available when `href` is specified.", "values": [ { "name": "_blank", "description": "Opens in a new tab or window." }, { "name": "_parent", "description": "Opens in the parent browsing context or `_self` if no parent exists." }, { "name": "_self", "description": "Opens in the current browsing context. (Default)." }, { "name": "_top", "description": "Opens in the topmost browsing context or `_self` if no ancestors exist." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-target" } ] }, { "name": "rel", "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: Alternate versions of the current document.\n* `author`: Author of the current document or article.\n* `bookmark`: Permanent link for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: Link to context-sensitive help.\n* `license`: Indicates that the main content of the current document is covered by the copyright license described by the referenced document.\n* `me`: Indicates that the current document represents the person who owns the linked content.\n* `next`: Indicates that the current document is part of a series and the next document in the series is the referenced document.\n* `nofollow`: Indicates that the current document's original author or publisher does not endorse the referenced document.\n* `noreferrer`: No `Referer` header will be included. Also has the same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value).\n* `prev`: Indicates that the current document is part of a series and the previous document in the series is the referenced document.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Gives a tag (identified by the given address) that applies to the current document.\n\n**Note**: This is only available when `href` is specified.", "values": [ { "name": "alternate", "description": "Alternate versions of the current document." }, { "name": "author", "description": "Author of the current document or article." }, { "name": "bookmark", "description": "Permanent link for the nearest ancestor section." }, { "name": "external", "description": "The referenced document is not part of the same site as the current document." }, { "name": "help", "description": "Link to context-sensitive help." }, { "name": "license", "description": "Indicates that the main content of the current document is covered by the copyright license described by the referenced document." }, { "name": "me", "description": "Indicates that the current document represents the person who owns the linked content." }, { "name": "next", "description": "Indicates that the current document is part of a series and the next document in the series is the referenced document." }, { "name": "nofollow", "description": "Indicates that the current document's original author or publisher does not endorse the referenced document." }, { "name": "noreferrer", "description": "No `Referer` header will be included. Also has the same effect as `noopener`." }, { "name": "opener", "description": "Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value)." }, { "name": "prev", "description": "Indicates that the current document is part of a series and the previous document in the series is the referenced document." }, { "name": "search", "description": "Links to a resource that can be used to search through the current document and its related pages." }, { "name": "tag", "description": "Gives a tag (identified by the given address) that applies to the current document." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-rel" } ] }, { "name": "autofocus", "description": "Determines if the element should be focused when the page loads.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-autofocus" } ] }, { "name": "tabindex", "description": "Specifies the order in which the element receives focus when navigating with the Tab key.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-tabindex" } ] }, { "name": "disabled", "description": "Disables the element.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-disabled" } ] }, { "name": "loading", "description": "Indicates that the element is in a loading state.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-loading" } ] }, { "name": "name", "description": "The button's name, which is submitted with form data.\n\n**Note**: This is only available when `href` is not specified.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-name" } ] }, { "name": "value", "description": "The button's value, which is submitted with form data.\n\n**Note**: This is only available when `href` is not specified.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-value" } ] }, { "name": "type", "description": "Defines the button's default behavior. The default is `button`. Possible values:\n\n* `submit`: Submits the form data to the server.\n* `reset`: Resets all the controls to their initial values.\n* `button`: No default behavior, does nothing when pressed by default.\n\n**Note**: This is only available when `href` is not specified.", "values": [ { "name": "submit", "description": "Submits the form data to the server." }, { "name": "reset", "description": "Resets all the controls to their initial values." }, { "name": "button", "description": "No default behavior, does nothing when pressed by default." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-type" } ] }, { "name": "form", "description": "Associates the button with a `<form>` element. The value should be the `id` of a `<form>` in the same document. If not set, the button is associated with its parent `<form>`, if any.\n\nThis attribute allows button elements to be associated with `<form>`s anywhere in the document, not just inside a `<form>`.\n\n**Note**: Only available when `href` is not specified.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-form" } ] }, { "name": "formaction", "description": "Specifies the URL that processes the button's submitted information. Overrides the `action` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-formaction" } ] }, { "name": "formenctype", "description": "Specifies the form data encoding method. Possible values:\n\n* `application/x-www-form-urlencoded`: Default if the attribute is not used.\n* `multipart/form-data`: Used for `<input>` elements with `type` set to `file`.\n* `text/plain`: For debugging, not for real form submission.\n\nOverrides the `enctype` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.", "values": [ { "name": "application/x-www-form-urlencoded", "description": "Default if the attribute is not used." }, { "name": "multipart/form-data", "description": "Used for `<input>` elements with `type` set to `file`." }, { "name": "text/plain", "description": "For debugging, not for real form submission." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-formenctype" } ] }, { "name": "formmethod", "description": "Specifies the HTTP method for form submission. Possible values:\n\n* `post`: Form data included in HTTP request body.\n* `get`: Form data appended to `action` URL.\n\nOverrides the `method` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.", "values": [ { "name": "post", "description": "Form data included in HTTP request body." }, { "name": "get", "description": "Form data appended to `action` URL." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-formmethod" } ] }, { "name": "formnovalidate", "description": "Specifies that the form should not be validated on submission. Overrides the `novalidate` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-formnovalidate" } ] }, { "name": "formtarget", "description": "Specifies where to display the form submission response. Possible values:\n\n* `_self`: Current browsing context. (Default).\n* `_blank`: New tab or window.\n* `_parent`: Parent browsing context or `_self` if no parent.\n* `_top`: Topmost browsing context or `_self` if no ancestors.\n\nOverrides the `target` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.", "values": [ { "name": "_self", "description": "Current browsing context. (Default)." }, { "name": "_blank", "description": "New tab or window." }, { "name": "_parent", "description": "Parent browsing context or `_self` if no parent." }, { "name": "_top", "description": "Topmost browsing context or `_self` if no ancestors." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon#attributes-formtarget" } ] } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button-icon" }, { "name": "Github", "url": "https://github.com/zdhxiong/mdui/blob/v2/packages/mdui/src/components/button-icon/index.ts" } ] }, { "name": "mdui-button", "description": "Button Component \n\n```html\n<mdui-button>Button</mdui-button>\n```", "attributes": [ { "name": "variant", "description": "Defines the button style. Possible values:\n* `elevated`: A shadowed button for visual distinction.\n* `filled`: Used for final actions like 'Save' or 'Confirm'.\n* `tonal`: A mix between `filled` and `outlined`, suitable for medium to high-priority actions.\n* `outlined`: A bordered button for medium-priority and secondary actions.\n* `text`: A text button for low-priority actions.", "values": [ { "name": "elevated", "description": "A shadowed button for visual distinction." }, { "name": "filled", "description": "Used for final actions like 'Save' or 'Confirm'." }, { "name": "tonal", "description": "A mix between `filled` and `outlined`, suitable for medium to high-priority actions." }, { "name": "outlined", "description": "A bordered button for medium-priority and secondary actions." }, { "name": "text", "description": "A text button for low-priority actions." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-variant" } ] }, { "name": "full-width", "description": "If set, the button will fill the width of its parent element.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-full-width" } ] }, { "name": "icon", "description": "Specifies the Material Icons name on the left. Alternatively, use `slot=\"icon\"`.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-icon" } ] }, { "name": "end-icon", "description": "Specifies the Material Icons name on the right. Alternatively, use `slot=\"end-icon\"`.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-end-icon" } ] }, { "name": "href", "description": "The URL for the hyperlink. If provided, the component is rendered as an `<a>` element and can use link-related attributes.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-href" } ] }, { "name": "download", "description": "Instructs the browser to download the linked URL.\n\n**Note**: This is only available when `href` is specified.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-download" } ] }, { "name": "target", "description": "Defines where to open the linked URL. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context or `_self` if no parent.\n* `_self`: Opens in the current browsing context. (Default).\n* `_top`: Opens in the topmost browsing context or `_self` if no ancestors.\n\n**Note**: This is only available when `href` is specified.", "values": [ { "name": "_blank", "description": "Opens in a new tab or window." }, { "name": "_parent", "description": "Opens in the parent browsing context or `_self` if no parent." }, { "name": "_self", "description": "Opens in the current browsing context. (Default)." }, { "name": "_top", "description": "Opens in the topmost browsing context or `_self` if no ancestors." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-target" } ] }, { "name": "rel", "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: Alternate versions of the current document.\n* `author`: The author of the current document or article.\n* `bookmark`: The permalink for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: A link to context-sensitive help.\n* `license`: Indicates that the main content of the current document is covered by the copyright license described by the referenced document.\n* `me`: Indicates that the current document represents the person who owns the linked content.\n* `next`: Indicates that the current document is part of a series and the next document in the series is the referenced document.\n* `nofollow`: Indicates that the current document's original author or publisher does not endorse the referenced document.\n* `noreferrer`: No `Referer` header will be included. Also has the same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value).\n* `prev`: Indicates that the current document is part of a series and the previous document in the series is the referenced document.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Gives a tag (identified by the given address) that applies to the current document.\n\n**Note**: This is only available when `href` is specified.", "values": [ { "name": "alternate", "description": "Alternate versions of the current document." }, { "name": "author", "description": "The author of the current document or article." }, { "name": "bookmark", "description": "The permalink for the nearest ancestor section." }, { "name": "external", "description": "The referenced document is not part of the same site as the current document." }, { "name": "help", "description": "A link to context-sensitive help." }, { "name": "license", "description": "Indicates that the main content of the current document is covered by the copyright license described by the referenced document." }, { "name": "me", "description": "Indicates that the current document represents the person who owns the linked content." }, { "name": "next", "description": "Indicates that the current document is part of a series and the next document in the series is the referenced document." }, { "name": "nofollow", "description": "Indicates that the current document's original author or publisher does not endorse the referenced document." }, { "name": "noreferrer", "description": "No `Referer` header will be included. Also has the same effect as `noopener`." }, { "name": "opener", "description": "Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value)." }, { "name": "prev", "description": "Indicates that the current document is part of a series and the previous document in the series is the referenced document." }, { "name": "search", "description": "Links to a resource that can be used to search through the current document and its related pages." }, { "name": "tag", "description": "Gives a tag (identified by the given address) that applies to the current document." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-rel" } ] }, { "name": "autofocus", "description": "Specifies that the element should be focused when the page loads.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-autofocus" } ] }, { "name": "tabindex", "description": "Defines the order in which the element receives focus when navigating with the Tab key.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-tabindex" } ] }, { "name": "disabled", "description": "Disables the element.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-disabled" } ] }, { "name": "loading", "description": "Indicates that the element is in a loading state.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-loading" } ] }, { "name": "name", "description": "The button's name, which is submitted with form data.\n\n**Note**: This is only available when `href` is not specified.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-name" } ] }, { "name": "value", "description": "The button's value, which is submitted with form data.\n\n**Note**: This is only available when `href` is not specified.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-value" } ] }, { "name": "type", "description": "Defines the button's default behavior. The default is `button`. Possible values:\n\n* `submit`: Submits the form data to the server.\n* `reset`: Resets all the controls to their initial values.\n* `button`: No default behavior, does nothing when pressed by default.\n\n**Note**: This is only available when `href` is not specified.", "values": [ { "name": "submit", "description": "Submits the form data to the server." }, { "name": "reset", "description": "Resets all the controls to their initial values." }, { "name": "button", "description": "No default behavior, does nothing when pressed by default." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-type" } ] }, { "name": "form", "description": "Associates the button with a `<form>` element. The value should be the `id` of a `<form>` in the same document. If not set, the button is associated with its parent `<form>`, if any.\n\nThis attribute allows button elements to be associated with `<form>`s anywhere in the document, not just inside a `<form>`.\n\n**Note**: Only available when `href` is not specified.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-form" } ] }, { "name": "formaction", "description": "Specifies the URL that processes the button's submitted information. Overrides the `action` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-formaction" } ] }, { "name": "formenctype", "description": "Specifies the form data encoding method. Possible values:\n\n* `application/x-www-form-urlencoded`: Default if the attribute is not used.\n* `multipart/form-data`: Used for `<input>` elements with `type` set to `file`.\n* `text/plain`: For debugging, not for real form submission.\n\nOverrides the `enctype` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.", "values": [ { "name": "application/x-www-form-urlencoded", "description": "Default if the attribute is not used." }, { "name": "multipart/form-data", "description": "Used for `<input>` elements with `type` set to `file`." }, { "name": "text/plain", "description": "For debugging, not for real form submission." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-formenctype" } ] }, { "name": "formmethod", "description": "Specifies the HTTP method for form submission. Possible values:\n\n* `post`: Form data included in HTTP request body.\n* `get`: Form data appended to `action` URL.\n\nOverrides the `method` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.", "values": [ { "name": "post", "description": "Form data included in HTTP request body." }, { "name": "get", "description": "Form data appended to `action` URL." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-formmethod" } ] }, { "name": "formnovalidate", "description": "Specifies that the form should not be validated on submission. Overrides the `novalidate` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-formnovalidate" } ] }, { "name": "formtarget", "description": "Specifies where to display the form submission response. Possible values:\n\n* `_self`: Current browsing context. (Default).\n* `_blank`: New tab or window.\n* `_parent`: Parent browsing context or `_self` if no parent.\n* `_top`: Topmost browsing context or `_self` if no ancestors.\n\nOverrides the `target` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.", "values": [ { "name": "_self", "description": "Current browsing context. (Default)." }, { "name": "_blank", "description": "New tab or window." }, { "name": "_parent", "description": "Parent browsing context or `_self` if no parent." }, { "name": "_top", "description": "Topmost browsing context or `_self` if no ancestors." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button#attributes-formtarget" } ] } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/button" }, { "name": "Github", "url": "https://github.com/zdhxiong/mdui/blob/v2/packages/mdui/src/components/button/index.ts" } ] }, { "name": "mdui-card", "description": "Card Component \n\n```html\n<mdui-card>card content</mdui-card>\n```", "attributes": [ { "name": "variant", "description": "Defines the card style. Possible values:\n* `elevated`: Shadowed, providing more visual separation from the background than `filled`, but less than `outlined`.\n* `filled`: Provides minimal visual separation from the background.\n* `outlined`: Bordered, providing maximum visual separation from the background.", "values": [ { "name": "elevated", "description": "Shadowed, providing more visual separation from the background than `filled`, but less than `outlined`." }, { "name": "filled", "description": "Provides minimal visual separation from the background." }, { "name": "outlined", "description": "Bordered, providing maximum visual separation from the background." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/card#attributes-variant" } ] }, { "name": "clickable", "description": "Makes the card clickable. When set, a mouse hover effect and click ripple effect are added.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/card#attributes-clickable" } ] }, { "name": "disabled", "description": "Disables the card.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/card#attributes-disabled" } ] }, { "name": "href", "description": "The URL for the hyperlink. If specified, the component renders as an `<a>` element and can use link-related attributes.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/card#attributes-href" } ] }, { "name": "download", "description": "Instructs the browser to treat the linked URL as a download.\n\n**Note**: This is only available when `href` is specified.", "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/card#attributes-download" } ] }, { "name": "target", "description": "Defines where to display the linked URL. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context or `_self` if no parent exists.\n* `_self`: Opens in the current browsing context. (Default).\n* `_top`: Opens in the topmost browsing context or `_self` if no ancestors exist.\n\n**Note**: This is only available when `href` is specified.", "values": [ { "name": "_blank", "description": "Opens in a new tab or window." }, { "name": "_parent", "description": "Opens in the parent browsing context or `_self` if no parent exists." }, { "name": "_self", "description": "Opens in the current browsing context. (Default)." }, { "name": "_top", "description": "Opens in the topmost browsing context or `_self` if no ancestors exist." } ], "references": [ { "name": "Docs", "url": "https://www.mdui.org/en/docs/2/components/card#attributes-target" } ] }, { "name": "rel", "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: Alternate versions of the current document.\n* `author`: Author of the current document or article.\n* `bookmark`: Permanent link for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: Link to context-sensitive help.\n* `license`: Indicates that the main content of the current document is covered by the copyright license described by the referenced document.\n* `me`: Indicates that the current document represents the person who owns the linked content.\n* `next`: Indicates that the current document is part of a series and the next document in the series is the referenced document.\n* `nofollow`: Indicates that the current document's original author or publisher does not endorse the referenced document.\n* `noreferrer`: No `Referer` header will be included. Also has the same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value).\n* `prev`: Indicates that the current document is part of a series and the previous document in the series is the referenced document.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Gives a tag (identified by the given address) that applies to the current document.\n\n**Note**: This is only available when `href` is specified.", "values": [ { "name": "alternate", "description": "Alternate versions of the current document." }, { "name": "author", "description": "Author of the current document or article." }, { "name": "bookmark", "description": "Permanent link for the nearest ancestor section." }, { "name": "external", "description": "The referenced document is not part of the same site as the current document." }, { "name": "help", "description": "Link to context-sensitive help." }, { "name": "license", "description": "Indicates that the main content of the current document is covered by the copyright license described by the referenced document." }, { "name": "me", "description": "Indicates that the current document represents the person who owns the linked content." }, { "name": "next", "description": "Indicates that the current document is part of a series and the next document in the series is the