UNPKG

mdui

Version:

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

1,394 lines (1,391 loc) 156 kB
import React from 'react'; import { JQ } from '@mdui/jq'; type HTMLElementProps = React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>; declare global { namespace JSX { interface IntrinsicElements { /** * 头像组件 * * ```html * <mdui-avatar src="https://avatars githubusercontent com/u/3030330?s=40&v=4"></mdui-avatar> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/avatar */ 'mdui-avatar': { /** * 头像图片的 URL 地址 * @see https://www.mdui.org/zh-cn/docs/2/components/avatar#attributes-src */ 'src'?: string; /** * 图片如何适应容器框,与原生的 [`object-fit`](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) 属性相同。可选值包括: * * * `contain`:保持图片原有尺寸比例,内容会被等比例缩放 * * `cover`:保持图片原有尺寸比例,但部分内容可能被剪切 * * `fill`:默认值,不保持图片原有尺寸比例,内容会被拉伸以填充整个容器 * * `none`:保留图片原有尺寸,内容不会被缩放或拉伸 * * `scale-down`:保持图片原有尺寸比例,内容尺寸与 `none` 或 `contain` 中较小的一个相同 * @see https://www.mdui.org/zh-cn/docs/2/components/avatar#attributes-fit */ 'fit'?: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down'; /** * 头像的 Material Icons 图标名 * @see https://www.mdui.org/zh-cn/docs/2/components/avatar#attributes-icon */ 'icon'?: string; /** * 头像的替代文本描述 * @see https://www.mdui.org/zh-cn/docs/2/components/avatar#attributes-label */ 'label'?: string; } & HTMLElementProps; /** * 徽标组件 * * ```html * <mdui-badge>12</mdui-badge> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/badge */ 'mdui-badge': { /** * 徽标的形状。可选值包括: * * * `small`:小型徽标,不显示文本 * * `large`:大型徽标,会显示文本 * @see https://www.mdui.org/zh-cn/docs/2/components/badge#attributes-variant */ 'variant'?: 'small' | 'large'; } & HTMLElementProps; /** * 底部应用栏组件 * * ```html * <mdui-bottom-app-bar> * <mdui-button-icon icon="check_box--outlined"></mdui-button-icon> * <mdui-button-icon icon="edit--outlined"></mdui-button-icon> * <mdui-button-icon icon="mic_none--outlined"></mdui-button-icon> * <mdui-button-icon icon="image--outlined"></mdui-button-icon> * <div style="flex-grow: 1"></div> * <mdui-fab icon="add"></mdui-fab> * </mdui-bottom-app-bar> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/bottom-app-bar */ 'mdui-bottom-app-bar': { /** * 是否隐藏 * @see https://www.mdui.org/zh-cn/docs/2/components/bottom-app-bar#attributes-hide */ 'hide'?: boolean; /** * 是否让底部应用栏中的 [`<mdui-fab>`](https://www.mdui.org/zh-cn/docs/2/components/fab) 组件脱离应用栏。如果为 `true`,则当应用栏隐藏后,[`<mdui-fab>`](https://www.mdui.org/zh-cn/docs/2/components/fab) 仍会停留在页面上 * @see https://www.mdui.org/zh-cn/docs/2/components/bottom-app-bar#attributes-fab-detach */ 'fab-detach'?: boolean; /** * 滚动行为。可选值为: * * * `hide`:滚动时隐藏 * @see https://www.mdui.org/zh-cn/docs/2/components/bottom-app-bar#attributes-scroll-behavior */ 'scroll-behavior'?: 'hide' | 'shrink' | 'elevate'; /** * 需要监听其滚动事件的元素。值可以是 CSS 选择器、DOM 元素、或 [JQ 对象](https://www.mdui.org/zh-cn/docs/2/functions/jq)。默认监听 `window` 的滚动事件 * @see https://www.mdui.org/zh-cn/docs/2/components/bottom-app-bar#attributes-scroll-target */ 'scroll-target'?: string | HTMLElement | JQ<HTMLElement>; /** * 在滚动多少距离之后触发滚动行为,单位为 `px` * @see https://www.mdui.org/zh-cn/docs/2/components/bottom-app-bar#attributes-scroll-threshold */ 'scroll-threshold'?: number; /** * 该组件在 [`<mdui-layout>`](https://www.mdui.org/zh-cn/docs/2/components/layout) 中的布局顺序,按从小到大排序。默认为 `0` * @see https://www.mdui.org/zh-cn/docs/2/components/bottom-app-bar#attributes-order */ 'order'?: number; } & HTMLElementProps; /** * 图标按钮组件 * * ```html * <mdui-button-icon icon="search"></mdui-button-icon> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon */ 'mdui-button-icon': { /** * 图标按钮的形状。可选值包括: * * * `standard`:适用于最低优先级的操作 * * `filled`:视觉效果强烈,适用于高优先级的操作 * * `tonal`:视觉效果介于 `filled` 和 `outlined` 之间,适用于中高优先级的操作 * * `outlined`:适用于中等优先级的操作 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-variant */ 'variant'?: 'standard' | 'filled' | 'tonal' | 'outlined'; /** * Material Icons 图标名。也可以通过 default slot 设置 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-icon */ 'icon'?: string; /** * 选中状态的 Material Icons 图标名。也可以通过 `slot="selected-icon"` 设置 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-selected-icon */ 'selected-icon'?: string; /** * 是否可选中 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-selectable */ 'selectable'?: boolean; /** * 是否已被选中 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-selected */ 'selected'?: boolean; /** * 链接的目标 URL。 * * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-href */ 'href'?: string; /** * 下载链接的目标。 * * **Note**:仅在设置了 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-download */ 'download'?: string; /** * 链接的打开方式。可选值包括: * * * `_blank`:在新窗口中打开链接 * * `_parent`:在父框架中打开链接 * * `_self`:默认。在当前框架中打开链接 * * `_top`:在整个窗口中打开链接 * * **Note**:仅在设置了 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-target */ 'target'?: '_blank' | '_parent' | '_self' | '_top'; /** * 当前文档与被链接文档之间的关系。可选值包括: * * * `alternate`:当前文档的替代版本 * * `author`:当前文档或文章的作者 * * `bookmark`:永久链接到最近的祖先章节 * * `external`:引用的文档与当前文档不在同一站点 * * `help`:链接到相关的帮助文档 * * `license`:当前文档的主要内容由被引用文件的版权许可覆盖 * * `me`:当前文档代表链接内容的所有者 * * `next`:当前文档是系列中的一部分,被引用的文档是系列的下一个文档 * * `nofollow`:当前文档的作者或发布者不认可被引用的文件 * * `noreferrer`:不包含 `Referer` 头。类似于 `noopener` 的效果 * * `opener`:如果超链接会创建一个顶级浏览上下文(即 `target` 属性值为 `_blank`),则创建一个辅助浏览上下文 * * `prev`:当前文档是系列的一部分,被引用的文档是系列的上一个文档 * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面 * * `tag`:提供一个适用于当前文档的标签(由给定地址识别) * * **Note**:仅在指定了 `href` 属性时可用。 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-rel */ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag'; /** * 是否在页面加载完成后自动获取焦点 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-autofocus */ 'autofocus'?: boolean; /** * 元素在使用 Tab 键切换焦点时的顺序 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-tabindex */ 'tabindex'?: number; /** * 是否禁用 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-disabled */ 'disabled'?: boolean; /** * 是否处于加载中状态 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-loading */ 'loading'?: boolean; /** * 按钮的名称,将与表单数据一起提交。 * * **Note**:仅在未设置 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-name */ 'name'?: string; /** * 按钮的初始值,将与表单数据一起提交。 * * **Note**:仅在未设置 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-value */ 'value'?: string; /** * 按钮的类型。默认类型为 `button`。可选类型包括: * * * `submit`:点击按钮会提交表单数据到服务器 * * `reset`:点击按钮会将表单中的所有字段重置为初始值 * * `button`:此类型的按钮没有默认行为 * * **Note**:仅在未指定 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-type */ 'type'?: 'submit' | 'reset' | 'button'; /** * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。 * * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。 * * **Note**:仅在未指定 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-form */ 'form'?: string; /** * 指定提交表单的 URL。 * * 如果指定了此属性,将覆盖 `<form>` 元素的 `action` 属性。 * * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formaction */ 'formaction'?: string; /** * 指定提交表单到服务器的内容类型。可选值包括: * * * `application/x-www-form-urlencoded`:未指定该属性时的默认值 * * `multipart/form-data`:当表单包含 `<input type="file">` 元素时使用 * * `text/plain`:HTML5 新增,用于调试 * * 如果指定了此属性,将覆盖 `<form>` 元素的 `enctype` 属性。 * * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formenctype */ 'formenctype'?: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain'; /** * 指定提交表单时使用的 HTTP 方法。可选值包括: * * * `post`:表单数据包含在表单内容中,发送到服务器 * * `get`:表单数据以 `?` 作为分隔符附加到表单的 URI 属性中,生成的 URI 发送到服务器。当表单没有副作用,并且仅包含 ASCII 字符时,使用此方法 * * 如果设置了此属性,将覆盖 `<form>` 元素的 `method` 属性。 * * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formmethod */ 'formmethod'?: 'post' | 'get'; /** * 如果设置了此属性,表单提交时将不执行表单验证。 * * 如果设置了此属性,将覆盖 `<form>` 元素的 `novalidate` 属性。 * * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formnovalidate */ 'formnovalidate'?: boolean; /** * 提交表单后接收到的响应应显示在何处。可选值包括: * * * `_self`:默认选项,在当前框架中打开 * * `_blank`:在新窗口中打开 * * `_parent`:在父框架中打开 * * `_top`:在整个窗口中打开 * * 如果设置了此属性,将覆盖 `<form>` 元素的 `target` 属性。 * * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formtarget */ 'formtarget'?: '_self' | '_blank' | '_parent' | '_top'; } & HTMLElementProps; /** * 按钮组件 * * ```html * <mdui-button>Button</mdui-button> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/button */ 'mdui-button': { /** * 按钮的形状。可选值包括: * * * `elevated`:带阴影的按钮,适用于需要将按钮与背景视觉分离的场景 * * `filled`:视觉效果强烈,适用于重要流程的最终操作,如“保存”、“确认”等 * * `tonal`:视觉效果介于 `filled` 和 `outlined` 之间,适用于中高优先级的操作,如流程中的“下一步” * * `outlined`:带边框的按钮,适用于中等优先级,且次要的操作,如“返回” * * `text`:文本按钮,适用于最低优先级的操作 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-variant */ 'variant'?: 'elevated' | 'filled' | 'tonal' | 'outlined' | 'text'; /** * 是否填满父元素宽度 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-full-width */ 'full-width'?: boolean; /** * 左侧的 Material Icons 图标名。也可以通过 `slot="icon"` 设置 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-icon */ 'icon'?: string; /** * 右侧的 Material Icons 图标名。也可以通过 `slot="end-icon"` 设置 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-end-icon */ 'end-icon'?: string; /** * 链接的目标 URL。 * * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-href */ 'href'?: string; /** * 下载链接的目标。 * * **Note**:仅在设置了 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-download */ 'download'?: string; /** * 链接的打开方式。可选值包括: * * * `_blank`:在新窗口中打开链接 * * `_parent`:在父框架中打开链接 * * `_self`:默认。在当前框架中打开链接 * * `_top`:在整个窗口中打开链接 * * **Note**:仅在设置了 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-target */ 'target'?: '_blank' | '_parent' | '_self' | '_top'; /** * 当前文档与被链接文档之间的关系。可选值包括: * * * `alternate`:当前文档的替代版本 * * `author`:当前文档或文章的作者 * * `bookmark`:永久链接到最近的祖先章节 * * `external`:引用的文档与当前文档不在同一站点 * * `help`:链接到相关的帮助文档 * * `license`:当前文档的主要内容由被引用文件的版权许可覆盖 * * `me`:当前文档代表链接内容的所有者 * * `next`:当前文档是系列中的一部分,被引用的文档是系列的下一个文档 * * `nofollow`:当前文档的作者或发布者不认可被引用的文件 * * `noreferrer`:不包含 `Referer` 头。类似于 `noopener` 的效果 * * `opener`:如果超链接会创建一个顶级浏览上下文(即 `target` 属性值为 `_blank`),则创建一个辅助浏览上下文 * * `prev`:当前文档是系列的一部分,被引用的文档是系列的上一个文档 * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面 * * `tag`:提供一个适用于当前文档的标签(由给定地址识别) * * **Note**:仅在指定了 `href` 属性时可用。 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-rel */ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag'; /** * 是否在页面加载完成后自动获取焦点 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-autofocus */ 'autofocus'?: boolean; /** * 元素在使用 Tab 键切换焦点时的顺序 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-tabindex */ 'tabindex'?: number; /** * 是否禁用 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-disabled */ 'disabled'?: boolean; /** * 是否处于加载中状态 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-loading */ 'loading'?: boolean; /** * 按钮的名称,将与表单数据一起提交。 * * **Note**:仅在未设置 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-name */ 'name'?: string; /** * 按钮的初始值,将与表单数据一起提交。 * * **Note**:仅在未设置 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-value */ 'value'?: string; /** * 按钮的类型。默认类型为 `button`。可选类型包括: * * * `submit`:点击按钮会提交表单数据到服务器 * * `reset`:点击按钮会将表单中的所有字段重置为初始值 * * `button`:此类型的按钮没有默认行为 * * **Note**:仅在未指定 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-type */ 'type'?: 'submit' | 'reset' | 'button'; /** * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。 * * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。 * * **Note**:仅在未指定 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-form */ 'form'?: string; /** * 指定提交表单的 URL。 * * 如果指定了此属性,将覆盖 `<form>` 元素的 `action` 属性。 * * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formaction */ 'formaction'?: string; /** * 指定提交表单到服务器的内容类型。可选值包括: * * * `application/x-www-form-urlencoded`:未指定该属性时的默认值 * * `multipart/form-data`:当表单包含 `<input type="file">` 元素时使用 * * `text/plain`:HTML5 新增,用于调试 * * 如果指定了此属性,将覆盖 `<form>` 元素的 `enctype` 属性。 * * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formenctype */ 'formenctype'?: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain'; /** * 指定提交表单时使用的 HTTP 方法。可选值包括: * * * `post`:表单数据包含在表单内容中,发送到服务器 * * `get`:表单数据以 `?` 作为分隔符附加到表单的 URI 属性中,生成的 URI 发送到服务器。当表单没有副作用,并且仅包含 ASCII 字符时,使用此方法 * * 如果设置了此属性,将覆盖 `<form>` 元素的 `method` 属性。 * * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formmethod */ 'formmethod'?: 'post' | 'get'; /** * 如果设置了此属性,表单提交时将不执行表单验证。 * * 如果设置了此属性,将覆盖 `<form>` 元素的 `novalidate` 属性。 * * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formnovalidate */ 'formnovalidate'?: boolean; /** * 提交表单后接收到的响应应显示在何处。可选值包括: * * * `_self`:默认选项,在当前框架中打开 * * `_blank`:在新窗口中打开 * * `_parent`:在父框架中打开 * * `_top`:在整个窗口中打开 * * 如果设置了此属性,将覆盖 `<form>` 元素的 `target` 属性。 * * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formtarget */ 'formtarget'?: '_self' | '_blank' | '_parent' | '_top'; } & HTMLElementProps; /** * 卡片组件 * * ```html * <mdui-card>card content</mdui-card> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/card */ 'mdui-card': { /** * 卡片的形状。可选值包括: * * * `elevated`:带阴影的卡片,与背景的视觉分离度较高 * * `filled`:带填充色的卡片,与背景的视觉分离度较低 * * `outlined`:带边框的卡片,与背景的视觉分离度最高 * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-variant */ 'variant'?: 'elevated' | 'filled' | 'outlined'; /** * 是否可点击。为 `true` 时,卡片将具有鼠标悬浮效果和点击涟漪效果 * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-clickable */ 'clickable'?: boolean; /** * 是否禁用 * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-disabled */ 'disabled'?: boolean; /** * 链接的目标 URL。 * * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。 * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-href */ 'href'?: string; /** * 下载链接的目标。 * * **Note**:仅在设置了 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-download */ 'download'?: string; /** * 链接的打开方式。可选值包括: * * * `_blank`:在新窗口中打开链接 * * `_parent`:在父框架中打开链接 * * `_self`:默认。在当前框架中打开链接 * * `_top`:在整个窗口中打开链接 * * **Note**:仅在设置了 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-target */ 'target'?: '_blank' | '_parent' | '_self' | '_top'; /** * 当前文档与被链接文档之间的关系。可选值包括: * * * `alternate`:当前文档的替代版本 * * `author`:当前文档或文章的作者 * * `bookmark`:永久链接到最近的祖先章节 * * `external`:引用的文档与当前文档不在同一站点 * * `help`:链接到相关的帮助文档 * * `license`:当前文档的主要内容由被引用文件的版权许可覆盖 * * `me`:当前文档代表链接内容的所有者 * * `next`:当前文档是系列中的一部分,被引用的文档是系列的下一个文档 * * `nofollow`:当前文档的作者或发布者不认可被引用的文件 * * `noreferrer`:不包含 `Referer` 头。类似于 `noopener` 的效果 * * `opener`:如果超链接会创建一个顶级浏览上下文(即 `target` 属性值为 `_blank`),则创建一个辅助浏览上下文 * * `prev`:当前文档是系列的一部分,被引用的文档是系列的上一个文档 * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面 * * `tag`:提供一个适用于当前文档的标签(由给定地址识别) * * **Note**:仅在指定了 `href` 属性时可用。 * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-rel */ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag'; /** * 是否在页面加载完成后自动获取焦点 * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-autofocus */ 'autofocus'?: boolean; /** * 元素在使用 Tab 键切换焦点时的顺序 * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-tabindex */ 'tabindex'?: number; } & HTMLElementProps; /** * 复选框组件 * * ```html * <mdui-checkbox>Checkbox</mdui-checkbox> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox */ 'mdui-checkbox': { /** * 是否为禁用状态 * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-disabled */ 'disabled'?: boolean; /** * 是否为选中状态 * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-checked */ 'checked'?: boolean; /** * 是否处于不确定状态 * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-indeterminate */ 'indeterminate'?: boolean; /** * 提交表单时,是否必须选中此复选框 * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-required */ 'required'?: boolean; /** * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。 * * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。 * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-form */ 'form'?: string; /** * 复选框名称,将与表单数据一起提交 * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-name */ 'name'?: string; /** * 复选框的值,将于表单数据一起提交 * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-value */ 'value'?: string; /** * 未选中状态的 Material Icons 图标名。也可以通过 `slot="unchecked-icon"` 设置 * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-unchecked-icon */ 'unchecked-icon'?: string; /** * 选中状态的 Material Icons 图标名。也可以通过 `slot="checked-icon"` 设置 * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-checked-icon */ 'checked-icon'?: string; /** * 不确定状态的 Material Icons 图标名。也可以通过 `slot="indeterminate-icon"` 设置 * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-indeterminate-icon */ 'indeterminate-icon'?: string; /** * 是否在页面加载完成后自动获取焦点 * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-autofocus */ 'autofocus'?: boolean; /** * 元素在使用 Tab 键切换焦点时的顺序 * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-tabindex */ 'tabindex'?: number; } & HTMLElementProps; /** * 纸片组件 * * ```html * <mdui-chip>Chip</mdui-chip> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/chip */ 'mdui-chip': { /** * 纸片的形状。可选值包括: * * * `assist`:用于显示与当前上下文相关的辅助操作,如在点餐页面提供分享、收藏等功能 * * `filter`:用于对内容进行筛选,如在搜索结果页过滤搜索结果 * * `input`:用于表示用户输入的信息片段,如在 Gmail 的“收件人”字段中的联系人 * * `suggestion`:用于提供动态生成的推荐信息,以简化用户操作,如在聊天应用中预测用户可能想发送的信息 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-variant */ 'variant'?: 'assist' | 'filter' | 'input' | 'suggestion'; /** * 是否显示阴影 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-elevated */ 'elevated'?: boolean; /** * 是否可选中 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-selectable */ 'selectable'?: boolean; /** * 是否已选中 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-selected */ 'selected'?: boolean; /** * 是否可删除。为 `true` 时,纸片右侧会显示删除图标 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-deletable */ 'deletable'?: boolean; /** * 左侧的 Material Icons 图标名。也可以通过 `slot="icon"` 设置 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-icon */ 'icon'?: string; /** * 选中状态下左侧的 Material Icons 图标名。也可以通过 `slot="selected-icon"` 设置 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-selected-icon */ 'selected-icon'?: string; /** * 右侧的 Material Icons 图标名。也可以通过 `slot="end-icon"` 设置 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-end-icon */ 'end-icon'?: string; /** * 可删除时,右侧删除图标的 Material Icons 图标名。也可以通过 `slot="delete-icon"` 设置 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-delete-icon */ 'delete-icon'?: string; /** * 链接的目标 URL。 * * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-href */ 'href'?: string; /** * 下载链接的目标。 * * **Note**:仅在设置了 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-download */ 'download'?: string; /** * 链接的打开方式。可选值包括: * * * `_blank`:在新窗口中打开链接 * * `_parent`:在父框架中打开链接 * * `_self`:默认。在当前框架中打开链接 * * `_top`:在整个窗口中打开链接 * * **Note**:仅在设置了 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-target */ 'target'?: '_blank' | '_parent' | '_self' | '_top'; /** * 当前文档与被链接文档之间的关系。可选值包括: * * * `alternate`:当前文档的替代版本 * * `author`:当前文档或文章的作者 * * `bookmark`:永久链接到最近的祖先章节 * * `external`:引用的文档与当前文档不在同一站点 * * `help`:链接到相关的帮助文档 * * `license`:当前文档的主要内容由被引用文件的版权许可覆盖 * * `me`:当前文档代表链接内容的所有者 * * `next`:当前文档是系列中的一部分,被引用的文档是系列的下一个文档 * * `nofollow`:当前文档的作者或发布者不认可被引用的文件 * * `noreferrer`:不包含 `Referer` 头。类似于 `noopener` 的效果 * * `opener`:如果超链接会创建一个顶级浏览上下文(即 `target` 属性值为 `_blank`),则创建一个辅助浏览上下文 * * `prev`:当前文档是系列的一部分,被引用的文档是系列的上一个文档 * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面 * * `tag`:提供一个适用于当前文档的标签(由给定地址识别) * * **Note**:仅在指定了 `href` 属性时可用。 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-rel */ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag'; /** * 是否在页面加载完成后自动获取焦点 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-autofocus */ 'autofocus'?: boolean; /** * 元素在使用 Tab 键切换焦点时的顺序 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-tabindex */ 'tabindex'?: number; /** * 是否禁用 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-disabled */ 'disabled'?: boolean; /** * 是否处于加载中状态 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-loading */ 'loading'?: boolean; /** * 按钮的名称,将与表单数据一起提交。 * * **Note**:仅在未设置 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-name */ 'name'?: string; /** * 按钮的初始值,将与表单数据一起提交。 * * **Note**:仅在未设置 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-value */ 'value'?: string; /** * 按钮的类型。默认类型为 `button`。可选类型包括: * * * `submit`:点击按钮会提交表单数据到服务器 * * `reset`:点击按钮会将表单中的所有字段重置为初始值 * * `button`:此类型的按钮没有默认行为 * * **Note**:仅在未指定 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-type */ 'type'?: 'submit' | 'reset' | 'button'; /** * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。 * * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。 * * **Note**:仅在未指定 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-form */ 'form'?: string; /** * 指定提交表单的 URL。 * * 如果指定了此属性,将覆盖 `<form>` 元素的 `action` 属性。 * * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-formaction */ 'formaction'?: string; /** * 指定提交表单到服务器的内容类型。可选值包括: * * * `application/x-www-form-urlencoded`:未指定该属性时的默认值 * * `multipart/form-data`:当表单包含 `<input type="file">` 元素时使用 * * `text/plain`:HTML5 新增,用于调试 * * 如果指定了此属性,将覆盖 `<form>` 元素的 `enctype` 属性。 * * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-formenctype */ 'formenctype'?: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain'; /** * 指定提交表单时使用的 HTTP 方法。可选值包括: * * * `post`:表单数据包含在表单内容中,发送到服务器 * * `get`:表单数据以 `?` 作为分隔符附加到表单的 URI 属性中,生成的 URI 发送到服务器。当表单没有副作用,并且仅包含 ASCII 字符时,使用此方法 * * 如果设置了此属性,将覆盖 `<form>` 元素的 `method` 属性。 * * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-formmethod */ 'formmethod'?: 'post' | 'get'; /** * 如果设置了此属性,表单提交时将不执行表单验证。 * * 如果设置了此属性,将覆盖 `<form>` 元素的 `novalidate` 属性。 * * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-formnovalidate */ 'formnovalidate'?: boolean; /** * 提交表单后接收到的响应应显示在何处。可选值包括: * * * `_self`:默认选项,在当前框架中打开 * * `_blank`:在新窗口中打开 * * `_parent`:在父框架中打开 * * `_top`:在整个窗口中打开 * * 如果设置了此属性,将覆盖 `<form>` 元素的 `target` 属性。 * * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-formtarget */ 'formtarget'?: '_self' | '_blank' | '_parent' | '_top'; } & HTMLElementProps; /** * 圆形进度指示器组件 * * ```html * <mdui-circular-progress></mdui-circular-progress> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/circular-progress */ 'mdui-circular-progress': { /** * 进度指示器的最大值。默认为 `1` * @see https://www.mdui.org/zh-cn/docs/2/components/circular-progress#attributes-max */ 'max'?: number; /** * 进度指示器的当前值。如果未指定该值,则显示为不确定状态 * @see https://www.mdui.org/zh-cn/docs/2/components/circular-progress#attributes-value */ 'value'?: number; } & HTMLElementProps; /** * 折叠面板项组件,需配合 `<mdui-collapse>` 组件使用 * * ```html * <mdui-collapse> * <mdui-collapse-item header="header-1">content-1</mdui-collapse-item> * <mdui-collapse-item header="header-2">content-2</mdui-collapse-item> * </mdui-collapse> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/collapse */ 'mdui-collapse-item': { /** * 此折叠面板项的值 * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-item-attributes-value */ 'value'?: string; /** * 此折叠面板项的头部文本 * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-item-attributes-header */ 'header'?: string; /** * 是否禁用此折叠面板项 * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-item-attributes-disabled */ 'disabled'?: boolean; /** * 点击该元素时触发折叠,值可以是 CSS 选择器、DOM 元素、或 [JQ 对象](https://www.mdui.org/zh-cn/docs/2/functions/jq)。默认为点击整个 header 区域触发 * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-item-attributes-trigger */ 'trigger'?: string | HTMLElement | JQ<HTMLElement>; } & HTMLElementProps; /** * 折叠面板组件,需配合 `<mdui-collapse-item>` 组件使用 * * ```html * <mdui-collapse> * <mdui-collapse-item header="header-1">content-1</mdui-collapse-item> * <mdui-collapse-item header="header-2">content-2</mdui-collapse-item> * </mdui-collapse> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/collapse */ 'mdui-collapse': { /** * 是否启用手风琴模式 * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-attributes-accordion */ 'accordion'?: boolean; /** * 当前展开的 `<mdui-collapse-item>` 的值 * * **Note**:该属性的 HTML 属性始终为字符串,只有在 `accordion` 为 `true` 时,才能设置初始值;该属性的 JavaScript 属性值在 `accordion` 为 `true` 时为字符串,在 `accordion` 为 `false` 时为字符串数组。因此,当 `accordion` 为 `false` 时,只能通过修改 JavaScript 属性值来改变此值。 * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-attributes-value */ 'value'?: string | string[]; /** * 是否禁用此折叠面板 * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-attributes-disabled */ 'disabled'?: boolean; } & HTMLElementProps; /** * 对话框组件 * * ```html * <mdui-dialog>content</mdui-dialog> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/dialog */ 'mdui-dialog': { /** * 顶部的 Material Icons 图标名。也可以通过 `slot="icon"` 设置 * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-icon */ 'icon'?: string; /** * 标题。也可以通过 `slot="headline"` 设置 * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-headline */ 'headline'?: string; /** * 标题下方的文本。也可以通过 `slot="description"` 设置 * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-description */ 'description'?: string; /** * 是否打开对话框 * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-open */ 'open'?: boolean; /** * 是否全屏显示对话框 * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-fullscreen */ 'fullscreen'?: boolean; /** * 是否允许按下 ESC 键关闭对话框 * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-close-on-esc */ 'close-on-esc'?: boolean; /** * 是否允许点击遮罩层关闭对话框 * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-close-on-overlay-click */ 'close-on-overlay-click'?: boolean; /** * 是否垂直排列底部操作按钮 * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-stacked-actions */ 'stacked-actions'?: boolean; } & HTMLElementProps; /** * 分割线组件 * * ```html * <mdui-divider></mdui-divider> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/divider */ 'mdui-divider': { /** * 是否为垂直分割线 * @see https://www.mdui.org/zh-cn/docs/2/components/divider#attributes-vertical */ 'vertical'?: boolean; /** * 是否进行左侧缩进 * @see https://www.mdui.org/zh-cn/docs/2/components/divider#attributes-inset */ 'inset'?: boolean; /** * 是否进行左右两侧缩进 * @see https://www.mdui.org/zh-cn/docs/2/components/divider#attributes-middle */ 'middle'?: boolean; } & HTMLElementProps; /** * 下拉组件 * * ```html * <mdui-dropdown> * <mdui-button slot="trigger">open dropdown</mdui-button> * <mdui-menu> * <mdui-menu-item>Item 1</mdui-menu-item> * <mdui-menu-item>Item 2</mdui-menu-item> * </mdui-menu> * </mdui-dropdown> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown */ 'mdui-dropdown': { /** * 是否打开下拉组件 * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-open */ 'open'?: boolean; /** * 是否禁用下拉组件 * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-disabled */ 'disabled'?: boolean; /** * 下拉组件的触发方式,支持多个值,用空格分隔。可选值包括: * * * `click`:点击触发 * * `hover`:鼠标悬浮触发 * * `focus`:聚焦触发 * * `contextmenu`:鼠标右键点击、或触摸长按触发 * * `manual`:仅能通过编程方式打开和关闭下拉组件,不能再指定其他触发方式 * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-trigger */ 'trigger'?: 'click' | 'hover' | 'focus' | 'contextmenu' | 'manual' | string; /** * 下拉组件内容的位置。可选值包括: * * * `auto`:自动判断位置 * * `top-start`:上方左对齐 * * `top`:上方居中 * * `top-end`:上方右对齐 * * `bottom-start`:下方左对齐 * * `bottom`:下方居中 * * `bottom-end`:下方右对齐 * * `left-start`:左侧顶部对齐 * * `left`:左侧居中 * * `left-end`:左侧底部对齐 * * `right-start`:右侧顶部对齐 * * `right`:右侧居中 * * `right-end`:右侧底部对齐 * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-placement */ 'placement'?: 'auto' | 'top-start' | 'top' | 'top-end' | 'bottom-start' | 'bottom' | 'bottom-end' | 'left-start' | 'left' | 'left-end' | 'right-start' | 'right' | 'right-end'; /** * 点击 [`<mdui-menu-item>`](https://www.mdui.org/zh-cn/docs/2/components/menu#menu-item-api) 后,下拉组件是否保持打开状态 * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-stay-open-on-click */ 'stay-open-on-click'?: boolean; /** * 鼠标悬浮触发下拉组件打开的延时,单位为毫秒 * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-open-delay */ 'open-delay'?: number; /** * 鼠标悬浮触发下拉组件关闭的延时,单位为毫秒 * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-close-delay */ 'close-delay'?: number; /** * 是否在触发下拉组件的光标位置打开下拉组件,常用于打开鼠标右键菜单 * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-open-on-pointer */ 'open-on-pointer'?: boolean; } & HTMLElementProps; /** * 浮动操作按钮组件 * * ```html * <mdui-fab icon="edit"></mdui-fab> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/fab */ 'mdui-fab': { /** * FAB 的形状,此组件的不同形状之间只有颜色不一样。可选值包括: * * * `primary`:使用 Primary container 背景色 * * `surface`:使用 Surface container high 背景色 * * `secondary`:使用 Secondary container 背景色 * * `tertiary`:使用 Tertiary container 背景色 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-variant */ 'variant'?: 'primary' | 'surface' | 'secondary' | 'tertiary'; /** * FAB 的大小。可选值包括: * * `normal`:普通大小 FAB * * `small`:小型 FAB * * `large`:大型 FAB * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-size */ 'size'?: 'normal' | 'small' | 'large'; /** * Material Icons 图标名。也可以通过 `slot="icon"` 设置 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-icon */ 'icon'?: string; /** * 是否为展开状态 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-extended */ 'extended'?: boolean; /** * 链接的目标 URL。 * * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-href */ 'href'?: string; /** * 下载链接的目标。 * * **Note**:仅在设置了 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-download */ 'download'?: string; /** * 链接的打开方式。可选值包括: * * * `_blank`:在新窗口中打开链接 * * `_parent`:在父框架中打开链接 * * `_self`:默认。在当前框架中打开链接 * * `_top`:在整个窗口中打开链接 * * **Note**:仅在设置了 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-target */ 'target'?: '_blank' | '_parent' | '_self' | '_top'; /** * 当前文档与被链接文档之间的关系。可选值包括: * * * `alternate`:当前文档的替代版本 * * `author`:当前文档或文章的作者 * * `bookmark`:永久链接到最近的祖先章节 * * `external`:引用的文档与当前文档不在同一站点 * * `help`:链接到相关的帮助文档 * * `license`:当前文档的主要内容由被引用文件的版权许可覆盖 * * `me`:当前文档代表链接内容的所有者 * * `next`:当前文档是系列中的一部分,被引用的文档是系列的下一个文档 * * `nofollow`:当前文档的作者或发布者不认可被引用的文件 * * `noreferrer`:不包含 `Referer` 头。类似于 `noopener` 的效果 * * `opener`:如果超链接会创建一个顶级浏览上下文(即 `target` 属性值为 `_blank`),则创建一个辅助浏览上下文 * * `prev`:当前文档是系列的一部分,被引用的文档是系列的上一个文档 * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面 * * `tag`:提供一个适用于当前文档的标签(由给定地址识别) * * **Note**:仅在指定了 `href` 属性时可用。 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-rel */ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag'; /** * 是否在页面加载完成后自动获取焦点 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-autofocus */ 'autofocus'?: boolean; /** * 元素在使用 Tab 键切换焦点时的顺序 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-tabindex */ 'tabindex'?: number; /** * 是否禁用 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-disabled */ 'disabled'?: boolean; /** * 是否处于加载中状态 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-loading */ 'loading'?: boolean; /** * 按钮的名称,将与表单数据一起提交。 * * **Note**:仅在未设置 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-name */ 'name'?: string; /** * 按钮的初始值,将与表单数据一起提交。 * * **Note**:仅在未设置 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-value */ 'value'?: string; /** * 按钮的类型。默认类型为 `button`。可选类型包括: * * * `submit`:点击按钮会提交表单数据到服务器 * * `reset`:点击按钮会将表单中的所有字段重置为初始值 * * `button`:此类型的按钮没有默认行为 * * **Note**:仅在未指定 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-type */ 'type'?: 'submit' | 'reset' | 'button'; /** * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。 * * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。 * * **Note**:仅在未指定 `href` 属性时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-form */ 'form'?: string; /** * 指定提交表单的 URL。 * * 如果指定了此属性,将覆盖 `<form>` 元素的 `action` 属性。 * * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-formaction */ 'formaction'?: string; /** * 指定提交表单到服务器的内容类型。可选值包括: * * * `application/x-www-form-urlencoded`:未指定该属性时的默认值 * * `multipart/form-data`:当表单包含 `<input type="file">` 元素时使用 * * `text/plain`:HTML5 新增,用于调试 * * 如果指定了此属性,将覆盖 `<form>` 元素的 `enctype` 属性。 * * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-formenctype */ 'formenctype'?: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain'; /** * 指定提交表单时使用的 HTTP 方法。可选值包括: * * * `post`:表单数据包含在表单内容中,发送到服务器 * * `get`:表单数据以 `?` 作为分隔符附加到表单的 URI 属性中,生成的 URI 发送到服务器。当表单没有副作用,并且仅包含 ASCII 字符时,使用此方法 * * 如果设置了此属性,将覆盖 `<form>` 元素的 `method` 属性。 * * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-formmethod */ 'formmethod'?: 'post' | 'get'; /** * 如果设置了此属性,表单提交时将不执行表单验证。 * * 如果设置了此属性,将覆盖 `<form>` 元素的 `novalidate` 属性。 * * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-formnovalidate */ 'formnovalidate'?: boolean; /** * 提交表单后接收到的响应应显示在何处。可选值包括: * * * `_self`:默认选项,在当前框架中打开 * * `_blank`:在新窗口中打开 * * `_parent`:在父框架中打开 * * `_top`:在整个窗口中打开 * * 如果设置了此属性,将覆盖 `<form>` 元素的 `target` 属性。 * * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。 * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-formtarget */ 'formtarget'?: '_self' | '_blank' | '_parent' | '_top'; } & HTMLElementProps; /** * 图标组件 * * ```html * <mdui-icon name="search"></mdui-icon> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/icon */ 'mdui-icon': { /** * Material Icons 图标名 * @see https://www.mdui.org/zh-cn/docs/2/components/icon#attributes-name */ 'name'?: string; /** * svg 图标的路径 * @see https://www.mdui.org/zh-cn/docs/2/components/icon#attributes-src */ 'src'?: string; } & HTMLElementProps; /** * 布局项组件 * * ```html * <mdui-layout> * <mdui-layout-item></mdui-layout-item> * <mdui-layout-item></mdui-layout-item> * <mdui-layout-main></mdui-layout-main> * </mdui-layout> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/layout */ 'mdui-layout-item': { /** * 组件的位置。可选值包括: * * * `top`:上方 * * `bottom`:下方 * * `left`:左侧 * * `right`:右侧 * @see https://www.mdui.org/zh-cn/docs/2/components/layout#layout-item-attributes-placement */ 'placement'?: 'top' | 'bottom' | 'left' | 'right'; /** * 该组件在 [`<mdui-layout>`](https://www.mdui.org/zh-cn/docs/2/components/layout) 中的布局顺序,按从小到大排序。默认为 `0` * @see https://www.mdui.org/zh-cn/docs/2/components/layout#layout-item-attributes-order */ 'order'?: number; } & HTMLElementProps; /** * 布局主体内容组件 * * ```html * <mdui-layout> * <mdui-layout-item></mdui-layout-item> * <mdui-layout-item></mdui-layout-item> * <mdui-layout-main></mdui-layout-main> * </mdui-layout> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/layout */ 'mdui-layout-main': { } & HTMLElementProps; /** * 布局组件 * * ```html * <mdui-layout> * <mdui-layout-item></mdui-layout-item> * <mdui-layout-item></mdui-layout-item> * <mdui-layout-main></mdui-layout-main> * </mdui-layout> * ``` * @see https://www.mdui.org/zh-cn/docs/2/components/layout */ 'mdui-layout': { /** * 设置当前布局的高度为 100% * @see https://www.mdui.org/zh-cn/docs/2/components/layout#layout-attributes-full-he