mdui 2.0.2 → 2.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. package/components/avatar/index.d.ts +17 -15
  2. package/components/avatar/index.js +7 -6
  3. package/components/badge/index.d.ts +11 -8
  4. package/components/badge/index.js +9 -7
  5. package/components/bottom-app-bar/index.d.ts +11 -4
  6. package/components/bottom-app-bar/index.js +8 -9
  7. package/components/button/button-base-style.js +1 -1
  8. package/components/button/button-base.d.ts +46 -47
  9. package/components/button/button-base.js +27 -25
  10. package/components/button/index.d.ts +19 -14
  11. package/components/button/index.js +12 -12
  12. package/components/button-icon/index.d.ts +15 -9
  13. package/components/button-icon/index.js +8 -9
  14. package/components/card/index.d.ts +15 -11
  15. package/components/card/index.js +10 -9
  16. package/components/checkbox/index.d.ts +30 -23
  17. package/components/checkbox/index.js +25 -25
  18. package/components/chip/index.d.ts +27 -20
  19. package/components/chip/index.js +19 -20
  20. package/components/circular-progress/index.d.ts +6 -4
  21. package/components/circular-progress/index.js +4 -3
  22. package/components/collapse/collapse-item.d.ts +17 -6
  23. package/components/collapse/collapse-item.js +7 -7
  24. package/components/collapse/collapse.d.ts +16 -11
  25. package/components/collapse/collapse.js +10 -10
  26. package/components/dialog/index.d.ts +22 -15
  27. package/components/dialog/index.js +23 -27
  28. package/components/divider/index.d.ts +7 -5
  29. package/components/divider/index.js +6 -5
  30. package/components/dropdown/index.d.ts +44 -37
  31. package/components/dropdown/index.js +50 -48
  32. package/components/fab/index.d.ts +12 -7
  33. package/components/fab/index.js +6 -6
  34. package/components/icon/index.d.ts +4 -2
  35. package/components/icon/index.js +3 -2
  36. package/components/layout/layout-item-base.d.ts +3 -2
  37. package/components/layout/layout-item-base.js +2 -2
  38. package/components/layout/layout-item.d.ts +11 -10
  39. package/components/layout/layout-item.js +6 -6
  40. package/components/layout/layout-main.d.ts +6 -4
  41. package/components/layout/layout-main.js +5 -4
  42. package/components/layout/layout.d.ts +6 -4
  43. package/components/layout/layout.js +5 -4
  44. package/components/linear-progress/index.d.ts +8 -6
  45. package/components/linear-progress/index.js +6 -5
  46. package/components/list/list-item-style.js +1 -1
  47. package/components/list/list-item.d.ts +24 -20
  48. package/components/list/list-item.js +10 -9
  49. package/components/list/list-subheader.d.ts +6 -4
  50. package/components/list/list-subheader.js +5 -4
  51. package/components/list/list.d.ts +5 -3
  52. package/components/list/list.js +4 -3
  53. package/components/menu/menu-item.d.ts +15 -7
  54. package/components/menu/menu-item.js +11 -15
  55. package/components/menu/menu.d.ts +20 -20
  56. package/components/menu/menu.js +13 -13
  57. package/components/navigation-bar/navigation-bar-item.d.ts +12 -8
  58. package/components/navigation-bar/navigation-bar-item.js +7 -6
  59. package/components/navigation-bar/navigation-bar.d.ts +17 -9
  60. package/components/navigation-bar/navigation-bar.js +15 -13
  61. package/components/navigation-drawer/index.d.ts +27 -21
  62. package/components/navigation-drawer/index.js +51 -38
  63. package/components/navigation-drawer/style.js +1 -1
  64. package/components/navigation-rail/navigation-rail-item.d.ts +13 -9
  65. package/components/navigation-rail/navigation-rail-item.js +7 -6
  66. package/components/navigation-rail/navigation-rail.d.ts +14 -12
  67. package/components/navigation-rail/navigation-rail.js +13 -12
  68. package/components/radio/radio-group.d.ts +20 -15
  69. package/components/radio/radio-group.js +21 -24
  70. package/components/radio/radio.d.ts +11 -6
  71. package/components/radio/radio.js +7 -7
  72. package/components/range-slider/index.d.ts +13 -8
  73. package/components/range-slider/index.js +10 -7
  74. package/components/ripple/index.d.ts +4 -2
  75. package/components/ripple/index.js +3 -2
  76. package/components/ripple/ripple-mixin.d.ts +1 -1
  77. package/components/ripple/ripple-mixin.js +0 -1
  78. package/components/segmented-button/segmented-button-group-style.js +1 -1
  79. package/components/segmented-button/segmented-button-group.d.ts +23 -22
  80. package/components/segmented-button/segmented-button-group.js +20 -23
  81. package/components/segmented-button/segmented-button.d.ts +9 -4
  82. package/components/segmented-button/segmented-button.js +3 -3
  83. package/components/select/index.d.ts +42 -35
  84. package/components/select/index.js +24 -25
  85. package/components/slider/index.d.ts +9 -2
  86. package/components/slider/index.js +5 -10
  87. package/components/slider/slider-base.d.ts +22 -18
  88. package/components/slider/slider-base.js +40 -21
  89. package/components/snackbar/index.d.ts +30 -23
  90. package/components/snackbar/index.js +25 -25
  91. package/components/switch/index.d.ts +24 -17
  92. package/components/switch/index.js +18 -18
  93. package/components/tabs/tab-panel.d.ts +7 -5
  94. package/components/tabs/tab-panel.js +5 -4
  95. package/components/tabs/tab.d.ts +13 -9
  96. package/components/tabs/tab.js +8 -7
  97. package/components/tabs/tabs.d.ts +24 -21
  98. package/components/tabs/tabs.js +24 -21
  99. package/components/text-field/index.d.ts +62 -54
  100. package/components/text-field/index.js +37 -37
  101. package/components/tooltip/index.d.ts +40 -33
  102. package/components/tooltip/index.js +45 -43
  103. package/components/top-app-bar/top-app-bar-title.d.ts +8 -6
  104. package/components/top-app-bar/top-app-bar-title.js +7 -6
  105. package/components/top-app-bar/top-app-bar.d.ts +12 -6
  106. package/components/top-app-bar/top-app-bar.js +9 -10
  107. package/css-data.en.json +2826 -0
  108. package/css-data.zh-cn.json +374 -367
  109. package/custom-elements.json +3844 -3824
  110. package/html-data.en.json +6551 -0
  111. package/html-data.zh-cn.json +1621 -1636
  112. package/jsx.en.d.ts +3303 -0
  113. package/jsx.zh-cn.d.ts +3351 -0
  114. package/mdui.esm.js +9 -9
  115. package/mdui.global.js +9 -9
  116. package/package.json +7 -5
  117. package/web-types.en.json +11718 -0
  118. package/web-types.zh-cn.json +3613 -3623
package/jsx.zh-cn.d.ts ADDED
@@ -0,0 +1,3351 @@
1
+ import React from 'react';
2
+ import { JQ } from '@mdui/jq';
3
+
4
+ type HTMLElementProps = React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>;
5
+
6
+ declare global {
7
+ namespace JSX {
8
+ interface IntrinsicElements {
9
+ /**
10
+ * 头像组件
11
+ *
12
+ * ```html
13
+ * <mdui-avatar src="https://avatars githubusercontent com/u/3030330?s=40&v=4"></mdui-avatar>
14
+ * ```
15
+ * @see https://www.mdui.org/zh-cn/docs/2/components/avatar
16
+ */
17
+ 'mdui-avatar': {
18
+ /**
19
+ * 头像图片的 URL 地址
20
+ * @see https://www.mdui.org/zh-cn/docs/2/components/avatar#attributes-src
21
+ */
22
+ 'src'?: string;
23
+ /**
24
+ * 图片如何适应容器框,与原生的 [`object-fit`](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) 属性相同。可选值包括:
25
+ *
26
+ * * `contain`:保持图片原有尺寸比例,内容会被等比例缩放
27
+ * * `cover`:保持图片原有尺寸比例,但部分内容可能被剪切
28
+ * * `fill`:默认值,不保持图片原有尺寸比例,内容会被拉伸以填充整个容器
29
+ * * `none`:保留图片原有尺寸,内容不会被缩放或拉伸
30
+ * * `scale-down`:保持图片原有尺寸比例,内容尺寸与 `none` 或 `contain` 中较小的一个相同
31
+ * @see https://www.mdui.org/zh-cn/docs/2/components/avatar#attributes-fit
32
+ */
33
+ 'fit'?: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down';
34
+ /**
35
+ * 头像的 Material Icons 图标名
36
+ * @see https://www.mdui.org/zh-cn/docs/2/components/avatar#attributes-icon
37
+ */
38
+ 'icon'?: string;
39
+ /**
40
+ * 头像的替代文本描述
41
+ * @see https://www.mdui.org/zh-cn/docs/2/components/avatar#attributes-label
42
+ */
43
+ 'label'?: string;
44
+ } & HTMLElementProps;
45
+ /**
46
+ * 徽标组件
47
+ *
48
+ * ```html
49
+ * <mdui-badge>12</mdui-badge>
50
+ * ```
51
+ * @see https://www.mdui.org/zh-cn/docs/2/components/badge
52
+ */
53
+ 'mdui-badge': {
54
+ /**
55
+ * 徽标的形状。可选值包括:
56
+ *
57
+ * * `small`:小型徽标,不显示文本
58
+ * * `large`:大型徽标,会显示文本
59
+ * @see https://www.mdui.org/zh-cn/docs/2/components/badge#attributes-variant
60
+ */
61
+ 'variant'?: 'small' | 'large';
62
+ } & HTMLElementProps;
63
+ /**
64
+ * 底部应用栏组件
65
+ *
66
+ * ```html
67
+ * <mdui-bottom-app-bar>
68
+ * <mdui-button-icon icon="check_box--outlined"></mdui-button-icon>
69
+ * <mdui-button-icon icon="edit--outlined"></mdui-button-icon>
70
+ * <mdui-button-icon icon="mic_none--outlined"></mdui-button-icon>
71
+ * <mdui-button-icon icon="image--outlined"></mdui-button-icon>
72
+ * <div style="flex-grow: 1"></div>
73
+ * <mdui-fab icon="add"></mdui-fab>
74
+ * </mdui-bottom-app-bar>
75
+ * ```
76
+ * @see https://www.mdui.org/zh-cn/docs/2/components/bottom-app-bar
77
+ */
78
+ 'mdui-bottom-app-bar': {
79
+ /**
80
+ * 是否隐藏
81
+ * @see https://www.mdui.org/zh-cn/docs/2/components/bottom-app-bar#attributes-hide
82
+ */
83
+ 'hide'?: boolean;
84
+ /**
85
+ * 是否让底部应用栏中的 [`<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) 仍会停留在页面上
86
+ * @see https://www.mdui.org/zh-cn/docs/2/components/bottom-app-bar#attributes-fab-detach
87
+ */
88
+ 'fab-detach'?: boolean;
89
+ /**
90
+ * 滚动行为。可选值为:
91
+ *
92
+ * * `hide`:滚动时隐藏
93
+ * @see https://www.mdui.org/zh-cn/docs/2/components/bottom-app-bar#attributes-scroll-behavior
94
+ */
95
+ 'scroll-behavior'?: 'hide';
96
+ /**
97
+ * 需要监听其滚动事件的元素。值可以是 CSS 选择器、DOM 元素、或 [JQ 对象](https://www.mdui.org/zh-cn/docs/2/functions/jq)。默认监听 `window` 的滚动事件
98
+ * @see https://www.mdui.org/zh-cn/docs/2/components/bottom-app-bar#attributes-scroll-target
99
+ */
100
+ 'scroll-target'?: string | HTMLElement | JQ<HTMLElement>;
101
+ /**
102
+ * 在滚动多少距离之后触发滚动行为,单位为 `px`
103
+ * @see https://www.mdui.org/zh-cn/docs/2/components/bottom-app-bar#attributes-scroll-threshold
104
+ */
105
+ 'scroll-threshold'?: number;
106
+ /**
107
+ * 该组件在 [`<mdui-layout>`](https://www.mdui.org/zh-cn/docs/2/components/layout) 中的布局顺序,按从小到大排序。默认为 `0`
108
+ * @see https://www.mdui.org/zh-cn/docs/2/components/bottom-app-bar#attributes-order
109
+ */
110
+ 'order'?: number;
111
+ } & HTMLElementProps;
112
+ /**
113
+ * 按钮组件
114
+ *
115
+ * ```html
116
+ * <mdui-button>Button</mdui-button>
117
+ * ```
118
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button
119
+ */
120
+ 'mdui-button': {
121
+ /**
122
+ * 按钮的形状。可选值包括:
123
+ *
124
+ * * `elevated`:带阴影的按钮,适用于需要将按钮与背景视觉分离的场景
125
+ * * `filled`:视觉效果强烈,适用于重要流程的最终操作,如“保存”、“确认”等
126
+ * * `tonal`:视觉效果介于 `filled` 和 `outlined` 之间,适用于中高优先级的操作,如流程中的“下一步”
127
+ * * `outlined`:带边框的按钮,适用于中等优先级,且次要的操作,如“返回”
128
+ * * `text`:文本按钮,适用于最低优先级的操作
129
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-variant
130
+ */
131
+ 'variant'?: 'elevated' | 'filled' | 'tonal' | 'outlined' | 'text';
132
+ /**
133
+ * 是否填满父元素宽度
134
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-full-width
135
+ */
136
+ 'full-width'?: boolean;
137
+ /**
138
+ * 左侧的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
139
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-icon
140
+ */
141
+ 'icon'?: string;
142
+ /**
143
+ * 右侧的 Material Icons 图标名。也可以通过 `slot="end-icon"` 设置
144
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-end-icon
145
+ */
146
+ 'end-icon'?: string;
147
+ /**
148
+ * 链接的目标 URL。
149
+ *
150
+ * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。
151
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-href
152
+ */
153
+ 'href'?: string;
154
+ /**
155
+ * 下载链接的目标。
156
+ *
157
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
158
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-download
159
+ */
160
+ 'download'?: string;
161
+ /**
162
+ * 链接的打开方式。可选值包括:
163
+ *
164
+ * * `_blank`:在新窗口中打开链接
165
+ * * `_parent`:在父框架中打开链接
166
+ * * `_self`:默认。在当前框架中打开链接
167
+ * * `_top`:在整个窗口中打开链接
168
+ *
169
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
170
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-target
171
+ */
172
+ 'target'?: '_blank' | '_parent' | '_self' | '_top';
173
+ /**
174
+ * 当前文档与被链接文档之间的关系。可选值包括:
175
+ *
176
+ * * `alternate`:当前文档的替代版本
177
+ * * `author`:当前文档或文章的作者
178
+ * * `bookmark`:永久链接到最近的祖先章节
179
+ * * `external`:引用的文档与当前文档不在同一站点
180
+ * * `help`:链接到相关的帮助文档
181
+ * * `license`:当前文档的主要内容由被引用文件的版权许可覆盖
182
+ * * `me`:当前文档代表链接内容的所有者
183
+ * * `next`:当前文档是系列中的一部分,被引用的文档是系列的下一个文档
184
+ * * `nofollow`:当前文档的作者或发布者不认可被引用的文件
185
+ * * `noreferrer`:不包含 `Referer` 头。类似于 `noopener` 的效果
186
+ * * `opener`:如果超链接会创建一个顶级浏览上下文(即 `target` 属性值为 `_blank`),则创建一个辅助浏览上下文
187
+ * * `prev`:当前文档是系列的一部分,被引用的文档是系列的上一个文档
188
+ * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面
189
+ * * `tag`:提供一个适用于当前文档的标签(由给定地址识别)
190
+ *
191
+ * **Note**:仅在指定了 `href` 属性时可用。
192
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-rel
193
+ */
194
+ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag';
195
+ /**
196
+ * 是否在页面加载完成后自动获取焦点
197
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-autofocus
198
+ */
199
+ 'autofocus'?: boolean;
200
+ /**
201
+ * 元素在使用 Tab 键切换焦点时的顺序
202
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-tabindex
203
+ */
204
+ 'tabindex'?: number;
205
+ /**
206
+ * 是否禁用
207
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-disabled
208
+ */
209
+ 'disabled'?: boolean;
210
+ /**
211
+ * 是否处于加载中状态
212
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-loading
213
+ */
214
+ 'loading'?: boolean;
215
+ /**
216
+ * 按钮的名称,将与表单数据一起提交。
217
+ *
218
+ * **Note**:仅在未设置 `href` 属性时,此属性才有效。
219
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-name
220
+ */
221
+ 'name'?: string;
222
+ /**
223
+ * 按钮的初始值,将与表单数据一起提交。
224
+ *
225
+ * **Note**:仅在未设置 `href` 属性时,此属性才有效。
226
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-value
227
+ */
228
+ 'value'?: string;
229
+ /**
230
+ * 按钮的类型。默认类型为 `button`。可选类型包括:
231
+ *
232
+ * * `submit`:点击按钮会提交表单数据到服务器
233
+ * * `reset`:点击按钮会将表单中的所有字段重置为初始值
234
+ * * `button`:此类型的按钮没有默认行为
235
+ *
236
+ * **Note**:仅在未指定 `href` 属性时,此属性才有效。
237
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-type
238
+ */
239
+ 'type'?: 'submit' | 'reset' | 'button';
240
+ /**
241
+ * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
242
+ *
243
+ * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
244
+ *
245
+ * **Note**:仅在未指定 `href` 属性时,此属性才有效。
246
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-form
247
+ */
248
+ 'form'?: string;
249
+ /**
250
+ * 指定提交表单的 URL。
251
+ *
252
+ * 如果指定了此属性,将覆盖 `<form>` 元素的 `action` 属性。
253
+ *
254
+ * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。
255
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formaction
256
+ */
257
+ 'formaction'?: string;
258
+ /**
259
+ * 指定提交表单到服务器的内容类型。可选值包括:
260
+ *
261
+ * * `application/x-www-form-urlencoded`:未指定该属性时的默认值
262
+ * * `multipart/form-data`:当表单包含 `<input type="file">` 元素时使用
263
+ * * `text/plain`:HTML5 新增,用于调试
264
+ *
265
+ * 如果指定了此属性,将覆盖 `<form>` 元素的 `enctype` 属性。
266
+ *
267
+ * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。
268
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formenctype
269
+ */
270
+ 'formenctype'?: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain';
271
+ /**
272
+ * 指定提交表单时使用的 HTTP 方法。可选值包括:
273
+ *
274
+ * * `post`:表单数据包含在表单内容中,发送到服务器
275
+ * * `get`:表单数据以 `?` 作为分隔符附加到表单的 URI 属性中,生成的 URI 发送到服务器。当表单没有副作用,并且仅包含 ASCII 字符时,使用此方法
276
+ *
277
+ * 如果设置了此属性,将覆盖 `<form>` 元素的 `method` 属性。
278
+ *
279
+ * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
280
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formmethod
281
+ */
282
+ 'formmethod'?: 'post' | 'get';
283
+ /**
284
+ * 如果设置了此属性,表单提交时将不执行表单验证。
285
+ *
286
+ * 如果设置了此属性,将覆盖 `<form>` 元素的 `novalidate` 属性。
287
+ *
288
+ * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
289
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formnovalidate
290
+ */
291
+ 'formnovalidate'?: boolean;
292
+ /**
293
+ * 提交表单后接收到的响应应显示在何处。可选值包括:
294
+ *
295
+ * * `_self`:默认选项,在当前框架中打开
296
+ * * `_blank`:在新窗口中打开
297
+ * * `_parent`:在父框架中打开
298
+ * * `_top`:在整个窗口中打开
299
+ *
300
+ * 如果设置了此属性,将覆盖 `<form>` 元素的 `target` 属性。
301
+ *
302
+ * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
303
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formtarget
304
+ */
305
+ 'formtarget'?: '_self' | '_blank' | '_parent' | '_top';
306
+ } & HTMLElementProps;
307
+ /**
308
+ * 图标按钮组件
309
+ *
310
+ * ```html
311
+ * <mdui-button-icon icon="search"></mdui-button-icon>
312
+ * ```
313
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon
314
+ */
315
+ 'mdui-button-icon': {
316
+ /**
317
+ * 图标按钮的形状。可选值包括:
318
+ *
319
+ * * `standard`:适用于最低优先级的操作
320
+ * * `filled`:视觉效果强烈,适用于高优先级的操作
321
+ * * `tonal`:视觉效果介于 `filled` 和 `outlined` 之间,适用于中高优先级的操作
322
+ * * `outlined`:适用于中等优先级的操作
323
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-variant
324
+ */
325
+ 'variant'?: 'standard' | 'filled' | 'tonal' | 'outlined';
326
+ /**
327
+ * Material Icons 图标名。也可以通过 default slot 设置
328
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-icon
329
+ */
330
+ 'icon'?: string;
331
+ /**
332
+ * 选中状态的 Material Icons 图标名。也可以通过 `slot="selected-icon"` 设置
333
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-selected-icon
334
+ */
335
+ 'selected-icon'?: string;
336
+ /**
337
+ * 是否可选中
338
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-selectable
339
+ */
340
+ 'selectable'?: boolean;
341
+ /**
342
+ * 是否已被选中
343
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-selected
344
+ */
345
+ 'selected'?: boolean;
346
+ /**
347
+ * 链接的目标 URL。
348
+ *
349
+ * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。
350
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-href
351
+ */
352
+ 'href'?: string;
353
+ /**
354
+ * 下载链接的目标。
355
+ *
356
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
357
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-download
358
+ */
359
+ 'download'?: string;
360
+ /**
361
+ * 链接的打开方式。可选值包括:
362
+ *
363
+ * * `_blank`:在新窗口中打开链接
364
+ * * `_parent`:在父框架中打开链接
365
+ * * `_self`:默认。在当前框架中打开链接
366
+ * * `_top`:在整个窗口中打开链接
367
+ *
368
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
369
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-target
370
+ */
371
+ 'target'?: '_blank' | '_parent' | '_self' | '_top';
372
+ /**
373
+ * 当前文档与被链接文档之间的关系。可选值包括:
374
+ *
375
+ * * `alternate`:当前文档的替代版本
376
+ * * `author`:当前文档或文章的作者
377
+ * * `bookmark`:永久链接到最近的祖先章节
378
+ * * `external`:引用的文档与当前文档不在同一站点
379
+ * * `help`:链接到相关的帮助文档
380
+ * * `license`:当前文档的主要内容由被引用文件的版权许可覆盖
381
+ * * `me`:当前文档代表链接内容的所有者
382
+ * * `next`:当前文档是系列中的一部分,被引用的文档是系列的下一个文档
383
+ * * `nofollow`:当前文档的作者或发布者不认可被引用的文件
384
+ * * `noreferrer`:不包含 `Referer` 头。类似于 `noopener` 的效果
385
+ * * `opener`:如果超链接会创建一个顶级浏览上下文(即 `target` 属性值为 `_blank`),则创建一个辅助浏览上下文
386
+ * * `prev`:当前文档是系列的一部分,被引用的文档是系列的上一个文档
387
+ * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面
388
+ * * `tag`:提供一个适用于当前文档的标签(由给定地址识别)
389
+ *
390
+ * **Note**:仅在指定了 `href` 属性时可用。
391
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-rel
392
+ */
393
+ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag';
394
+ /**
395
+ * 是否在页面加载完成后自动获取焦点
396
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-autofocus
397
+ */
398
+ 'autofocus'?: boolean;
399
+ /**
400
+ * 元素在使用 Tab 键切换焦点时的顺序
401
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-tabindex
402
+ */
403
+ 'tabindex'?: number;
404
+ /**
405
+ * 是否禁用
406
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-disabled
407
+ */
408
+ 'disabled'?: boolean;
409
+ /**
410
+ * 是否处于加载中状态
411
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-loading
412
+ */
413
+ 'loading'?: boolean;
414
+ /**
415
+ * 按钮的名称,将与表单数据一起提交。
416
+ *
417
+ * **Note**:仅在未设置 `href` 属性时,此属性才有效。
418
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-name
419
+ */
420
+ 'name'?: string;
421
+ /**
422
+ * 按钮的初始值,将与表单数据一起提交。
423
+ *
424
+ * **Note**:仅在未设置 `href` 属性时,此属性才有效。
425
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-value
426
+ */
427
+ 'value'?: string;
428
+ /**
429
+ * 按钮的类型。默认类型为 `button`。可选类型包括:
430
+ *
431
+ * * `submit`:点击按钮会提交表单数据到服务器
432
+ * * `reset`:点击按钮会将表单中的所有字段重置为初始值
433
+ * * `button`:此类型的按钮没有默认行为
434
+ *
435
+ * **Note**:仅在未指定 `href` 属性时,此属性才有效。
436
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-type
437
+ */
438
+ 'type'?: 'submit' | 'reset' | 'button';
439
+ /**
440
+ * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
441
+ *
442
+ * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
443
+ *
444
+ * **Note**:仅在未指定 `href` 属性时,此属性才有效。
445
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-form
446
+ */
447
+ 'form'?: string;
448
+ /**
449
+ * 指定提交表单的 URL。
450
+ *
451
+ * 如果指定了此属性,将覆盖 `<form>` 元素的 `action` 属性。
452
+ *
453
+ * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。
454
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formaction
455
+ */
456
+ 'formaction'?: string;
457
+ /**
458
+ * 指定提交表单到服务器的内容类型。可选值包括:
459
+ *
460
+ * * `application/x-www-form-urlencoded`:未指定该属性时的默认值
461
+ * * `multipart/form-data`:当表单包含 `<input type="file">` 元素时使用
462
+ * * `text/plain`:HTML5 新增,用于调试
463
+ *
464
+ * 如果指定了此属性,将覆盖 `<form>` 元素的 `enctype` 属性。
465
+ *
466
+ * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。
467
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formenctype
468
+ */
469
+ 'formenctype'?: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain';
470
+ /**
471
+ * 指定提交表单时使用的 HTTP 方法。可选值包括:
472
+ *
473
+ * * `post`:表单数据包含在表单内容中,发送到服务器
474
+ * * `get`:表单数据以 `?` 作为分隔符附加到表单的 URI 属性中,生成的 URI 发送到服务器。当表单没有副作用,并且仅包含 ASCII 字符时,使用此方法
475
+ *
476
+ * 如果设置了此属性,将覆盖 `<form>` 元素的 `method` 属性。
477
+ *
478
+ * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
479
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formmethod
480
+ */
481
+ 'formmethod'?: 'post' | 'get';
482
+ /**
483
+ * 如果设置了此属性,表单提交时将不执行表单验证。
484
+ *
485
+ * 如果设置了此属性,将覆盖 `<form>` 元素的 `novalidate` 属性。
486
+ *
487
+ * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
488
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formnovalidate
489
+ */
490
+ 'formnovalidate'?: boolean;
491
+ /**
492
+ * 提交表单后接收到的响应应显示在何处。可选值包括:
493
+ *
494
+ * * `_self`:默认选项,在当前框架中打开
495
+ * * `_blank`:在新窗口中打开
496
+ * * `_parent`:在父框架中打开
497
+ * * `_top`:在整个窗口中打开
498
+ *
499
+ * 如果设置了此属性,将覆盖 `<form>` 元素的 `target` 属性。
500
+ *
501
+ * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
502
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formtarget
503
+ */
504
+ 'formtarget'?: '_self' | '_blank' | '_parent' | '_top';
505
+ } & HTMLElementProps;
506
+ /**
507
+ * 卡片组件
508
+ *
509
+ * ```html
510
+ * <mdui-card>card content</mdui-card>
511
+ * ```
512
+ * @see https://www.mdui.org/zh-cn/docs/2/components/card
513
+ */
514
+ 'mdui-card': {
515
+ /**
516
+ * 卡片的形状。可选值包括:
517
+ *
518
+ * * `elevated`:带阴影的卡片,与背景的视觉分离度较高
519
+ * * `filled`:带填充色的卡片,与背景的视觉分离度较低
520
+ * * `outlined`:带边框的卡片,与背景的视觉分离度最高
521
+ * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-variant
522
+ */
523
+ 'variant'?: 'elevated' | 'filled' | 'outlined';
524
+ /**
525
+ * 是否可点击。为 `true` 时,卡片将具有鼠标悬浮效果和点击涟漪效果
526
+ * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-clickable
527
+ */
528
+ 'clickable'?: boolean;
529
+ /**
530
+ * 是否禁用
531
+ * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-disabled
532
+ */
533
+ 'disabled'?: boolean;
534
+ /**
535
+ * 链接的目标 URL。
536
+ *
537
+ * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。
538
+ * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-href
539
+ */
540
+ 'href'?: string;
541
+ /**
542
+ * 下载链接的目标。
543
+ *
544
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
545
+ * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-download
546
+ */
547
+ 'download'?: string;
548
+ /**
549
+ * 链接的打开方式。可选值包括:
550
+ *
551
+ * * `_blank`:在新窗口中打开链接
552
+ * * `_parent`:在父框架中打开链接
553
+ * * `_self`:默认。在当前框架中打开链接
554
+ * * `_top`:在整个窗口中打开链接
555
+ *
556
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
557
+ * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-target
558
+ */
559
+ 'target'?: '_blank' | '_parent' | '_self' | '_top';
560
+ /**
561
+ * 当前文档与被链接文档之间的关系。可选值包括:
562
+ *
563
+ * * `alternate`:当前文档的替代版本
564
+ * * `author`:当前文档或文章的作者
565
+ * * `bookmark`:永久链接到最近的祖先章节
566
+ * * `external`:引用的文档与当前文档不在同一站点
567
+ * * `help`:链接到相关的帮助文档
568
+ * * `license`:当前文档的主要内容由被引用文件的版权许可覆盖
569
+ * * `me`:当前文档代表链接内容的所有者
570
+ * * `next`:当前文档是系列中的一部分,被引用的文档是系列的下一个文档
571
+ * * `nofollow`:当前文档的作者或发布者不认可被引用的文件
572
+ * * `noreferrer`:不包含 `Referer` 头。类似于 `noopener` 的效果
573
+ * * `opener`:如果超链接会创建一个顶级浏览上下文(即 `target` 属性值为 `_blank`),则创建一个辅助浏览上下文
574
+ * * `prev`:当前文档是系列的一部分,被引用的文档是系列的上一个文档
575
+ * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面
576
+ * * `tag`:提供一个适用于当前文档的标签(由给定地址识别)
577
+ *
578
+ * **Note**:仅在指定了 `href` 属性时可用。
579
+ * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-rel
580
+ */
581
+ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag';
582
+ /**
583
+ * 是否在页面加载完成后自动获取焦点
584
+ * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-autofocus
585
+ */
586
+ 'autofocus'?: boolean;
587
+ /**
588
+ * 元素在使用 Tab 键切换焦点时的顺序
589
+ * @see https://www.mdui.org/zh-cn/docs/2/components/card#attributes-tabindex
590
+ */
591
+ 'tabindex'?: number;
592
+ } & HTMLElementProps;
593
+ /**
594
+ * 复选框组件
595
+ *
596
+ * ```html
597
+ * <mdui-checkbox>Checkbox</mdui-checkbox>
598
+ * ```
599
+ * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox
600
+ */
601
+ 'mdui-checkbox': {
602
+ /**
603
+ * 是否为禁用状态
604
+ * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-disabled
605
+ */
606
+ 'disabled'?: boolean;
607
+ /**
608
+ * 是否为选中状态
609
+ * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-checked
610
+ */
611
+ 'checked'?: boolean;
612
+ /**
613
+ * 是否处于不确定状态
614
+ * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-indeterminate
615
+ */
616
+ 'indeterminate'?: boolean;
617
+ /**
618
+ * 提交表单时,是否必须选中此复选框
619
+ * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-required
620
+ */
621
+ 'required'?: boolean;
622
+ /**
623
+ * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
624
+ *
625
+ * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
626
+ * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-form
627
+ */
628
+ 'form'?: string;
629
+ /**
630
+ * 复选框名称,将与表单数据一起提交
631
+ * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-name
632
+ */
633
+ 'name'?: string;
634
+ /**
635
+ * 复选框的值,将于表单数据一起提交
636
+ * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-value
637
+ */
638
+ 'value'?: string;
639
+ /**
640
+ * 未选中状态的 Material Icons 图标名。也可以通过 `slot="unchecked-icon"` 设置
641
+ * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-unchecked-icon
642
+ */
643
+ 'unchecked-icon'?: string;
644
+ /**
645
+ * 选中状态的 Material Icons 图标名。也可以通过 `slot="checked-icon"` 设置
646
+ * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-checked-icon
647
+ */
648
+ 'checked-icon'?: string;
649
+ /**
650
+ * 不确定状态的 Material Icons 图标名。也可以通过 `slot="indeterminate-icon"` 设置
651
+ * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-indeterminate-icon
652
+ */
653
+ 'indeterminate-icon'?: string;
654
+ /**
655
+ * 是否在页面加载完成后自动获取焦点
656
+ * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-autofocus
657
+ */
658
+ 'autofocus'?: boolean;
659
+ /**
660
+ * 元素在使用 Tab 键切换焦点时的顺序
661
+ * @see https://www.mdui.org/zh-cn/docs/2/components/checkbox#attributes-tabindex
662
+ */
663
+ 'tabindex'?: number;
664
+ } & HTMLElementProps;
665
+ /**
666
+ * 纸片组件
667
+ *
668
+ * ```html
669
+ * <mdui-chip>Chip</mdui-chip>
670
+ * ```
671
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip
672
+ */
673
+ 'mdui-chip': {
674
+ /**
675
+ * 纸片的形状。可选值包括:
676
+ *
677
+ * * `assist`:用于显示与当前上下文相关的辅助操作,如在点餐页面提供分享、收藏等功能
678
+ * * `filter`:用于对内容进行筛选,如在搜索结果页过滤搜索结果
679
+ * * `input`:用于表示用户输入的信息片段,如在 Gmail 的“收件人”字段中的联系人
680
+ * * `suggestion`:用于提供动态生成的推荐信息,以简化用户操作,如在聊天应用中预测用户可能想发送的信息
681
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-variant
682
+ */
683
+ 'variant'?: 'assist' | 'filter' | 'input' | 'suggestion';
684
+ /**
685
+ * 是否显示阴影
686
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-elevated
687
+ */
688
+ 'elevated'?: boolean;
689
+ /**
690
+ * 是否可选中
691
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-selectable
692
+ */
693
+ 'selectable'?: boolean;
694
+ /**
695
+ * 是否已选中
696
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-selected
697
+ */
698
+ 'selected'?: boolean;
699
+ /**
700
+ * 是否可删除。为 `true` 时,纸片右侧会显示删除图标
701
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-deletable
702
+ */
703
+ 'deletable'?: boolean;
704
+ /**
705
+ * 左侧的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
706
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-icon
707
+ */
708
+ 'icon'?: string;
709
+ /**
710
+ * 选中状态下左侧的 Material Icons 图标名。也可以通过 `slot="selected-icon"` 设置
711
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-selected-icon
712
+ */
713
+ 'selected-icon'?: string;
714
+ /**
715
+ * 右侧的 Material Icons 图标名。也可以通过 `slot="end-icon"` 设置
716
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-end-icon
717
+ */
718
+ 'end-icon'?: string;
719
+ /**
720
+ * 可删除时,右侧删除图标的 Material Icons 图标名。也可以通过 `slot="delete-icon"` 设置
721
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-delete-icon
722
+ */
723
+ 'delete-icon'?: string;
724
+ /**
725
+ * 链接的目标 URL。
726
+ *
727
+ * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。
728
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-href
729
+ */
730
+ 'href'?: string;
731
+ /**
732
+ * 下载链接的目标。
733
+ *
734
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
735
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-download
736
+ */
737
+ 'download'?: string;
738
+ /**
739
+ * 链接的打开方式。可选值包括:
740
+ *
741
+ * * `_blank`:在新窗口中打开链接
742
+ * * `_parent`:在父框架中打开链接
743
+ * * `_self`:默认。在当前框架中打开链接
744
+ * * `_top`:在整个窗口中打开链接
745
+ *
746
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
747
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-target
748
+ */
749
+ 'target'?: '_blank' | '_parent' | '_self' | '_top';
750
+ /**
751
+ * 当前文档与被链接文档之间的关系。可选值包括:
752
+ *
753
+ * * `alternate`:当前文档的替代版本
754
+ * * `author`:当前文档或文章的作者
755
+ * * `bookmark`:永久链接到最近的祖先章节
756
+ * * `external`:引用的文档与当前文档不在同一站点
757
+ * * `help`:链接到相关的帮助文档
758
+ * * `license`:当前文档的主要内容由被引用文件的版权许可覆盖
759
+ * * `me`:当前文档代表链接内容的所有者
760
+ * * `next`:当前文档是系列中的一部分,被引用的文档是系列的下一个文档
761
+ * * `nofollow`:当前文档的作者或发布者不认可被引用的文件
762
+ * * `noreferrer`:不包含 `Referer` 头。类似于 `noopener` 的效果
763
+ * * `opener`:如果超链接会创建一个顶级浏览上下文(即 `target` 属性值为 `_blank`),则创建一个辅助浏览上下文
764
+ * * `prev`:当前文档是系列的一部分,被引用的文档是系列的上一个文档
765
+ * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面
766
+ * * `tag`:提供一个适用于当前文档的标签(由给定地址识别)
767
+ *
768
+ * **Note**:仅在指定了 `href` 属性时可用。
769
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-rel
770
+ */
771
+ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag';
772
+ /**
773
+ * 是否在页面加载完成后自动获取焦点
774
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-autofocus
775
+ */
776
+ 'autofocus'?: boolean;
777
+ /**
778
+ * 元素在使用 Tab 键切换焦点时的顺序
779
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-tabindex
780
+ */
781
+ 'tabindex'?: number;
782
+ /**
783
+ * 是否禁用
784
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-disabled
785
+ */
786
+ 'disabled'?: boolean;
787
+ /**
788
+ * 是否处于加载中状态
789
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-loading
790
+ */
791
+ 'loading'?: boolean;
792
+ /**
793
+ * 按钮的名称,将与表单数据一起提交。
794
+ *
795
+ * **Note**:仅在未设置 `href` 属性时,此属性才有效。
796
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-name
797
+ */
798
+ 'name'?: string;
799
+ /**
800
+ * 按钮的初始值,将与表单数据一起提交。
801
+ *
802
+ * **Note**:仅在未设置 `href` 属性时,此属性才有效。
803
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-value
804
+ */
805
+ 'value'?: string;
806
+ /**
807
+ * 按钮的类型。默认类型为 `button`。可选类型包括:
808
+ *
809
+ * * `submit`:点击按钮会提交表单数据到服务器
810
+ * * `reset`:点击按钮会将表单中的所有字段重置为初始值
811
+ * * `button`:此类型的按钮没有默认行为
812
+ *
813
+ * **Note**:仅在未指定 `href` 属性时,此属性才有效。
814
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-type
815
+ */
816
+ 'type'?: 'submit' | 'reset' | 'button';
817
+ /**
818
+ * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
819
+ *
820
+ * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
821
+ *
822
+ * **Note**:仅在未指定 `href` 属性时,此属性才有效。
823
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-form
824
+ */
825
+ 'form'?: string;
826
+ /**
827
+ * 指定提交表单的 URL。
828
+ *
829
+ * 如果指定了此属性,将覆盖 `<form>` 元素的 `action` 属性。
830
+ *
831
+ * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。
832
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-formaction
833
+ */
834
+ 'formaction'?: string;
835
+ /**
836
+ * 指定提交表单到服务器的内容类型。可选值包括:
837
+ *
838
+ * * `application/x-www-form-urlencoded`:未指定该属性时的默认值
839
+ * * `multipart/form-data`:当表单包含 `<input type="file">` 元素时使用
840
+ * * `text/plain`:HTML5 新增,用于调试
841
+ *
842
+ * 如果指定了此属性,将覆盖 `<form>` 元素的 `enctype` 属性。
843
+ *
844
+ * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。
845
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-formenctype
846
+ */
847
+ 'formenctype'?: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain';
848
+ /**
849
+ * 指定提交表单时使用的 HTTP 方法。可选值包括:
850
+ *
851
+ * * `post`:表单数据包含在表单内容中,发送到服务器
852
+ * * `get`:表单数据以 `?` 作为分隔符附加到表单的 URI 属性中,生成的 URI 发送到服务器。当表单没有副作用,并且仅包含 ASCII 字符时,使用此方法
853
+ *
854
+ * 如果设置了此属性,将覆盖 `<form>` 元素的 `method` 属性。
855
+ *
856
+ * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
857
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-formmethod
858
+ */
859
+ 'formmethod'?: 'post' | 'get';
860
+ /**
861
+ * 如果设置了此属性,表单提交时将不执行表单验证。
862
+ *
863
+ * 如果设置了此属性,将覆盖 `<form>` 元素的 `novalidate` 属性。
864
+ *
865
+ * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
866
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-formnovalidate
867
+ */
868
+ 'formnovalidate'?: boolean;
869
+ /**
870
+ * 提交表单后接收到的响应应显示在何处。可选值包括:
871
+ *
872
+ * * `_self`:默认选项,在当前框架中打开
873
+ * * `_blank`:在新窗口中打开
874
+ * * `_parent`:在父框架中打开
875
+ * * `_top`:在整个窗口中打开
876
+ *
877
+ * 如果设置了此属性,将覆盖 `<form>` 元素的 `target` 属性。
878
+ *
879
+ * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
880
+ * @see https://www.mdui.org/zh-cn/docs/2/components/chip#attributes-formtarget
881
+ */
882
+ 'formtarget'?: '_self' | '_blank' | '_parent' | '_top';
883
+ } & HTMLElementProps;
884
+ /**
885
+ * 圆形进度指示器组件
886
+ *
887
+ * ```html
888
+ * <mdui-circular-progress></mdui-circular-progress>
889
+ * ```
890
+ * @see https://www.mdui.org/zh-cn/docs/2/components/circular-progress
891
+ */
892
+ 'mdui-circular-progress': {
893
+ /**
894
+ * 进度指示器的最大值。默认为 `1`
895
+ * @see https://www.mdui.org/zh-cn/docs/2/components/circular-progress#attributes-max
896
+ */
897
+ 'max'?: number;
898
+ /**
899
+ * 进度指示器的当前值。如果未指定该值,则显示为不确定状态
900
+ * @see https://www.mdui.org/zh-cn/docs/2/components/circular-progress#attributes-value
901
+ */
902
+ 'value'?: number;
903
+ } & HTMLElementProps;
904
+ /**
905
+ * 折叠面板组件,需配合 `<mdui-collapse-item>` 组件使用
906
+ *
907
+ * ```html
908
+ * <mdui-collapse>
909
+ * <mdui-collapse-item header="header-1">content-1</mdui-collapse-item>
910
+ * <mdui-collapse-item header="header-2">content-2</mdui-collapse-item>
911
+ * </mdui-collapse>
912
+ * ```
913
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse
914
+ */
915
+ 'mdui-collapse': {
916
+ /**
917
+ * 是否启用手风琴模式
918
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-attributes-accordion
919
+ */
920
+ 'accordion'?: boolean;
921
+ /**
922
+ * 当前展开的 `<mdui-collapse-item>` 的值
923
+ *
924
+ * **Note**:该属性的 HTML 属性始终为字符串,只有在 `accordion` 为 `true` 时,才能设置初始值;该属性的 JavaScript 属性值在 `accordion` 为 `true` 时为字符串,在 `accordion` 为 `false` 时为字符串数组。因此,当 `accordion` 为 `false` 时,只能通过修改 JavaScript 属性值来改变此值。
925
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-attributes-value
926
+ */
927
+ 'value'?: string | string[];
928
+ /**
929
+ * 是否禁用此折叠面板
930
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-attributes-disabled
931
+ */
932
+ 'disabled'?: boolean;
933
+ } & HTMLElementProps;
934
+ /**
935
+ * 折叠面板项组件,需配合 `<mdui-collapse>` 组件使用
936
+ *
937
+ * ```html
938
+ * <mdui-collapse>
939
+ * <mdui-collapse-item header="header-1">content-1</mdui-collapse-item>
940
+ * <mdui-collapse-item header="header-2">content-2</mdui-collapse-item>
941
+ * </mdui-collapse>
942
+ * ```
943
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse
944
+ */
945
+ 'mdui-collapse-item': {
946
+ /**
947
+ * 此折叠面板项的值
948
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-item-attributes-value
949
+ */
950
+ 'value'?: string;
951
+ /**
952
+ * 此折叠面板项的头部文本
953
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-item-attributes-header
954
+ */
955
+ 'header'?: string;
956
+ /**
957
+ * 是否禁用此折叠面板项
958
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-item-attributes-disabled
959
+ */
960
+ 'disabled'?: boolean;
961
+ /**
962
+ * 点击该元素时触发折叠,值可以是 CSS 选择器、DOM 元素、或 [JQ 对象](https://www.mdui.org/zh-cn/docs/2/functions/jq)。默认为点击整个 header 区域触发
963
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-item-attributes-trigger
964
+ */
965
+ 'trigger'?: string | HTMLElement | JQ<HTMLElement>;
966
+ } & HTMLElementProps;
967
+ /**
968
+ * 对话框组件
969
+ *
970
+ * ```html
971
+ * <mdui-dialog>content</mdui-dialog>
972
+ * ```
973
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dialog
974
+ */
975
+ 'mdui-dialog': {
976
+ /**
977
+ * 顶部的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
978
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-icon
979
+ */
980
+ 'icon'?: string;
981
+ /**
982
+ * 标题。也可以通过 `slot="headline"` 设置
983
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-headline
984
+ */
985
+ 'headline'?: string;
986
+ /**
987
+ * 标题下方的文本。也可以通过 `slot="description"` 设置
988
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-description
989
+ */
990
+ 'description'?: string;
991
+ /**
992
+ * 是否打开对话框
993
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-open
994
+ */
995
+ 'open'?: boolean;
996
+ /**
997
+ * 是否全屏显示对话框
998
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-fullscreen
999
+ */
1000
+ 'fullscreen'?: boolean;
1001
+ /**
1002
+ * 是否允许按下 ESC 键关闭对话框
1003
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-close-on-esc
1004
+ */
1005
+ 'close-on-esc'?: boolean;
1006
+ /**
1007
+ * 是否允许点击遮罩层关闭对话框
1008
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-close-on-overlay-click
1009
+ */
1010
+ 'close-on-overlay-click'?: boolean;
1011
+ /**
1012
+ * 是否垂直排列底部操作按钮
1013
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dialog#attributes-stacked-actions
1014
+ */
1015
+ 'stacked-actions'?: boolean;
1016
+ } & HTMLElementProps;
1017
+ /**
1018
+ * 分割线组件
1019
+ *
1020
+ * ```html
1021
+ * <mdui-divider></mdui-divider>
1022
+ * ```
1023
+ * @see https://www.mdui.org/zh-cn/docs/2/components/divider
1024
+ */
1025
+ 'mdui-divider': {
1026
+ /**
1027
+ * 是否为垂直分割线
1028
+ * @see https://www.mdui.org/zh-cn/docs/2/components/divider#attributes-vertical
1029
+ */
1030
+ 'vertical'?: boolean;
1031
+ /**
1032
+ * 是否进行左侧缩进
1033
+ * @see https://www.mdui.org/zh-cn/docs/2/components/divider#attributes-inset
1034
+ */
1035
+ 'inset'?: boolean;
1036
+ /**
1037
+ * 是否进行左右两侧缩进
1038
+ * @see https://www.mdui.org/zh-cn/docs/2/components/divider#attributes-middle
1039
+ */
1040
+ 'middle'?: boolean;
1041
+ } & HTMLElementProps;
1042
+ /**
1043
+ * 下拉组件
1044
+ *
1045
+ * ```html
1046
+ * <mdui-dropdown>
1047
+ * <mdui-button slot="trigger">open dropdown</mdui-button>
1048
+ * <mdui-menu>
1049
+ * <mdui-menu-item>Item 1</mdui-menu-item>
1050
+ * <mdui-menu-item>Item 2</mdui-menu-item>
1051
+ * </mdui-menu>
1052
+ * </mdui-dropdown>
1053
+ * ```
1054
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown
1055
+ */
1056
+ 'mdui-dropdown': {
1057
+ /**
1058
+ * 是否打开下拉组件
1059
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-open
1060
+ */
1061
+ 'open'?: boolean;
1062
+ /**
1063
+ * 是否禁用下拉组件
1064
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-disabled
1065
+ */
1066
+ 'disabled'?: boolean;
1067
+ /**
1068
+ * 下拉组件的触发方式,支持多个值,用空格分隔。可选值包括:
1069
+ *
1070
+ * * `click`:点击触发
1071
+ * * `hover`:鼠标悬浮触发
1072
+ * * `focus`:聚焦触发
1073
+ * * `contextmenu`:鼠标右键点击、或触摸长按触发
1074
+ * * `manual`:仅能通过编程方式打开和关闭下拉组件,不能再指定其他触发方式
1075
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-trigger
1076
+ */
1077
+ 'trigger'?: 'click' | 'hover' | 'focus' | 'contextmenu' | 'manual' | string;
1078
+ /**
1079
+ * 下拉组件内容的位置。可选值包括:
1080
+ *
1081
+ * * `auto`:自动判断位置
1082
+ * * `top-start`:上方左对齐
1083
+ * * `top`:上方居中
1084
+ * * `top-end`:上方右对齐
1085
+ * * `bottom-start`:下方左对齐
1086
+ * * `bottom`:下方居中
1087
+ * * `bottom-end`:下方右对齐
1088
+ * * `left-start`:左侧顶部对齐
1089
+ * * `left`:左侧居中
1090
+ * * `left-end`:左侧底部对齐
1091
+ * * `right-start`:右侧顶部对齐
1092
+ * * `right`:右侧居中
1093
+ * * `right-end`:右侧底部对齐
1094
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-placement
1095
+ */
1096
+ 'placement'?: 'auto' | 'top-start' | 'top' | 'top-end' | 'bottom-start' | 'bottom' | 'bottom-end' | 'left-start' | 'left' | 'left-end' | 'right-start' | 'right' | 'right-end';
1097
+ /**
1098
+ * 点击 [`<mdui-menu-item>`](https://www.mdui.org/zh-cn/docs/2/components/menu#menu-item-api) 后,下拉组件是否保持打开状态
1099
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-stay-open-on-click
1100
+ */
1101
+ 'stay-open-on-click'?: boolean;
1102
+ /**
1103
+ * 鼠标悬浮触发下拉组件打开的延时,单位为毫秒
1104
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-open-delay
1105
+ */
1106
+ 'open-delay'?: number;
1107
+ /**
1108
+ * 鼠标悬浮触发下拉组件关闭的延时,单位为毫秒
1109
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-close-delay
1110
+ */
1111
+ 'close-delay'?: number;
1112
+ /**
1113
+ * 是否在触发下拉组件的光标位置打开下拉组件,常用于打开鼠标右键菜单
1114
+ * @see https://www.mdui.org/zh-cn/docs/2/components/dropdown#attributes-open-on-pointer
1115
+ */
1116
+ 'open-on-pointer'?: boolean;
1117
+ } & HTMLElementProps;
1118
+ /**
1119
+ * 浮动操作按钮组件
1120
+ *
1121
+ * ```html
1122
+ * <mdui-fab icon="edit"></mdui-fab>
1123
+ * ```
1124
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab
1125
+ */
1126
+ 'mdui-fab': {
1127
+ /**
1128
+ * FAB 的形状,此组件的不同形状之间只有颜色不一样。可选值包括:
1129
+ *
1130
+ * * `primary`:使用 Primary container 背景色
1131
+ * * `surface`:使用 Surface container high 背景色
1132
+ * * `secondary`:使用 Secondary container 背景色
1133
+ * * `tertiary`:使用 Tertiary container 背景色
1134
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-variant
1135
+ */
1136
+ 'variant'?: 'primary' | 'surface' | 'secondary' | 'tertiary';
1137
+ /**
1138
+ * FAB 的大小。可选值包括:
1139
+ * * `normal`:普通大小 FAB
1140
+ * * `small`:小型 FAB
1141
+ * * `large`:大型 FAB
1142
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-size
1143
+ */
1144
+ 'size'?: 'normal' | 'small' | 'large';
1145
+ /**
1146
+ * Material Icons 图标名。也可以通过 `slot="icon"` 设置
1147
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-icon
1148
+ */
1149
+ 'icon'?: string;
1150
+ /**
1151
+ * 是否为展开状态
1152
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-extended
1153
+ */
1154
+ 'extended'?: boolean;
1155
+ /**
1156
+ * 链接的目标 URL。
1157
+ *
1158
+ * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。
1159
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-href
1160
+ */
1161
+ 'href'?: string;
1162
+ /**
1163
+ * 下载链接的目标。
1164
+ *
1165
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
1166
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-download
1167
+ */
1168
+ 'download'?: string;
1169
+ /**
1170
+ * 链接的打开方式。可选值包括:
1171
+ *
1172
+ * * `_blank`:在新窗口中打开链接
1173
+ * * `_parent`:在父框架中打开链接
1174
+ * * `_self`:默认。在当前框架中打开链接
1175
+ * * `_top`:在整个窗口中打开链接
1176
+ *
1177
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
1178
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-target
1179
+ */
1180
+ 'target'?: '_blank' | '_parent' | '_self' | '_top';
1181
+ /**
1182
+ * 当前文档与被链接文档之间的关系。可选值包括:
1183
+ *
1184
+ * * `alternate`:当前文档的替代版本
1185
+ * * `author`:当前文档或文章的作者
1186
+ * * `bookmark`:永久链接到最近的祖先章节
1187
+ * * `external`:引用的文档与当前文档不在同一站点
1188
+ * * `help`:链接到相关的帮助文档
1189
+ * * `license`:当前文档的主要内容由被引用文件的版权许可覆盖
1190
+ * * `me`:当前文档代表链接内容的所有者
1191
+ * * `next`:当前文档是系列中的一部分,被引用的文档是系列的下一个文档
1192
+ * * `nofollow`:当前文档的作者或发布者不认可被引用的文件
1193
+ * * `noreferrer`:不包含 `Referer` 头。类似于 `noopener` 的效果
1194
+ * * `opener`:如果超链接会创建一个顶级浏览上下文(即 `target` 属性值为 `_blank`),则创建一个辅助浏览上下文
1195
+ * * `prev`:当前文档是系列的一部分,被引用的文档是系列的上一个文档
1196
+ * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面
1197
+ * * `tag`:提供一个适用于当前文档的标签(由给定地址识别)
1198
+ *
1199
+ * **Note**:仅在指定了 `href` 属性时可用。
1200
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-rel
1201
+ */
1202
+ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag';
1203
+ /**
1204
+ * 是否在页面加载完成后自动获取焦点
1205
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-autofocus
1206
+ */
1207
+ 'autofocus'?: boolean;
1208
+ /**
1209
+ * 元素在使用 Tab 键切换焦点时的顺序
1210
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-tabindex
1211
+ */
1212
+ 'tabindex'?: number;
1213
+ /**
1214
+ * 是否禁用
1215
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-disabled
1216
+ */
1217
+ 'disabled'?: boolean;
1218
+ /**
1219
+ * 是否处于加载中状态
1220
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-loading
1221
+ */
1222
+ 'loading'?: boolean;
1223
+ /**
1224
+ * 按钮的名称,将与表单数据一起提交。
1225
+ *
1226
+ * **Note**:仅在未设置 `href` 属性时,此属性才有效。
1227
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-name
1228
+ */
1229
+ 'name'?: string;
1230
+ /**
1231
+ * 按钮的初始值,将与表单数据一起提交。
1232
+ *
1233
+ * **Note**:仅在未设置 `href` 属性时,此属性才有效。
1234
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-value
1235
+ */
1236
+ 'value'?: string;
1237
+ /**
1238
+ * 按钮的类型。默认类型为 `button`。可选类型包括:
1239
+ *
1240
+ * * `submit`:点击按钮会提交表单数据到服务器
1241
+ * * `reset`:点击按钮会将表单中的所有字段重置为初始值
1242
+ * * `button`:此类型的按钮没有默认行为
1243
+ *
1244
+ * **Note**:仅在未指定 `href` 属性时,此属性才有效。
1245
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-type
1246
+ */
1247
+ 'type'?: 'submit' | 'reset' | 'button';
1248
+ /**
1249
+ * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
1250
+ *
1251
+ * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
1252
+ *
1253
+ * **Note**:仅在未指定 `href` 属性时,此属性才有效。
1254
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-form
1255
+ */
1256
+ 'form'?: string;
1257
+ /**
1258
+ * 指定提交表单的 URL。
1259
+ *
1260
+ * 如果指定了此属性,将覆盖 `<form>` 元素的 `action` 属性。
1261
+ *
1262
+ * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。
1263
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-formaction
1264
+ */
1265
+ 'formaction'?: string;
1266
+ /**
1267
+ * 指定提交表单到服务器的内容类型。可选值包括:
1268
+ *
1269
+ * * `application/x-www-form-urlencoded`:未指定该属性时的默认值
1270
+ * * `multipart/form-data`:当表单包含 `<input type="file">` 元素时使用
1271
+ * * `text/plain`:HTML5 新增,用于调试
1272
+ *
1273
+ * 如果指定了此属性,将覆盖 `<form>` 元素的 `enctype` 属性。
1274
+ *
1275
+ * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。
1276
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-formenctype
1277
+ */
1278
+ 'formenctype'?: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain';
1279
+ /**
1280
+ * 指定提交表单时使用的 HTTP 方法。可选值包括:
1281
+ *
1282
+ * * `post`:表单数据包含在表单内容中,发送到服务器
1283
+ * * `get`:表单数据以 `?` 作为分隔符附加到表单的 URI 属性中,生成的 URI 发送到服务器。当表单没有副作用,并且仅包含 ASCII 字符时,使用此方法
1284
+ *
1285
+ * 如果设置了此属性,将覆盖 `<form>` 元素的 `method` 属性。
1286
+ *
1287
+ * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
1288
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-formmethod
1289
+ */
1290
+ 'formmethod'?: 'post' | 'get';
1291
+ /**
1292
+ * 如果设置了此属性,表单提交时将不执行表单验证。
1293
+ *
1294
+ * 如果设置了此属性,将覆盖 `<form>` 元素的 `novalidate` 属性。
1295
+ *
1296
+ * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
1297
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-formnovalidate
1298
+ */
1299
+ 'formnovalidate'?: boolean;
1300
+ /**
1301
+ * 提交表单后接收到的响应应显示在何处。可选值包括:
1302
+ *
1303
+ * * `_self`:默认选项,在当前框架中打开
1304
+ * * `_blank`:在新窗口中打开
1305
+ * * `_parent`:在父框架中打开
1306
+ * * `_top`:在整个窗口中打开
1307
+ *
1308
+ * 如果设置了此属性,将覆盖 `<form>` 元素的 `target` 属性。
1309
+ *
1310
+ * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
1311
+ * @see https://www.mdui.org/zh-cn/docs/2/components/fab#attributes-formtarget
1312
+ */
1313
+ 'formtarget'?: '_self' | '_blank' | '_parent' | '_top';
1314
+ } & HTMLElementProps;
1315
+ /**
1316
+ * 图标组件
1317
+ *
1318
+ * ```html
1319
+ * <mdui-icon name="search"></mdui-icon>
1320
+ * ```
1321
+ * @see https://www.mdui.org/zh-cn/docs/2/components/icon
1322
+ */
1323
+ 'mdui-icon': {
1324
+ /**
1325
+ * Material Icons 图标名
1326
+ * @see https://www.mdui.org/zh-cn/docs/2/components/icon#attributes-name
1327
+ */
1328
+ 'name'?: string;
1329
+ /**
1330
+ * svg 图标的路径
1331
+ * @see https://www.mdui.org/zh-cn/docs/2/components/icon#attributes-src
1332
+ */
1333
+ 'src'?: string;
1334
+ } & HTMLElementProps;
1335
+ /**
1336
+ * 布局组件
1337
+ *
1338
+ * ```html
1339
+ * <mdui-layout>
1340
+ * <mdui-layout-item></mdui-layout-item>
1341
+ * <mdui-layout-item></mdui-layout-item>
1342
+ * <mdui-layout-main></mdui-layout-main>
1343
+ * </mdui-layout>
1344
+ * ```
1345
+ * @see https://www.mdui.org/zh-cn/docs/2/components/layout
1346
+ */
1347
+ 'mdui-layout': {
1348
+ /**
1349
+ * 设置当前布局的高度为 100%
1350
+ * @see https://www.mdui.org/zh-cn/docs/2/components/layout#layout-attributes-full-height
1351
+ */
1352
+ 'full-height'?: boolean;
1353
+ } & HTMLElementProps;
1354
+ /**
1355
+ * 布局项组件
1356
+ *
1357
+ * ```html
1358
+ * <mdui-layout>
1359
+ * <mdui-layout-item></mdui-layout-item>
1360
+ * <mdui-layout-item></mdui-layout-item>
1361
+ * <mdui-layout-main></mdui-layout-main>
1362
+ * </mdui-layout>
1363
+ * ```
1364
+ * @see https://www.mdui.org/zh-cn/docs/2/components/layout
1365
+ */
1366
+ 'mdui-layout-item': {
1367
+ /**
1368
+ * 组件的位置。可选值包括:
1369
+ *
1370
+ * * `top`:上方
1371
+ * * `bottom`:下方
1372
+ * * `left`:左侧
1373
+ * * `right`:右侧
1374
+ * @see https://www.mdui.org/zh-cn/docs/2/components/layout#layout-item-attributes-placement
1375
+ */
1376
+ 'placement'?: 'top' | 'bottom' | 'left' | 'right';
1377
+ /**
1378
+ * 该组件在 [`<mdui-layout>`](https://www.mdui.org/zh-cn/docs/2/components/layout) 中的布局顺序,按从小到大排序。默认为 `0`
1379
+ * @see https://www.mdui.org/zh-cn/docs/2/components/layout#layout-item-attributes-order
1380
+ */
1381
+ 'order'?: number;
1382
+ } & HTMLElementProps;
1383
+ /**
1384
+ * 布局主体内容组件
1385
+ *
1386
+ * ```html
1387
+ * <mdui-layout>
1388
+ * <mdui-layout-item></mdui-layout-item>
1389
+ * <mdui-layout-item></mdui-layout-item>
1390
+ * <mdui-layout-main></mdui-layout-main>
1391
+ * </mdui-layout>
1392
+ * ```
1393
+ * @see https://www.mdui.org/zh-cn/docs/2/components/layout
1394
+ */
1395
+ 'mdui-layout-main': {
1396
+
1397
+ } & HTMLElementProps;
1398
+ /**
1399
+ * 线性进度指示器组件
1400
+ *
1401
+ * ```html
1402
+ * <mdui-linear-progress></mdui-linear-progress>
1403
+ * ```
1404
+ * @see https://www.mdui.org/zh-cn/docs/2/components/linear-progress
1405
+ */
1406
+ 'mdui-linear-progress': {
1407
+ /**
1408
+ * 进度指示器的最大值。默认为 `1`
1409
+ * @see https://www.mdui.org/zh-cn/docs/2/components/linear-progress#attributes-max
1410
+ */
1411
+ 'max'?: number;
1412
+ /**
1413
+ * 进度指示器的当前值。如果未指定该值,则处于不确定状态
1414
+ * @see https://www.mdui.org/zh-cn/docs/2/components/linear-progress#attributes-value
1415
+ */
1416
+ 'value'?: number;
1417
+ } & HTMLElementProps;
1418
+ /**
1419
+ * 列表组件。需配合 `<mdui-list-item>` 组件使用
1420
+ *
1421
+ * ```html
1422
+ * <mdui-list>
1423
+ * <mdui-list-subheader>Subheader</mdui-list-subheader>
1424
+ * <mdui-list-item>Item 1</mdui-list-item>
1425
+ * <mdui-list-item>Item 2</mdui-list-item>
1426
+ * </mdui-list>
1427
+ * ```
1428
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list
1429
+ */
1430
+ 'mdui-list': {
1431
+
1432
+ } & HTMLElementProps;
1433
+ /**
1434
+ * 列表项组件。需配合 `<mdui-list>` 组件使用
1435
+ *
1436
+ * ```html
1437
+ * <mdui-list>
1438
+ * <mdui-list-subheader>Subheader</mdui-list-subheader>
1439
+ * <mdui-list-item>Item 1</mdui-list-item>
1440
+ * <mdui-list-item>Item 2</mdui-list-item>
1441
+ * </mdui-list>
1442
+ * ```
1443
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list
1444
+ */
1445
+ 'mdui-list-item': {
1446
+ /**
1447
+ * 主文本。也可以通过 default slot 设置
1448
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-headline
1449
+ */
1450
+ 'headline'?: string;
1451
+ /**
1452
+ * 主文本行数,超过限制后将截断显示。默认无行数限制。可选值包括:
1453
+ *
1454
+ * * `1`:显示单行,超出后截断
1455
+ * * `2`:显示两行,超出后截断
1456
+ * * `3`:显示三行,超出后截断
1457
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-headline-line
1458
+ */
1459
+ 'headline-line'?: 1 | 2 | 3;
1460
+ /**
1461
+ * 副文本。也可以通过 `slot="description"` 设置
1462
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-description
1463
+ */
1464
+ 'description'?: string;
1465
+ /**
1466
+ * 副文本行数,超过限制后将截断显示。默认无行数限制。可选值包括:
1467
+ *
1468
+ * * `1`:显示单行,超出后截断
1469
+ * * `2`:显示两行,超出后截断
1470
+ * * `3`:显示三行,超出后截断
1471
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-description-line
1472
+ */
1473
+ 'description-line'?: 1 | 2 | 3;
1474
+ /**
1475
+ * 左侧的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
1476
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-icon
1477
+ */
1478
+ 'icon'?: string;
1479
+ /**
1480
+ * 右侧的 Material Icons 图标名。也可以通过 `slot="end-icon"` 设置
1481
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-end-icon
1482
+ */
1483
+ 'end-icon'?: string;
1484
+ /**
1485
+ * 是否禁用该列表项,禁用后,列表项将变为灰色,且其中的 [`<mdui-checkbox>`](https://www.mdui.org/zh-cn/docs/2/components/checkbox)、[`<mdui-radio>`](https://www.mdui.org/zh-cn/docs/2/components/radio)、[`<mdui-switch>`](https://www.mdui.org/zh-cn/docs/2/components/switch) 等也将禁用
1486
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-disabled
1487
+ */
1488
+ 'disabled'?: boolean;
1489
+ /**
1490
+ * 是否激活该列表项
1491
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-active
1492
+ */
1493
+ 'active'?: boolean;
1494
+ /**
1495
+ * 是否使列表项不可点击。设置后,列表项中的 [`<mdui-checkbox>`](https://www.mdui.org/zh-cn/docs/2/components/checkbox)、[`<mdui-radio>`](https://www.mdui.org/zh-cn/docs/2/components/radio)、[`<mdui-switch>`](https://www.mdui.org/zh-cn/docs/2/components/switch) 等仍可交互
1496
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-nonclickable
1497
+ */
1498
+ 'nonclickable'?: boolean;
1499
+ /**
1500
+ * 是否使用圆角形状的列表项
1501
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-rounded
1502
+ */
1503
+ 'rounded'?: boolean;
1504
+ /**
1505
+ * 列表项的垂直对齐方式。可选值包括:
1506
+ *
1507
+ * * `start`:顶部对齐
1508
+ * * `center`:居中对齐
1509
+ * * `end`:底部对齐
1510
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-alignment
1511
+ */
1512
+ 'alignment'?: 'start' | 'center' | 'end';
1513
+ /**
1514
+ * 链接的目标 URL。
1515
+ *
1516
+ * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。
1517
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-href
1518
+ */
1519
+ 'href'?: string;
1520
+ /**
1521
+ * 下载链接的目标。
1522
+ *
1523
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
1524
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-download
1525
+ */
1526
+ 'download'?: string;
1527
+ /**
1528
+ * 链接的打开方式。可选值包括:
1529
+ *
1530
+ * * `_blank`:在新窗口中打开链接
1531
+ * * `_parent`:在父框架中打开链接
1532
+ * * `_self`:默认。在当前框架中打开链接
1533
+ * * `_top`:在整个窗口中打开链接
1534
+ *
1535
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
1536
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-target
1537
+ */
1538
+ 'target'?: '_blank' | '_parent' | '_self' | '_top';
1539
+ /**
1540
+ * 当前文档与被链接文档之间的关系。可选值包括:
1541
+ *
1542
+ * * `alternate`:当前文档的替代版本
1543
+ * * `author`:当前文档或文章的作者
1544
+ * * `bookmark`:永久链接到最近的祖先章节
1545
+ * * `external`:引用的文档与当前文档不在同一站点
1546
+ * * `help`:链接到相关的帮助文档
1547
+ * * `license`:当前文档的主要内容由被引用文件的版权许可覆盖
1548
+ * * `me`:当前文档代表链接内容的所有者
1549
+ * * `next`:当前文档是系列中的一部分,被引用的文档是系列的下一个文档
1550
+ * * `nofollow`:当前文档的作者或发布者不认可被引用的文件
1551
+ * * `noreferrer`:不包含 `Referer` 头。类似于 `noopener` 的效果
1552
+ * * `opener`:如果超链接会创建一个顶级浏览上下文(即 `target` 属性值为 `_blank`),则创建一个辅助浏览上下文
1553
+ * * `prev`:当前文档是系列的一部分,被引用的文档是系列的上一个文档
1554
+ * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面
1555
+ * * `tag`:提供一个适用于当前文档的标签(由给定地址识别)
1556
+ *
1557
+ * **Note**:仅在指定了 `href` 属性时可用。
1558
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-rel
1559
+ */
1560
+ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag';
1561
+ /**
1562
+ * 是否在页面加载完成后自动获取焦点
1563
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-autofocus
1564
+ */
1565
+ 'autofocus'?: boolean;
1566
+ /**
1567
+ * 元素在使用 Tab 键切换焦点时的顺序
1568
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list#list-item-attributes-tabindex
1569
+ */
1570
+ 'tabindex'?: number;
1571
+ } & HTMLElementProps;
1572
+ /**
1573
+ * 列表标题组件。需配合 `<mdui-list>` 组件使用
1574
+ *
1575
+ * ```html
1576
+ * <mdui-list>
1577
+ * <mdui-list-subheader>Subheader</mdui-list-subheader>
1578
+ * <mdui-list-item>Item 1</mdui-list-item>
1579
+ * <mdui-list-item>Item 2</mdui-list-item>
1580
+ * </mdui-list>
1581
+ * ```
1582
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list
1583
+ */
1584
+ 'mdui-list-subheader': {
1585
+
1586
+ } & HTMLElementProps;
1587
+ /**
1588
+ * 菜单组件。需配合 `<mdui-menu-item>` 组件使用
1589
+ *
1590
+ * ```html
1591
+ * <mdui-menu>
1592
+ * <mdui-menu-item>Item 1</mdui-menu-item>
1593
+ * <mdui-menu-item>Item 2</mdui-menu-item>
1594
+ * </mdui-menu>
1595
+ * ```
1596
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu
1597
+ */
1598
+ 'mdui-menu': {
1599
+ /**
1600
+ * 菜单项的可选状态。默认不可选。可选值包括:
1601
+ *
1602
+ * * `single`:单选
1603
+ * * `multiple`:多选
1604
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-attributes-selects
1605
+ */
1606
+ 'selects'?: 'single' | 'multiple';
1607
+ /**
1608
+ * 当前选中的 `<mdui-menu-item>` 的值。
1609
+ *
1610
+ * **Note**:该属性的 HTML 属性始终为字符串,仅在 `selects="single"` 时可通过 HTML 属性设置初始值;该属性的 JavaScript 属性值在 `selects="single"` 时为字符串,在 `selects="multiple"` 时为字符串数组。因此,在 `selects="multiple"` 时,若要修改该值,只能通过修改 JavaScript 属性值实现。
1611
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-attributes-value
1612
+ */
1613
+ 'value'?: string | string[];
1614
+ /**
1615
+ * 菜单项是否使用紧凑布局
1616
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-attributes-dense
1617
+ */
1618
+ 'dense'?: boolean;
1619
+ /**
1620
+ * 子菜单的触发方式,支持多个值,用空格分隔。可选值包括:
1621
+ *
1622
+ * * `click`:点击菜单项时打开子菜单
1623
+ * * `hover`:鼠标悬浮到菜单项上时打开子菜单
1624
+ * * `focus`:聚焦到菜单项上时打开子菜单
1625
+ * * `manual`:仅能通过编程方式打开和关闭子菜单,不能再指定其他触发方式
1626
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-attributes-submenu-trigger
1627
+ */
1628
+ 'submenu-trigger'?: 'click' | 'hover' | 'focus' | 'manual' | string;
1629
+ /**
1630
+ * 鼠标悬浮触发子菜单打开的延时,单位毫秒
1631
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-attributes-submenu-open-delay
1632
+ */
1633
+ 'submenu-open-delay'?: number;
1634
+ /**
1635
+ * 鼠标悬浮触发子菜单关闭的延时,单位毫秒
1636
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-attributes-submenu-close-delay
1637
+ */
1638
+ 'submenu-close-delay'?: number;
1639
+ } & HTMLElementProps;
1640
+ /**
1641
+ * 菜单项组件。需配合 `<mdui-menu>` 组件使用
1642
+ *
1643
+ * ```html
1644
+ * <mdui-menu>
1645
+ * <mdui-menu-item>Item 1</mdui-menu-item>
1646
+ * <mdui-menu-item>Item 2</mdui-menu-item>
1647
+ * </mdui-menu>
1648
+ * ```
1649
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu
1650
+ */
1651
+ 'mdui-menu-item': {
1652
+ /**
1653
+ * 菜单项的值
1654
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-item-attributes-value
1655
+ */
1656
+ 'value'?: string;
1657
+ /**
1658
+ * 是否禁用菜单项
1659
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-item-attributes-disabled
1660
+ */
1661
+ 'disabled'?: boolean;
1662
+ /**
1663
+ * 左侧的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
1664
+ *
1665
+ * 如果左侧不需要显示图标,但需要预留一个图标的位置,可传入空字符串进行占位
1666
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-item-attributes-icon
1667
+ */
1668
+ 'icon'?: string;
1669
+ /**
1670
+ * 右侧的 Material Icons 图标名。也可以通过 `slot="end-icon"` 设置
1671
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-item-attributes-end-icon
1672
+ */
1673
+ 'end-icon'?: string;
1674
+ /**
1675
+ * 右侧的文本。也可以通过 `slot="end-text"` 设置
1676
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-item-attributes-end-text
1677
+ */
1678
+ 'end-text'?: string;
1679
+ /**
1680
+ * 选中状态的 Material Icons 图标名。也可以通过 `slot="selected-icon"` 设置
1681
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-item-attributes-selected-icon
1682
+ */
1683
+ 'selected-icon'?: string;
1684
+ /**
1685
+ * 是否打开子菜单
1686
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-item-attributes-submenu-open
1687
+ */
1688
+ 'submenu-open'?: boolean;
1689
+ /**
1690
+ * 链接的目标 URL。
1691
+ *
1692
+ * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。
1693
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-item-attributes-href
1694
+ */
1695
+ 'href'?: string;
1696
+ /**
1697
+ * 下载链接的目标。
1698
+ *
1699
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
1700
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-item-attributes-download
1701
+ */
1702
+ 'download'?: string;
1703
+ /**
1704
+ * 链接的打开方式。可选值包括:
1705
+ *
1706
+ * * `_blank`:在新窗口中打开链接
1707
+ * * `_parent`:在父框架中打开链接
1708
+ * * `_self`:默认。在当前框架中打开链接
1709
+ * * `_top`:在整个窗口中打开链接
1710
+ *
1711
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
1712
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-item-attributes-target
1713
+ */
1714
+ 'target'?: '_blank' | '_parent' | '_self' | '_top';
1715
+ /**
1716
+ * 当前文档与被链接文档之间的关系。可选值包括:
1717
+ *
1718
+ * * `alternate`:当前文档的替代版本
1719
+ * * `author`:当前文档或文章的作者
1720
+ * * `bookmark`:永久链接到最近的祖先章节
1721
+ * * `external`:引用的文档与当前文档不在同一站点
1722
+ * * `help`:链接到相关的帮助文档
1723
+ * * `license`:当前文档的主要内容由被引用文件的版权许可覆盖
1724
+ * * `me`:当前文档代表链接内容的所有者
1725
+ * * `next`:当前文档是系列中的一部分,被引用的文档是系列的下一个文档
1726
+ * * `nofollow`:当前文档的作者或发布者不认可被引用的文件
1727
+ * * `noreferrer`:不包含 `Referer` 头。类似于 `noopener` 的效果
1728
+ * * `opener`:如果超链接会创建一个顶级浏览上下文(即 `target` 属性值为 `_blank`),则创建一个辅助浏览上下文
1729
+ * * `prev`:当前文档是系列的一部分,被引用的文档是系列的上一个文档
1730
+ * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面
1731
+ * * `tag`:提供一个适用于当前文档的标签(由给定地址识别)
1732
+ *
1733
+ * **Note**:仅在指定了 `href` 属性时可用。
1734
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-item-attributes-rel
1735
+ */
1736
+ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag';
1737
+ /**
1738
+ * 是否在页面加载完成后自动获取焦点
1739
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-item-attributes-autofocus
1740
+ */
1741
+ 'autofocus'?: boolean;
1742
+ /**
1743
+ * 元素在使用 Tab 键切换焦点时的顺序
1744
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-item-attributes-tabindex
1745
+ */
1746
+ 'tabindex'?: number;
1747
+ } & HTMLElementProps;
1748
+ /**
1749
+ * 底部导航栏组件。需配合 `<mdui-navigation-bar-item>` 组件使用
1750
+ *
1751
+ * ```html
1752
+ * <mdui-navigation-bar>
1753
+ * <mdui-navigation-bar-item icon="place">Item 1</mdui-navigation-bar-item>
1754
+ * <mdui-navigation-bar-item icon="commute">Item 2</mdui-navigation-bar-item>
1755
+ * <mdui-navigation-bar-item icon="people">Item 3</mdui-navigation-bar-item>
1756
+ * </mdui-navigation-bar>
1757
+ * ```
1758
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar
1759
+ */
1760
+ 'mdui-navigation-bar': {
1761
+ /**
1762
+ * 是否隐藏
1763
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-hide
1764
+ */
1765
+ 'hide'?: boolean;
1766
+ /**
1767
+ * 文本的可视状态。可选值包括:
1768
+ *
1769
+ * * `auto`:当选项小于等于3个时,始终显示文本;当选项大于3个时,仅显示选中状态的文本
1770
+ * * `selected`:仅在选中状态显示文本
1771
+ * * `labeled`:始终显示文本
1772
+ * * `unlabeled`:始终不显示文本
1773
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-label-visibility
1774
+ */
1775
+ 'label-visibility'?: 'auto' | 'selected' | 'labeled' | 'unlabeled';
1776
+ /**
1777
+ * 当前选中的 `<mdui-navigation-bar-item>` 的值
1778
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-value
1779
+ */
1780
+ 'value'?: string;
1781
+ /**
1782
+ * 滚动行为。可选值包括:
1783
+ *
1784
+ * * `hide`:滚动时隐藏
1785
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-scroll-behavior
1786
+ */
1787
+ 'scroll-behavior'?: 'hide';
1788
+ /**
1789
+ * 需要监听其滚动事件的元素。值可以是 CSS 选择器、DOM 元素、或 [JQ 对象](https://www.mdui.org/zh-cn/docs/2/functions/jq)。默认监听 `window` 的滚动事件
1790
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-scroll-target
1791
+ */
1792
+ 'scroll-target'?: string | HTMLElement | JQ<HTMLElement>;
1793
+ /**
1794
+ * 在滚动多少距离之后触发滚动行为,单位为 `px`
1795
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-scroll-threshold
1796
+ */
1797
+ 'scroll-threshold'?: number;
1798
+ /**
1799
+ * 该组件在 [`<mdui-layout>`](https://www.mdui.org/zh-cn/docs/2/components/layout) 中的布局顺序,按从小到大排序。默认为 `0`
1800
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-order
1801
+ */
1802
+ 'order'?: number;
1803
+ } & HTMLElementProps;
1804
+ /**
1805
+ * 底部导航栏项组件。需配合 `<mdui-navigation-bar>` 组件使用
1806
+ *
1807
+ * ```html
1808
+ * <mdui-navigation-bar>
1809
+ * <mdui-navigation-bar-item icon="place">Item 1</mdui-navigation-bar-item>
1810
+ * <mdui-navigation-bar-item icon="commute">Item 2</mdui-navigation-bar-item>
1811
+ * <mdui-navigation-bar-item icon="people">Item 3</mdui-navigation-bar-item>
1812
+ * </mdui-navigation-bar>
1813
+ * ```
1814
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar
1815
+ */
1816
+ 'mdui-navigation-bar-item': {
1817
+ /**
1818
+ * 未激活状态的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
1819
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-item-attributes-icon
1820
+ */
1821
+ 'icon'?: string;
1822
+ /**
1823
+ * 激活状态的 Material Icons 图标名。也可以通过 `slot="active-icon"` 设置
1824
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-item-attributes-active-icon
1825
+ */
1826
+ 'active-icon'?: string;
1827
+ /**
1828
+ * 导航项的值
1829
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-item-attributes-value
1830
+ */
1831
+ 'value'?: string;
1832
+ /**
1833
+ * 链接的目标 URL。
1834
+ *
1835
+ * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。
1836
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-item-attributes-href
1837
+ */
1838
+ 'href'?: string;
1839
+ /**
1840
+ * 下载链接的目标。
1841
+ *
1842
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
1843
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-item-attributes-download
1844
+ */
1845
+ 'download'?: string;
1846
+ /**
1847
+ * 链接的打开方式。可选值包括:
1848
+ *
1849
+ * * `_blank`:在新窗口中打开链接
1850
+ * * `_parent`:在父框架中打开链接
1851
+ * * `_self`:默认。在当前框架中打开链接
1852
+ * * `_top`:在整个窗口中打开链接
1853
+ *
1854
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
1855
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-item-attributes-target
1856
+ */
1857
+ 'target'?: '_blank' | '_parent' | '_self' | '_top';
1858
+ /**
1859
+ * 当前文档与被链接文档之间的关系。可选值包括:
1860
+ *
1861
+ * * `alternate`:当前文档的替代版本
1862
+ * * `author`:当前文档或文章的作者
1863
+ * * `bookmark`:永久链接到最近的祖先章节
1864
+ * * `external`:引用的文档与当前文档不在同一站点
1865
+ * * `help`:链接到相关的帮助文档
1866
+ * * `license`:当前文档的主要内容由被引用文件的版权许可覆盖
1867
+ * * `me`:当前文档代表链接内容的所有者
1868
+ * * `next`:当前文档是系列中的一部分,被引用的文档是系列的下一个文档
1869
+ * * `nofollow`:当前文档的作者或发布者不认可被引用的文件
1870
+ * * `noreferrer`:不包含 `Referer` 头。类似于 `noopener` 的效果
1871
+ * * `opener`:如果超链接会创建一个顶级浏览上下文(即 `target` 属性值为 `_blank`),则创建一个辅助浏览上下文
1872
+ * * `prev`:当前文档是系列的一部分,被引用的文档是系列的上一个文档
1873
+ * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面
1874
+ * * `tag`:提供一个适用于当前文档的标签(由给定地址识别)
1875
+ *
1876
+ * **Note**:仅在指定了 `href` 属性时可用。
1877
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-item-attributes-rel
1878
+ */
1879
+ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag';
1880
+ /**
1881
+ * 是否在页面加载完成后自动获取焦点
1882
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-item-attributes-autofocus
1883
+ */
1884
+ 'autofocus'?: boolean;
1885
+ /**
1886
+ * 元素在使用 Tab 键切换焦点时的顺序
1887
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-item-attributes-tabindex
1888
+ */
1889
+ 'tabindex'?: number;
1890
+ } & HTMLElementProps;
1891
+ /**
1892
+ * 侧边抽屉栏组件
1893
+ *
1894
+ * ```html
1895
+ * <mdui-navigation-drawer>content</mdui-navigation-drawer>
1896
+ * ```
1897
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-drawer
1898
+ */
1899
+ 'mdui-navigation-drawer': {
1900
+ /**
1901
+ * 是否打开抽屉栏
1902
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-drawer#attributes-open
1903
+ */
1904
+ 'open'?: boolean;
1905
+ /**
1906
+ * 抽屉栏打开时,是否显示遮罩层
1907
+ *
1908
+ * 在窄屏设备上(屏幕宽度小于 [`--mdui-breakpoint-md`](https://www.mdui.org/zh-cn/docs/2/styles/design-tokens#breakpoint)),会始终显示遮罩层,无视该参数
1909
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-drawer#attributes-modal
1910
+ */
1911
+ 'modal'?: boolean;
1912
+ /**
1913
+ * 在有遮罩层的情况下,按下 ESC 键是否关闭抽屉栏
1914
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-drawer#attributes-close-on-esc
1915
+ */
1916
+ 'close-on-esc'?: boolean;
1917
+ /**
1918
+ * 点击遮罩层时,是否关闭抽屉栏
1919
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-drawer#attributes-close-on-overlay-click
1920
+ */
1921
+ 'close-on-overlay-click'?: boolean;
1922
+ /**
1923
+ * 抽屉栏的位置。可选值包括:
1924
+ *
1925
+ * * `left`:左侧
1926
+ * * `right`:右侧
1927
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-drawer#attributes-placement
1928
+ */
1929
+ 'placement'?: 'left' | 'right';
1930
+ /**
1931
+ * 默认情况下,抽屉栏相对于 `body` 元素显示。当该参数设置为 `true` 时,抽屉栏将相对于其父元素显示。
1932
+ *
1933
+ * **Note**:设置该属性时,必须在父元素上手动设置样式 `position: relative; overflow: hidden;`。
1934
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-drawer#attributes-contained
1935
+ */
1936
+ 'contained'?: boolean;
1937
+ /**
1938
+ * 该组件在 [`<mdui-layout>`](https://www.mdui.org/zh-cn/docs/2/components/layout) 中的布局顺序,按从小到大排序。默认为 `0`
1939
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-drawer#attributes-order
1940
+ */
1941
+ 'order'?: number;
1942
+ } & HTMLElementProps;
1943
+ /**
1944
+ * 侧边导航栏组件。需配合 `<mdui-navigation-rail-item>` 组件使用
1945
+ *
1946
+ * ```html
1947
+ * <mdui-navigation-rail>
1948
+ * <mdui-navigation-rail-item icon="watch_later">Recent</mdui-navigation-rail-item>
1949
+ * <mdui-navigation-rail-item icon="image">Images</mdui-navigation-rail-item>
1950
+ * <mdui-navigation-rail-item icon="library_music">Library</mdui-navigation-rail-item>
1951
+ * </mdui-navigation-rail>
1952
+ * ```
1953
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail
1954
+ */
1955
+ 'mdui-navigation-rail': {
1956
+ /**
1957
+ * 当前选中的 `<mdui-navigation-rail-item>` 的值
1958
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-attributes-value
1959
+ */
1960
+ 'value'?: string;
1961
+ /**
1962
+ * 导航栏的位置。可选值包括:
1963
+ *
1964
+ * * `left`:左侧
1965
+ * * `right`:右侧
1966
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-attributes-placement
1967
+ */
1968
+ 'placement'?: 'left' | 'right';
1969
+ /**
1970
+ * `<mdui-navigation-rail-item>` 元素的对齐方式。可选值包括:
1971
+ *
1972
+ * * `start`:顶部对齐
1973
+ * * `center`:居中对齐
1974
+ * * `end`:底部对齐
1975
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-attributes-alignment
1976
+ */
1977
+ 'alignment'?: 'start' | 'center' | 'end';
1978
+ /**
1979
+ * 默认情况下,导航栏相对于 `body` 元素显示。当该参数设置为 `true` 时,导航栏将相对于其父元素显示。
1980
+ *
1981
+ * **Note**:设置该属性时,必须在父元素上手动设置样式 `position: relative;`。
1982
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-attributes-contained
1983
+ */
1984
+ 'contained'?: boolean;
1985
+ /**
1986
+ * 是否在导航栏和页面内容之间添加分割线
1987
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-attributes-divider
1988
+ */
1989
+ 'divider'?: boolean;
1990
+ /**
1991
+ * 该组件在 [`<mdui-layout>`](https://www.mdui.org/zh-cn/docs/2/components/layout) 中的布局顺序,按从小到大排序。默认为 `0`
1992
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-attributes-order
1993
+ */
1994
+ 'order'?: number;
1995
+ } & HTMLElementProps;
1996
+ /**
1997
+ * 侧边导航项组件。需配合 `<mdui-navigation-rail>` 组件使用
1998
+ *
1999
+ * ```html
2000
+ * <mdui-navigation-rail>
2001
+ * <mdui-navigation-rail-item icon="watch_later">Recent</mdui-navigation-rail-item>
2002
+ * <mdui-navigation-rail-item icon="image">Images</mdui-navigation-rail-item>
2003
+ * <mdui-navigation-rail-item icon="library_music">Library</mdui-navigation-rail-item>
2004
+ * </mdui-navigation-rail>
2005
+ * ```
2006
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail
2007
+ */
2008
+ 'mdui-navigation-rail-item': {
2009
+ /**
2010
+ * 未激活状态下的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
2011
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-item-attributes-icon
2012
+ */
2013
+ 'icon'?: string;
2014
+ /**
2015
+ * 激活状态下的 Material Icons 图标名。也可以通过 `slot="active-icon"` 设置
2016
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-item-attributes-active-icon
2017
+ */
2018
+ 'active-icon'?: string;
2019
+ /**
2020
+ * 导航项的值
2021
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-item-attributes-value
2022
+ */
2023
+ 'value'?: string;
2024
+ /**
2025
+ * 链接的目标 URL。
2026
+ *
2027
+ * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。
2028
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-item-attributes-href
2029
+ */
2030
+ 'href'?: string;
2031
+ /**
2032
+ * 下载链接的目标。
2033
+ *
2034
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
2035
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-item-attributes-download
2036
+ */
2037
+ 'download'?: string;
2038
+ /**
2039
+ * 链接的打开方式。可选值包括:
2040
+ *
2041
+ * * `_blank`:在新窗口中打开链接
2042
+ * * `_parent`:在父框架中打开链接
2043
+ * * `_self`:默认。在当前框架中打开链接
2044
+ * * `_top`:在整个窗口中打开链接
2045
+ *
2046
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
2047
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-item-attributes-target
2048
+ */
2049
+ 'target'?: '_blank' | '_parent' | '_self' | '_top';
2050
+ /**
2051
+ * 当前文档与被链接文档之间的关系。可选值包括:
2052
+ *
2053
+ * * `alternate`:当前文档的替代版本
2054
+ * * `author`:当前文档或文章的作者
2055
+ * * `bookmark`:永久链接到最近的祖先章节
2056
+ * * `external`:引用的文档与当前文档不在同一站点
2057
+ * * `help`:链接到相关的帮助文档
2058
+ * * `license`:当前文档的主要内容由被引用文件的版权许可覆盖
2059
+ * * `me`:当前文档代表链接内容的所有者
2060
+ * * `next`:当前文档是系列中的一部分,被引用的文档是系列的下一个文档
2061
+ * * `nofollow`:当前文档的作者或发布者不认可被引用的文件
2062
+ * * `noreferrer`:不包含 `Referer` 头。类似于 `noopener` 的效果
2063
+ * * `opener`:如果超链接会创建一个顶级浏览上下文(即 `target` 属性值为 `_blank`),则创建一个辅助浏览上下文
2064
+ * * `prev`:当前文档是系列的一部分,被引用的文档是系列的上一个文档
2065
+ * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面
2066
+ * * `tag`:提供一个适用于当前文档的标签(由给定地址识别)
2067
+ *
2068
+ * **Note**:仅在指定了 `href` 属性时可用。
2069
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-item-attributes-rel
2070
+ */
2071
+ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag';
2072
+ /**
2073
+ * 是否在页面加载完成后自动获取焦点
2074
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-item-attributes-autofocus
2075
+ */
2076
+ 'autofocus'?: boolean;
2077
+ /**
2078
+ * 元素在使用 Tab 键切换焦点时的顺序
2079
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-item-attributes-tabindex
2080
+ */
2081
+ 'tabindex'?: number;
2082
+ } & HTMLElementProps;
2083
+ /**
2084
+ * 单选框组件。需配合 `<mdui-radio-group>` 组件使用
2085
+ *
2086
+ * ```html
2087
+ * <mdui-radio-group value="chinese">
2088
+ * <mdui-radio value="chinese">Chinese</mdui-radio>
2089
+ * <mdui-radio value="english">English</mdui-radio>
2090
+ * </mdui-radio-group>
2091
+ * ```
2092
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio
2093
+ */
2094
+ 'mdui-radio': {
2095
+ /**
2096
+ * 当前单选项的值
2097
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-attributes-value
2098
+ */
2099
+ 'value'?: string;
2100
+ /**
2101
+ * 是否禁用当前单选项
2102
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-attributes-disabled
2103
+ */
2104
+ 'disabled'?: boolean;
2105
+ /**
2106
+ * 当前单选项是否已选中
2107
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-attributes-checked
2108
+ */
2109
+ 'checked'?: boolean;
2110
+ /**
2111
+ * 未选中状态的 Material Icons 图标名。也可以通过 `slot="unchecked-icon"` 设置
2112
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-attributes-unchecked-icon
2113
+ */
2114
+ 'unchecked-icon'?: string;
2115
+ /**
2116
+ * 选中状态的 Material Icons 图标名。也可以通过 `slot="checked-icon"` 设置
2117
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-attributes-checked-icon
2118
+ */
2119
+ 'checked-icon'?: string;
2120
+ /**
2121
+ * 是否在页面加载完成后自动获取焦点
2122
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-attributes-autofocus
2123
+ */
2124
+ 'autofocus'?: boolean;
2125
+ /**
2126
+ * 元素在使用 Tab 键切换焦点时的顺序
2127
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-attributes-tabindex
2128
+ */
2129
+ 'tabindex'?: number;
2130
+ } & HTMLElementProps;
2131
+ /**
2132
+ * 单选框组组件。需配合 `<mdui-radio>` 组件使用
2133
+ *
2134
+ * ```html
2135
+ * <mdui-radio-group value="chinese">
2136
+ * <mdui-radio value="chinese">Chinese</mdui-radio>
2137
+ * <mdui-radio value="english">English</mdui-radio>
2138
+ * </mdui-radio-group>
2139
+ * ```
2140
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio
2141
+ */
2142
+ 'mdui-radio-group': {
2143
+ /**
2144
+ * 是否禁用此组件
2145
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-group-attributes-disabled
2146
+ */
2147
+ 'disabled'?: boolean;
2148
+ /**
2149
+ * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
2150
+ *
2151
+ * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
2152
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-group-attributes-form
2153
+ */
2154
+ 'form'?: string;
2155
+ /**
2156
+ * 单选框组的名称,将与表单数据一起提交
2157
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-group-attributes-name
2158
+ */
2159
+ 'name'?: string;
2160
+ /**
2161
+ * 单选框组的名称,将于表单数据一起提交
2162
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-group-attributes-value
2163
+ */
2164
+ 'value'?: string;
2165
+ /**
2166
+ * 提交表单时,是否必须选中其中一个单选框
2167
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-group-attributes-required
2168
+ */
2169
+ 'required'?: boolean;
2170
+ } & HTMLElementProps;
2171
+ /**
2172
+ * 范围滑块组件
2173
+ *
2174
+ * ```html
2175
+ * <mdui-range-slider></mdui-range-slider>
2176
+ * ```
2177
+ * @see https://www.mdui.org/zh-cn/docs/2/components/range-slider
2178
+ */
2179
+ 'mdui-range-slider': {
2180
+ /**
2181
+ * 是否在页面加载完成后自动获取焦点
2182
+ * @see https://www.mdui.org/zh-cn/docs/2/components/range-slider#attributes-autofocus
2183
+ */
2184
+ 'autofocus'?: boolean;
2185
+ /**
2186
+ * 元素在使用 Tab 键切换焦点时的顺序
2187
+ * @see https://www.mdui.org/zh-cn/docs/2/components/range-slider#attributes-tabindex
2188
+ */
2189
+ 'tabindex'?: number;
2190
+ /**
2191
+ * 滑块的最小值,默认为 `0`
2192
+ * @see https://www.mdui.org/zh-cn/docs/2/components/range-slider#attributes-min
2193
+ */
2194
+ 'min'?: number;
2195
+ /**
2196
+ * 滑块的最大值,默认为 `100`
2197
+ * @see https://www.mdui.org/zh-cn/docs/2/components/range-slider#attributes-max
2198
+ */
2199
+ 'max'?: number;
2200
+ /**
2201
+ * 步进间隔,默认为 `1`
2202
+ * @see https://www.mdui.org/zh-cn/docs/2/components/range-slider#attributes-step
2203
+ */
2204
+ 'step'?: number;
2205
+ /**
2206
+ * 是否添加刻度标记
2207
+ * @see https://www.mdui.org/zh-cn/docs/2/components/range-slider#attributes-tickmarks
2208
+ */
2209
+ 'tickmarks'?: boolean;
2210
+ /**
2211
+ * 是否隐藏文本提示
2212
+ * @see https://www.mdui.org/zh-cn/docs/2/components/range-slider#attributes-nolabel
2213
+ */
2214
+ 'nolabel'?: boolean;
2215
+ /**
2216
+ * 是否被禁用
2217
+ * @see https://www.mdui.org/zh-cn/docs/2/components/range-slider#attributes-disabled
2218
+ */
2219
+ 'disabled'?: boolean;
2220
+ /**
2221
+ * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
2222
+ *
2223
+ * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
2224
+ * @see https://www.mdui.org/zh-cn/docs/2/components/range-slider#attributes-form
2225
+ */
2226
+ 'form'?: string;
2227
+ /**
2228
+ * 滑块的名称,该名称将与表单数据一起提交
2229
+ * @see https://www.mdui.org/zh-cn/docs/2/components/range-slider#attributes-name
2230
+ */
2231
+ 'name'?: string;
2232
+ } & HTMLElementProps;
2233
+ /**
2234
+ * 分段按钮项组件。需配合 `<mdui-segmented-button-group>` 组件使用
2235
+ *
2236
+ * ```html
2237
+ * <mdui-segmented-button-group>
2238
+ * <mdui-segmented-button>Day</mdui-segmented-button>
2239
+ * <mdui-segmented-button>Week</mdui-segmented-button>
2240
+ * <mdui-segmented-button>Month</mdui-segmented-button>
2241
+ * </mdui-segmented-button-group>
2242
+ * ```
2243
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button
2244
+ */
2245
+ 'mdui-segmented-button': {
2246
+ /**
2247
+ * 左侧的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
2248
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-icon
2249
+ */
2250
+ 'icon'?: string;
2251
+ /**
2252
+ * 右侧的 Material Icons 图标名。也可以通过 `slot="end-icon"` 设置
2253
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-end-icon
2254
+ */
2255
+ 'end-icon'?: string;
2256
+ /**
2257
+ * 选中状态的 Material Icons 图标名。也可以通过 `slot="selected-icon"` 设置
2258
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-selected-icon
2259
+ */
2260
+ 'selected-icon'?: string;
2261
+ /**
2262
+ * 链接的目标 URL。
2263
+ *
2264
+ * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。
2265
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-href
2266
+ */
2267
+ 'href'?: string;
2268
+ /**
2269
+ * 下载链接的目标。
2270
+ *
2271
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
2272
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-download
2273
+ */
2274
+ 'download'?: string;
2275
+ /**
2276
+ * 链接的打开方式。可选值包括:
2277
+ *
2278
+ * * `_blank`:在新窗口中打开链接
2279
+ * * `_parent`:在父框架中打开链接
2280
+ * * `_self`:默认。在当前框架中打开链接
2281
+ * * `_top`:在整个窗口中打开链接
2282
+ *
2283
+ * **Note**:仅在设置了 `href` 属性时,此属性才有效。
2284
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-target
2285
+ */
2286
+ 'target'?: '_blank' | '_parent' | '_self' | '_top';
2287
+ /**
2288
+ * 当前文档与被链接文档之间的关系。可选值包括:
2289
+ *
2290
+ * * `alternate`:当前文档的替代版本
2291
+ * * `author`:当前文档或文章的作者
2292
+ * * `bookmark`:永久链接到最近的祖先章节
2293
+ * * `external`:引用的文档与当前文档不在同一站点
2294
+ * * `help`:链接到相关的帮助文档
2295
+ * * `license`:当前文档的主要内容由被引用文件的版权许可覆盖
2296
+ * * `me`:当前文档代表链接内容的所有者
2297
+ * * `next`:当前文档是系列中的一部分,被引用的文档是系列的下一个文档
2298
+ * * `nofollow`:当前文档的作者或发布者不认可被引用的文件
2299
+ * * `noreferrer`:不包含 `Referer` 头。类似于 `noopener` 的效果
2300
+ * * `opener`:如果超链接会创建一个顶级浏览上下文(即 `target` 属性值为 `_blank`),则创建一个辅助浏览上下文
2301
+ * * `prev`:当前文档是系列的一部分,被引用的文档是系列的上一个文档
2302
+ * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面
2303
+ * * `tag`:提供一个适用于当前文档的标签(由给定地址识别)
2304
+ *
2305
+ * **Note**:仅在指定了 `href` 属性时可用。
2306
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-rel
2307
+ */
2308
+ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag';
2309
+ /**
2310
+ * 是否在页面加载完成后自动获取焦点
2311
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-autofocus
2312
+ */
2313
+ 'autofocus'?: boolean;
2314
+ /**
2315
+ * 元素在使用 Tab 键切换焦点时的顺序
2316
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-tabindex
2317
+ */
2318
+ 'tabindex'?: number;
2319
+ /**
2320
+ * 是否禁用
2321
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-disabled
2322
+ */
2323
+ 'disabled'?: boolean;
2324
+ /**
2325
+ * 是否处于加载中状态
2326
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-loading
2327
+ */
2328
+ 'loading'?: boolean;
2329
+ /**
2330
+ * 按钮的名称,将与表单数据一起提交。
2331
+ *
2332
+ * **Note**:仅在未设置 `href` 属性时,此属性才有效。
2333
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-name
2334
+ */
2335
+ 'name'?: string;
2336
+ /**
2337
+ * 按钮的初始值,将与表单数据一起提交。
2338
+ *
2339
+ * **Note**:仅在未设置 `href` 属性时,此属性才有效。
2340
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-value
2341
+ */
2342
+ 'value'?: string;
2343
+ /**
2344
+ * 按钮的类型。默认类型为 `button`。可选类型包括:
2345
+ *
2346
+ * * `submit`:点击按钮会提交表单数据到服务器
2347
+ * * `reset`:点击按钮会将表单中的所有字段重置为初始值
2348
+ * * `button`:此类型的按钮没有默认行为
2349
+ *
2350
+ * **Note**:仅在未指定 `href` 属性时,此属性才有效。
2351
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-type
2352
+ */
2353
+ 'type'?: 'submit' | 'reset' | 'button';
2354
+ /**
2355
+ * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
2356
+ *
2357
+ * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
2358
+ *
2359
+ * **Note**:仅在未指定 `href` 属性时,此属性才有效。
2360
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-form
2361
+ */
2362
+ 'form'?: string;
2363
+ /**
2364
+ * 指定提交表单的 URL。
2365
+ *
2366
+ * 如果指定了此属性,将覆盖 `<form>` 元素的 `action` 属性。
2367
+ *
2368
+ * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。
2369
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-formaction
2370
+ */
2371
+ 'formaction'?: string;
2372
+ /**
2373
+ * 指定提交表单到服务器的内容类型。可选值包括:
2374
+ *
2375
+ * * `application/x-www-form-urlencoded`:未指定该属性时的默认值
2376
+ * * `multipart/form-data`:当表单包含 `<input type="file">` 元素时使用
2377
+ * * `text/plain`:HTML5 新增,用于调试
2378
+ *
2379
+ * 如果指定了此属性,将覆盖 `<form>` 元素的 `enctype` 属性。
2380
+ *
2381
+ * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。
2382
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-formenctype
2383
+ */
2384
+ 'formenctype'?: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain';
2385
+ /**
2386
+ * 指定提交表单时使用的 HTTP 方法。可选值包括:
2387
+ *
2388
+ * * `post`:表单数据包含在表单内容中,发送到服务器
2389
+ * * `get`:表单数据以 `?` 作为分隔符附加到表单的 URI 属性中,生成的 URI 发送到服务器。当表单没有副作用,并且仅包含 ASCII 字符时,使用此方法
2390
+ *
2391
+ * 如果设置了此属性,将覆盖 `<form>` 元素的 `method` 属性。
2392
+ *
2393
+ * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
2394
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-formmethod
2395
+ */
2396
+ 'formmethod'?: 'post' | 'get';
2397
+ /**
2398
+ * 如果设置了此属性,表单提交时将不执行表单验证。
2399
+ *
2400
+ * 如果设置了此属性,将覆盖 `<form>` 元素的 `novalidate` 属性。
2401
+ *
2402
+ * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
2403
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-formnovalidate
2404
+ */
2405
+ 'formnovalidate'?: boolean;
2406
+ /**
2407
+ * 提交表单后接收到的响应应显示在何处。可选值包括:
2408
+ *
2409
+ * * `_self`:默认选项,在当前框架中打开
2410
+ * * `_blank`:在新窗口中打开
2411
+ * * `_parent`:在父框架中打开
2412
+ * * `_top`:在整个窗口中打开
2413
+ *
2414
+ * 如果设置了此属性,将覆盖 `<form>` 元素的 `target` 属性。
2415
+ *
2416
+ * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
2417
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-attributes-formtarget
2418
+ */
2419
+ 'formtarget'?: '_self' | '_blank' | '_parent' | '_top';
2420
+ } & HTMLElementProps;
2421
+ /**
2422
+ * 分段按钮组件。需配合 `<mdui-segmented-button>` 组件使用
2423
+ *
2424
+ * ```html
2425
+ * <mdui-segmented-button-group>
2426
+ * <mdui-segmented-button>Day</mdui-segmented-button>
2427
+ * <mdui-segmented-button>Week</mdui-segmented-button>
2428
+ * <mdui-segmented-button>Month</mdui-segmented-button>
2429
+ * </mdui-segmented-button-group>
2430
+ * ```
2431
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button
2432
+ */
2433
+ 'mdui-segmented-button-group': {
2434
+ /**
2435
+ * 是否填满父元素宽度
2436
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-group-attributes-full-width
2437
+ */
2438
+ 'full-width'?: boolean;
2439
+ /**
2440
+ * 分段按钮的可选中状态,默认为不可选中。可选值包括:
2441
+ *
2442
+ * * `single`:单选
2443
+ * * `multiple`:多选
2444
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-group-attributes-selects
2445
+ */
2446
+ 'selects'?: 'single' | 'multiple';
2447
+ /**
2448
+ * 是否为禁用状态
2449
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-group-attributes-disabled
2450
+ */
2451
+ 'disabled'?: boolean;
2452
+ /**
2453
+ * 提交表单时,是否必须选中
2454
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-group-attributes-required
2455
+ */
2456
+ 'required'?: boolean;
2457
+ /**
2458
+ * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
2459
+ *
2460
+ * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
2461
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-group-attributes-form
2462
+ */
2463
+ 'form'?: string;
2464
+ /**
2465
+ * 提交表单时的名称,将与表单数据一起提交
2466
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-group-attributes-name
2467
+ */
2468
+ 'name'?: string;
2469
+ /**
2470
+ * 当前选中的 `<mdui-segmented-button>` 的值。
2471
+ *
2472
+ * **Note**:该属性的 HTML 属性始终为字符串,且仅在 `selects="single"` 时可以通过 HTML 属性设置初始值。该属性的 JavaScript 属性值在 `selects="single"` 时为字符串,在 `selects="multiple"` 时为字符串数组。所以,在 `selects="multiple"` 时,如果要修改该值,只能通过修改 JavaScript 属性值实现。
2473
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-group-attributes-value
2474
+ */
2475
+ 'value'?: string | string[];
2476
+ } & HTMLElementProps;
2477
+ /**
2478
+ * 选择框组件。需配合 `<mdui-menu-item>` 组件使用
2479
+ *
2480
+ * ```html
2481
+ * <mdui-select>
2482
+ * <mdui-menu-item value="item-1">Item 1</mdui-menu-item>
2483
+ * <mdui-menu-item value="item-2">Item 2</mdui-menu-item>
2484
+ * </mdui-select>
2485
+ * ```
2486
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select
2487
+ */
2488
+ 'mdui-select': {
2489
+ /**
2490
+ * 选择框的样式。可选值包括:
2491
+ *
2492
+ * * `filled`:带背景色的选择框,视觉效果较强
2493
+ * * `outlined`:带边框的选择框,视觉效果较弱
2494
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-variant
2495
+ */
2496
+ 'variant'?: 'filled' | 'outlined';
2497
+ /**
2498
+ * 是否支持多选
2499
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-multiple
2500
+ */
2501
+ 'multiple'?: boolean;
2502
+ /**
2503
+ * 选择框的名称,将与表单数据一起提交
2504
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-name
2505
+ */
2506
+ 'name'?: string;
2507
+ /**
2508
+ * 选择框的值,将与表单数据一起提交。
2509
+ *
2510
+ * 如果未指定 `multiple` 属性,该值为字符串;如果指定了 `multiple` 属性,该值为字符串数组。HTML 属性只能设置字符串值;如果需要设置数组值,请通过 JavaScript 属性设置。
2511
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-value
2512
+ */
2513
+ 'value'?: string | string[];
2514
+ /**
2515
+ * 标签文本
2516
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-label
2517
+ */
2518
+ 'label'?: string;
2519
+ /**
2520
+ * 占位符文本
2521
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-placeholder
2522
+ */
2523
+ 'placeholder'?: string;
2524
+ /**
2525
+ * 选择框底部的帮助文本。也可以通过 `slot="helper"` 设置
2526
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-helper
2527
+ */
2528
+ 'helper'?: string;
2529
+ /**
2530
+ * 是否可以清空选择框
2531
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-clearable
2532
+ */
2533
+ 'clearable'?: boolean;
2534
+ /**
2535
+ * 当选择框可清空时,显示在选择框右侧的清空按钮的 Material Icons 图标名。也可以通过 `slot="clear-icon"` 设置
2536
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-clear-icon
2537
+ */
2538
+ 'clear-icon'?: string;
2539
+ /**
2540
+ * 选择框的位置。可选值包括:
2541
+ *
2542
+ * * `auto`:自动判断位置
2543
+ * * `bottom`:位于下方
2544
+ * * `top`:位于上方
2545
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-placement
2546
+ */
2547
+ 'placement'?: 'auto' | 'bottom' | 'top';
2548
+ /**
2549
+ * 文本是否右对齐
2550
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-end-aligned
2551
+ */
2552
+ 'end-aligned'?: boolean;
2553
+ /**
2554
+ * 选择框的前缀文本。仅在聚焦状态,或选择框有值时才会显示。也可以通过 `slot="prefix"` 设置
2555
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-prefix
2556
+ */
2557
+ 'prefix'?: string;
2558
+ /**
2559
+ * 选择框的后缀文本。仅在聚焦状态,或选择框有值时才会显示。也可以通过 `slot="suffix"` 设置
2560
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-suffix
2561
+ */
2562
+ 'suffix'?: string;
2563
+ /**
2564
+ * 选择框的前缀图标的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
2565
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-icon
2566
+ */
2567
+ 'icon'?: string;
2568
+ /**
2569
+ * 选择框的后缀图标的 Material Icons 图标名。也可以通过 `slot="end-icon"` 设置
2570
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-end-icon
2571
+ */
2572
+ 'end-icon'?: string;
2573
+ /**
2574
+ * 表单字段验证失败时,显示在选择框右侧的 Material Icons 图标名。也可以通过 `slot="error-icon"` 设置
2575
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-error-icon
2576
+ */
2577
+ 'error-icon'?: string;
2578
+ /**
2579
+ * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
2580
+ *
2581
+ * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
2582
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-form
2583
+ */
2584
+ 'form'?: string;
2585
+ /**
2586
+ * 是否为只读状态
2587
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-readonly
2588
+ */
2589
+ 'readonly'?: boolean;
2590
+ /**
2591
+ * 是否为禁用状态
2592
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-disabled
2593
+ */
2594
+ 'disabled'?: boolean;
2595
+ /**
2596
+ * 提交表单时,是否必须填写该字段
2597
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-required
2598
+ */
2599
+ 'required'?: boolean;
2600
+ /**
2601
+ * 是否在页面加载完成后自动获取焦点
2602
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-autofocus
2603
+ */
2604
+ 'autofocus'?: boolean;
2605
+ /**
2606
+ * 元素在使用 Tab 键切换焦点时的顺序
2607
+ * @see https://www.mdui.org/zh-cn/docs/2/components/select#attributes-tabindex
2608
+ */
2609
+ 'tabindex'?: number;
2610
+ } & HTMLElementProps;
2611
+ /**
2612
+ * 滑块组件
2613
+ *
2614
+ * ```html
2615
+ * <mdui-slider></mdui-slider>
2616
+ * ```
2617
+ * @see https://www.mdui.org/zh-cn/docs/2/components/slider
2618
+ */
2619
+ 'mdui-slider': {
2620
+ /**
2621
+ * 滑块的值,将于表单数据一起提交
2622
+ * @see https://www.mdui.org/zh-cn/docs/2/components/slider#attributes-value
2623
+ */
2624
+ 'value'?: number;
2625
+ /**
2626
+ * 是否在页面加载完成后自动获取焦点
2627
+ * @see https://www.mdui.org/zh-cn/docs/2/components/slider#attributes-autofocus
2628
+ */
2629
+ 'autofocus'?: boolean;
2630
+ /**
2631
+ * 元素在使用 Tab 键切换焦点时的顺序
2632
+ * @see https://www.mdui.org/zh-cn/docs/2/components/slider#attributes-tabindex
2633
+ */
2634
+ 'tabindex'?: number;
2635
+ /**
2636
+ * 滑块的最小值,默认为 `0`
2637
+ * @see https://www.mdui.org/zh-cn/docs/2/components/slider#attributes-min
2638
+ */
2639
+ 'min'?: number;
2640
+ /**
2641
+ * 滑块的最大值,默认为 `100`
2642
+ * @see https://www.mdui.org/zh-cn/docs/2/components/slider#attributes-max
2643
+ */
2644
+ 'max'?: number;
2645
+ /**
2646
+ * 步进间隔,默认为 `1`
2647
+ * @see https://www.mdui.org/zh-cn/docs/2/components/slider#attributes-step
2648
+ */
2649
+ 'step'?: number;
2650
+ /**
2651
+ * 是否添加刻度标记
2652
+ * @see https://www.mdui.org/zh-cn/docs/2/components/slider#attributes-tickmarks
2653
+ */
2654
+ 'tickmarks'?: boolean;
2655
+ /**
2656
+ * 是否隐藏文本提示
2657
+ * @see https://www.mdui.org/zh-cn/docs/2/components/slider#attributes-nolabel
2658
+ */
2659
+ 'nolabel'?: boolean;
2660
+ /**
2661
+ * 是否被禁用
2662
+ * @see https://www.mdui.org/zh-cn/docs/2/components/slider#attributes-disabled
2663
+ */
2664
+ 'disabled'?: boolean;
2665
+ /**
2666
+ * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
2667
+ *
2668
+ * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
2669
+ * @see https://www.mdui.org/zh-cn/docs/2/components/slider#attributes-form
2670
+ */
2671
+ 'form'?: string;
2672
+ /**
2673
+ * 滑块的名称,该名称将与表单数据一起提交
2674
+ * @see https://www.mdui.org/zh-cn/docs/2/components/slider#attributes-name
2675
+ */
2676
+ 'name'?: string;
2677
+ } & HTMLElementProps;
2678
+ /**
2679
+ * 消息条组件
2680
+ *
2681
+ * ```html
2682
+ * <mdui-snackbar>message</mdui-snackbar>
2683
+ * ```
2684
+ * @see https://www.mdui.org/zh-cn/docs/2/components/snackbar
2685
+ */
2686
+ 'mdui-snackbar': {
2687
+ /**
2688
+ * 是否显示 Snackbar
2689
+ * @see https://www.mdui.org/zh-cn/docs/2/components/snackbar#attributes-open
2690
+ */
2691
+ 'open'?: boolean;
2692
+ /**
2693
+ * Snackbar 的显示位置。默认为 `bottom`。可选值包括:
2694
+ *
2695
+ * * `top`:顶部居中
2696
+ * * `top-start`:顶部左对齐
2697
+ * * `top-end`:顶部右对齐
2698
+ * * `bottom`:底部居中
2699
+ * * `bottom-start`:底部左对齐
2700
+ * * `bottom-end`:底部右对齐
2701
+ * @see https://www.mdui.org/zh-cn/docs/2/components/snackbar#attributes-placement
2702
+ */
2703
+ 'placement'?: 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end';
2704
+ /**
2705
+ * 操作按钮的文本。也可以通过 `slot="action"` 设置操作按钮
2706
+ * @see https://www.mdui.org/zh-cn/docs/2/components/snackbar#attributes-action
2707
+ */
2708
+ 'action'?: string;
2709
+ /**
2710
+ * 操作按钮是否处于加载中状态
2711
+ * @see https://www.mdui.org/zh-cn/docs/2/components/snackbar#attributes-action-loading
2712
+ */
2713
+ 'action-loading'?: boolean;
2714
+ /**
2715
+ * 是否在右侧显示关闭按钮
2716
+ * @see https://www.mdui.org/zh-cn/docs/2/components/snackbar#attributes-closeable
2717
+ */
2718
+ 'closeable'?: boolean;
2719
+ /**
2720
+ * 关闭按钮的 Material Icons 图标名。也可以通过 `slot="close-icon"` 设置
2721
+ * @see https://www.mdui.org/zh-cn/docs/2/components/snackbar#attributes-close-icon
2722
+ */
2723
+ 'close-icon'?: string;
2724
+ /**
2725
+ * 消息文本的最大显示行数。默认不限制。可选值包括:
2726
+ *
2727
+ * * `1`:最多显示一行
2728
+ * * `2`:最多显示两行
2729
+ * @see https://www.mdui.org/zh-cn/docs/2/components/snackbar#attributes-message-line
2730
+ */
2731
+ 'message-line'?: 1 | 2;
2732
+ /**
2733
+ * 自动关闭的延迟时间(单位:毫秒)。设置为 `0` 则不自动关闭。默认为 5000 毫秒
2734
+ * @see https://www.mdui.org/zh-cn/docs/2/components/snackbar#attributes-auto-close-delay
2735
+ */
2736
+ 'auto-close-delay'?: number;
2737
+ /**
2738
+ * 点击或触摸 Snackbar 以外的区域时,是否关闭 Snackbar
2739
+ * @see https://www.mdui.org/zh-cn/docs/2/components/snackbar#attributes-close-on-outside-click
2740
+ */
2741
+ 'close-on-outside-click'?: boolean;
2742
+ } & HTMLElementProps;
2743
+ /**
2744
+ * 开关切换组件
2745
+ *
2746
+ * ```html
2747
+ * <mdui-switch></mdui-switch>
2748
+ * ```
2749
+ * @see https://www.mdui.org/zh-cn/docs/2/components/switch
2750
+ */
2751
+ 'mdui-switch': {
2752
+ /**
2753
+ * 是否为禁用状态
2754
+ * @see https://www.mdui.org/zh-cn/docs/2/components/switch#attributes-disabled
2755
+ */
2756
+ 'disabled'?: boolean;
2757
+ /**
2758
+ * 是否为选中状态
2759
+ * @see https://www.mdui.org/zh-cn/docs/2/components/switch#attributes-checked
2760
+ */
2761
+ 'checked'?: boolean;
2762
+ /**
2763
+ * 未选中状态的 Material Icons 图标名。也可以通过 `slot="unchecked-icon"` 设置
2764
+ * @see https://www.mdui.org/zh-cn/docs/2/components/switch#attributes-unchecked-icon
2765
+ */
2766
+ 'unchecked-icon'?: string;
2767
+ /**
2768
+ * 选中状态的 Material Icons 图标名。也可以通过 `slot="checked-icon"` 设置
2769
+ *
2770
+ * 默认为 `check` 图标,可传入空字符串移除默认图标
2771
+ * @see https://www.mdui.org/zh-cn/docs/2/components/switch#attributes-checked-icon
2772
+ */
2773
+ 'checked-icon'?: string;
2774
+ /**
2775
+ * 提交表单时,是否必须选中此开关
2776
+ * @see https://www.mdui.org/zh-cn/docs/2/components/switch#attributes-required
2777
+ */
2778
+ 'required'?: boolean;
2779
+ /**
2780
+ * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
2781
+ *
2782
+ * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
2783
+ * @see https://www.mdui.org/zh-cn/docs/2/components/switch#attributes-form
2784
+ */
2785
+ 'form'?: string;
2786
+ /**
2787
+ * 开关的名称,将与表单数据一起提交
2788
+ * @see https://www.mdui.org/zh-cn/docs/2/components/switch#attributes-name
2789
+ */
2790
+ 'name'?: string;
2791
+ /**
2792
+ * 开关的值,将于表单数据一起提交
2793
+ * @see https://www.mdui.org/zh-cn/docs/2/components/switch#attributes-value
2794
+ */
2795
+ 'value'?: string;
2796
+ /**
2797
+ * 是否在页面加载完成后自动获取焦点
2798
+ * @see https://www.mdui.org/zh-cn/docs/2/components/switch#attributes-autofocus
2799
+ */
2800
+ 'autofocus'?: boolean;
2801
+ /**
2802
+ * 元素在使用 Tab 键切换焦点时的顺序
2803
+ * @see https://www.mdui.org/zh-cn/docs/2/components/switch#attributes-tabindex
2804
+ */
2805
+ 'tabindex'?: number;
2806
+ } & HTMLElementProps;
2807
+ /**
2808
+ * 选项卡导航项组件。需配合 `<mdui-tabs>` 和 `<mdui-tab-panel>` 组件使用
2809
+ *
2810
+ * ```html
2811
+ * <mdui-tabs value="tab-1">
2812
+ * <mdui-tab value="tab-1">Tab 1</mdui-tab>
2813
+ * <mdui-tab value="tab-2">Tab 2</mdui-tab>
2814
+ * <mdui-tab value="tab-3">Tab 3</mdui-tab>
2815
+ *
2816
+ * <mdui-tab-panel slot="panel" value="tab-1">Panel 1</mdui-tab-panel>
2817
+ * <mdui-tab-panel slot="panel" value="tab-2">Panel 2</mdui-tab-panel>
2818
+ * <mdui-tab-panel slot="panel" value="tab-3">Panel 3</mdui-tab-panel>
2819
+ * </mdui-tabs>
2820
+ * ```
2821
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tabs
2822
+ */
2823
+ 'mdui-tab': {
2824
+ /**
2825
+ * 选项卡导航项的值
2826
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tabs#tab-attributes-value
2827
+ */
2828
+ 'value'?: string;
2829
+ /**
2830
+ * Material Icons 图标名。也可以通过 `slot="icon"` 设置
2831
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tabs#tab-attributes-icon
2832
+ */
2833
+ 'icon'?: string;
2834
+ /**
2835
+ * 是否把图标和文本水平排列
2836
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tabs#tab-attributes-inline
2837
+ */
2838
+ 'inline'?: boolean;
2839
+ /**
2840
+ * 是否在页面加载完成后自动获取焦点
2841
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tabs#tab-attributes-autofocus
2842
+ */
2843
+ 'autofocus'?: boolean;
2844
+ /**
2845
+ * 元素在使用 Tab 键切换焦点时的顺序
2846
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tabs#tab-attributes-tabindex
2847
+ */
2848
+ 'tabindex'?: number;
2849
+ } & HTMLElementProps;
2850
+ /**
2851
+ * 选项卡面板项组件。需配合 `<mdui-tabs>` 和 `<mdui-tab>` 组件使用
2852
+ *
2853
+ * ```html
2854
+ * <mdui-tabs value="tab-1">
2855
+ * <mdui-tab value="tab-1">Tab 1</mdui-tab>
2856
+ * <mdui-tab value="tab-2">Tab 2</mdui-tab>
2857
+ * <mdui-tab value="tab-3">Tab 3</mdui-tab>
2858
+ *
2859
+ * <mdui-tab-panel slot="panel" value="tab-1">Panel 1</mdui-tab-panel>
2860
+ * <mdui-tab-panel slot="panel" value="tab-2">Panel 2</mdui-tab-panel>
2861
+ * <mdui-tab-panel slot="panel" value="tab-3">Panel 3</mdui-tab-panel>
2862
+ * </mdui-tabs>
2863
+ * ```
2864
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tabs
2865
+ */
2866
+ 'mdui-tab-panel': {
2867
+ /**
2868
+ * 选项卡面板项的值
2869
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tabs#tab-panel-attributes-value
2870
+ */
2871
+ 'value'?: string;
2872
+ } & HTMLElementProps;
2873
+ /**
2874
+ * 选项卡组件。需配合 `<mdui-tab>` 和 `<mdui-tab-panel>` 组件使用
2875
+ *
2876
+ * ```html
2877
+ * <mdui-tabs value="tab-1">
2878
+ * <mdui-tab value="tab-1">Tab 1</mdui-tab>
2879
+ * <mdui-tab value="tab-2">Tab 2</mdui-tab>
2880
+ * <mdui-tab value="tab-3">Tab 3</mdui-tab>
2881
+ *
2882
+ * <mdui-tab-panel slot="panel" value="tab-1">Panel 1</mdui-tab-panel>
2883
+ * <mdui-tab-panel slot="panel" value="tab-2">Panel 2</mdui-tab-panel>
2884
+ * <mdui-tab-panel slot="panel" value="tab-3">Panel 3</mdui-tab-panel>
2885
+ * </mdui-tabs>
2886
+ * ```
2887
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tabs
2888
+ */
2889
+ 'mdui-tabs': {
2890
+ /**
2891
+ * 选项卡形状。可选值包括:
2892
+ *
2893
+ * * `primary`:适用于位于 `<mdui-top-app-bar>` 下方,用于切换应用的主页面的场景
2894
+ * * `secondary`:适用于位于页面中,用于切换一组相关内容的场景
2895
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tabs#tabs-attributes-variant
2896
+ */
2897
+ 'variant'?: 'primary' | 'secondary';
2898
+ /**
2899
+ * 当前激活的 `<mdui-tab>` 的值
2900
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tabs#tabs-attributes-value
2901
+ */
2902
+ 'value'?: string;
2903
+ /**
2904
+ * 选项卡位置。默认为 `top-start`。可选值包括:
2905
+ *
2906
+ * * `top-start`:位于上方,左对齐
2907
+ * * `top`:位于上方,居中对齐
2908
+ * * `top-end`:位于上方,右对齐
2909
+ * * `bottom-start`:位于下方,左对齐
2910
+ * * `bottom`:位于下方,居中对齐
2911
+ * * `bottom-end`:位于下方,右对齐
2912
+ * * `left-start`:位于左侧,顶部对齐
2913
+ * * `left`:位于左侧,居中对齐
2914
+ * * `left-end`:位于左侧,底部对齐
2915
+ * * `right-start`:位于右侧,顶部对齐
2916
+ * * `right`:位于右侧,居中对齐
2917
+ * * `right-end`:位于右侧,底部对齐
2918
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tabs#tabs-attributes-placement
2919
+ */
2920
+ 'placement'?: 'top-start' | 'top' | 'top-end' | 'bottom-start' | 'bottom' | 'bottom-end' | 'left-start' | 'left' | 'left-end' | 'right-start' | 'right' | 'right-end';
2921
+ /**
2922
+ * 是否填满父元素宽度
2923
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tabs#tabs-attributes-full-width
2924
+ */
2925
+ 'full-width'?: boolean;
2926
+ } & HTMLElementProps;
2927
+ /**
2928
+ * 文本框组件
2929
+ *
2930
+ * ```html
2931
+ * <mdui-text-field label="Text Field"></mdui-text-field>
2932
+ * ```
2933
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field
2934
+ */
2935
+ 'mdui-text-field': {
2936
+ /**
2937
+ * 文本框的形状。默认为 `filled`。可选值包括:
2938
+ *
2939
+ * * `filled`:带背景色的文本框,视觉效果较强
2940
+ * * `outlined`:带边框的文本框,视觉效果较弱
2941
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-variant
2942
+ */
2943
+ 'variant'?: 'filled' | 'outlined';
2944
+ /**
2945
+ * 文本框输入类型。默认为 `text`。可选值包括:
2946
+ *
2947
+ * * `text`:默认值。文本字段
2948
+ * * `number`:只能输入数字。拥有动态键盘的设备上会显示数字键盘
2949
+ * * `password`:用于输入密码,其值会被遮盖
2950
+ * * `url`:用于输入 URL,会验证 URL 格式。在支持动态键盘的设备上有相应的键盘
2951
+ * * `email`:用于输入邮箱地址,会验证邮箱格式。在支持动态键盘的设备上有相应的键盘
2952
+ * * `search`:用于搜索框。拥有动态键盘的设备上的回车图标会变成搜索图标
2953
+ * * `tel`:用于输入电话号码。拥有动态键盘的设备上会显示电话数字键盘
2954
+ * * `hidden`:隐藏该控件,但其值仍会提交到服务器
2955
+ * * `date`:输入日期的控件(年、月、日,不包括时间)。在支持的浏览器激活时打开日期选择器或年月日的数字滚轮
2956
+ * * `datetime-local`:输入日期和时间的控件,不包括时区。在支持的浏览器激活时打开日期选择器或年月日的数字滚轮
2957
+ * * `month`:输入年和月的控件,没有时区
2958
+ * * `time`:用于输入时间的控件,不包括时区
2959
+ * * `week`:用于输入以年和周数组成的日期,不带时区
2960
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-type
2961
+ */
2962
+ 'type'?: 'text' | 'number' | 'password' | 'url' | 'email' | 'search' | 'tel' | 'hidden' | 'date' | 'datetime-local' | 'month' | 'time' | 'week';
2963
+ /**
2964
+ * 文本框名称,将与表单数据一起提交
2965
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-name
2966
+ */
2967
+ 'name'?: string;
2968
+ /**
2969
+ * 文本框的值,将与表单数据一起提交
2970
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-value
2971
+ */
2972
+ 'value'?: string;
2973
+ /**
2974
+ * 标签文本
2975
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-label
2976
+ */
2977
+ 'label'?: string;
2978
+ /**
2979
+ * 占位符文本
2980
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-placeholder
2981
+ */
2982
+ 'placeholder'?: string;
2983
+ /**
2984
+ * 文本框底部的帮助文本。也可以通过 `slot="helper"` 设置
2985
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-helper
2986
+ */
2987
+ 'helper'?: string;
2988
+ /**
2989
+ * 是否仅在获得焦点时,显示底部的帮助文本
2990
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-helper-on-focus
2991
+ */
2992
+ 'helper-on-focus'?: boolean;
2993
+ /**
2994
+ * 是否可清空文本框内容
2995
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-clearable
2996
+ */
2997
+ 'clearable'?: boolean;
2998
+ /**
2999
+ * 可清空文本框时,显示在文本框右侧的清空按钮的 Material Icons 图标名。也可以通过 `slot="clear-icon"` 设置
3000
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-clear-icon
3001
+ */
3002
+ 'clear-icon'?: string;
3003
+ /**
3004
+ * 是否将文本右对齐
3005
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-end-aligned
3006
+ */
3007
+ 'end-aligned'?: boolean;
3008
+ /**
3009
+ * 文本框的前缀文本。只在文本框聚焦或有值时显示。也可以通过 `slot="prefix"` 设置
3010
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-prefix
3011
+ */
3012
+ 'prefix'?: string;
3013
+ /**
3014
+ * 文本框的后缀文本。只在文本框聚焦或有值时显示。也可以通过 `slot="suffix"` 设置
3015
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-suffix
3016
+ */
3017
+ 'suffix'?: string;
3018
+ /**
3019
+ * 文本框的前缀图标的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
3020
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-icon
3021
+ */
3022
+ 'icon'?: string;
3023
+ /**
3024
+ * 文本框的后缀图标的 Material Icons 图标名。也可以通过 `slot="end-icon"` 设置
3025
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-end-icon
3026
+ */
3027
+ 'end-icon'?: string;
3028
+ /**
3029
+ * 表单字段验证失败时,显示在文本框右侧的 Material Icons 图标名。也可以通过 `slot="error-icon"` 设置
3030
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-error-icon
3031
+ */
3032
+ 'error-icon'?: string;
3033
+ /**
3034
+ * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
3035
+ *
3036
+ * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
3037
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-form
3038
+ */
3039
+ 'form'?: string;
3040
+ /**
3041
+ * 是否为只读模式
3042
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-readonly
3043
+ */
3044
+ 'readonly'?: boolean;
3045
+ /**
3046
+ * 是否禁用输入框
3047
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-disabled
3048
+ */
3049
+ 'disabled'?: boolean;
3050
+ /**
3051
+ * 提交表单时,是否必须填写该字段
3052
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-required
3053
+ */
3054
+ 'required'?: boolean;
3055
+ /**
3056
+ * 文本框的固定显示行数
3057
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-rows
3058
+ */
3059
+ 'rows'?: number;
3060
+ /**
3061
+ * 是否根据输入内容自动调整文本框高度
3062
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-autosize
3063
+ */
3064
+ 'autosize'?: boolean;
3065
+ /**
3066
+ * `autosize` 为 `true` 时,文本框的最小行数
3067
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-min-rows
3068
+ */
3069
+ 'min-rows'?: number;
3070
+ /**
3071
+ * `autosize` 为 `true` 时,文本框的最大行数
3072
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-max-rows
3073
+ */
3074
+ 'max-rows'?: number;
3075
+ /**
3076
+ * 允许输入的最小字符数
3077
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-minlength
3078
+ */
3079
+ 'minlength'?: number;
3080
+ /**
3081
+ * 允许输入的最大字符数
3082
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-maxlength
3083
+ */
3084
+ 'maxlength'?: number;
3085
+ /**
3086
+ * 是否显示字数统计,只在 `maxlength` 被指定时有效
3087
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-counter
3088
+ */
3089
+ 'counter'?: boolean;
3090
+ /**
3091
+ * 当 `type` 为 `number` 时,允许输入的最小数值
3092
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-min
3093
+ */
3094
+ 'min'?: number;
3095
+ /**
3096
+ * 当 `type` 为 `number` 时,允许输入的最大数值
3097
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-max
3098
+ */
3099
+ 'max'?: number;
3100
+ /**
3101
+ * `type` 为 `number` 时,数值增减的步长
3102
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-step
3103
+ */
3104
+ 'step'?: number;
3105
+ /**
3106
+ * 用于表单验证的正则表达式
3107
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-pattern
3108
+ */
3109
+ 'pattern'?: string;
3110
+ /**
3111
+ * `type` 为 `password` 时,设置此属性会添加一个切换按钮,用于在明文和密文之间切换
3112
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-toggle-password
3113
+ */
3114
+ 'toggle-password'?: boolean;
3115
+ /**
3116
+ * 密码切换按钮的 Material Icons 图标,当密码为明文时显示。也可以通过 `slot="show-password-icon"` 设置
3117
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-show-password-icon
3118
+ */
3119
+ 'show-password-icon'?: string;
3120
+ /**
3121
+ * 密码切换按钮的 Material Icons 图标,当密码为密文时显示。也可以通过 `slot="hide-password-icon"` 设置
3122
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-hide-password-icon
3123
+ */
3124
+ 'hide-password-icon'?: string;
3125
+ /**
3126
+ * iOS 的非标准属性,用于控制文本首字母是否自动大写。在 iOS5 及以后的版本上有效。可选值包括:
3127
+ *
3128
+ * * `none`:禁用首字母大写
3129
+ * * `sentences`:句子首字母大写
3130
+ * * `words`:单词首字母大写
3131
+ * * `characters`:所有字母大写
3132
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-autocapitalize
3133
+ */
3134
+ 'autocapitalize'?: 'none' | 'sentences' | 'words' | 'characters';
3135
+ /**
3136
+ * `input` 元素的 `autocorrect` 属性
3137
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-autocorrect
3138
+ */
3139
+ 'autocorrect'?: string;
3140
+ /**
3141
+ * 是否使用浏览器的自动填充功能。可选值包括:
3142
+ *
3143
+ * * `off`:禁用浏览器的自动填充,使用者必须输入他们想要输入的所有内容。或者网页提供了自己的自动填充方法
3144
+ * * `on`:浏览器根据用户之前输入的内容或者习惯,在用户输入的时候给出相应输入提示
3145
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-autocomplete
3146
+ */
3147
+ 'autocomplete'?: 'off' | 'on';
3148
+ /**
3149
+ * `input` 元素的 `enterkeyhint` 属性,用于定制虚拟键盘上的 Enter 键的显示文本或图标。具体显示效果取决于用户使用的设备和语言。可选值包括:
3150
+ *
3151
+ * * `enter`:插入新行
3152
+ * * `done`:完成输入,关闭虚拟键盘
3153
+ * * `go`:导航到输入文本的目标
3154
+ * * `next`:移动到下一个输入项
3155
+ * * `previous`:移动到上一个输入项
3156
+ * * `search`:导航到搜索结果
3157
+ * * `send`:发送文本信息
3158
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-enterkeyhint
3159
+ */
3160
+ 'enterkeyhint'?: 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send';
3161
+ /**
3162
+ * 是否启用拼写检查
3163
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-spellcheck
3164
+ */
3165
+ 'spellcheck'?: boolean;
3166
+ /**
3167
+ * `input` 元素的 `inputmode` 属性,用于定制虚拟键盘的类型。可选值包括:
3168
+ *
3169
+ * * `none`:无虚拟键盘。在需要实现自己的键盘输入控件时很有用
3170
+ * * `text`:标准文本输入键盘
3171
+ * * `decimal`:小数输入键盘,除了数字之外可能会有小数点 `.` 或者千分符逗号 `,`
3172
+ * * `numeric`:显示 0-9 的数字键盘
3173
+ * * `tel`:手机数字键盘,包含 0-9 数字、星号 `*` 或者井号 `#` 键
3174
+ * * `search`:为搜索输入优化的虚拟键盘,提交按钮通常会显示 `search` 或者 “搜索”
3175
+ * * `email`:为邮件地址输入优化的虚拟键盘,通常会有 `@ .` 等键
3176
+ * * `url`:为 URL 输入优化的虚拟键盘,通常会有 `. / #` 等键
3177
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-inputmode
3178
+ */
3179
+ 'inputmode'?: 'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url';
3180
+ /**
3181
+ * 是否在页面加载完成后自动获取焦点
3182
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-autofocus
3183
+ */
3184
+ 'autofocus'?: boolean;
3185
+ /**
3186
+ * 元素在使用 Tab 键切换焦点时的顺序
3187
+ * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-tabindex
3188
+ */
3189
+ 'tabindex'?: number;
3190
+ } & HTMLElementProps;
3191
+ /**
3192
+ * 工具提示组件
3193
+ *
3194
+ * ```html
3195
+ * <mdui-tooltip content="tooltip content">
3196
+ * <mdui-button>button</mdui-button>
3197
+ * </mdui-tooltip>
3198
+ * ```
3199
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tooltip
3200
+ */
3201
+ 'mdui-tooltip': {
3202
+ /**
3203
+ * tooltip 的形状。默认为 `plain`。可选值包括:
3204
+ *
3205
+ * * `plain`:纯文本,适用于简单的单行文本
3206
+ * * `rich`:富文本,可以包含标题、正文和操作按钮
3207
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tooltip#attributes-variant
3208
+ */
3209
+ 'variant'?: 'plain' | 'rich';
3210
+ /**
3211
+ * tooltip 的位置。默认为 `auto`。可选值包括:
3212
+ *
3213
+ * * `auto`:自动判断位置。`variant="plan"` 时,优先使用 `top`;`variant="rich"` 时,优先使用 `bottom-right`
3214
+ * * `top-left`:位于左上方
3215
+ * * `top-start`:位于上方,左对齐
3216
+ * * `top`:位于上方,居中对齐
3217
+ * * `top-end`:位于上方,右对齐
3218
+ * * `top-right`:位于右上方
3219
+ * * `bottom-left`:位于左下方
3220
+ * * `bottom-start`:位于下方,左对齐
3221
+ * * `bottom`:位于下方,居中对齐
3222
+ * * `bottom-end`:位于下方,右对齐
3223
+ * * `bottom-right`:位于右下方
3224
+ * * `left-start`:位于左侧,顶部对齐
3225
+ * * `left`:位于左侧,居中对齐
3226
+ * * `left-end`:位于左侧,底部对齐
3227
+ * * `right-start`:位于右侧,顶部对齐
3228
+ * * `right`:位于右侧,居中对齐
3229
+ * * `right-end`:位于右侧,底部对齐
3230
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tooltip#attributes-placement
3231
+ */
3232
+ 'placement'?: 'auto' | 'top-left' | 'top-start' | 'top' | 'top-end' | 'top-right' | 'bottom-left' | 'bottom-start' | 'bottom' | 'bottom-end' | 'bottom-right' | 'left-start' | 'left' | 'left-end' | 'right-start' | 'right' | 'right-end';
3233
+ /**
3234
+ * 鼠标悬浮触发显示的延时,单位为毫秒
3235
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tooltip#attributes-open-delay
3236
+ */
3237
+ 'open-delay'?: number;
3238
+ /**
3239
+ * 鼠标悬浮触发隐藏的延时,单位为毫秒
3240
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tooltip#attributes-close-delay
3241
+ */
3242
+ 'close-delay'?: number;
3243
+ /**
3244
+ * tooltip 的标题。仅 `variant="rich"` 时可使用。也可以通过 `slot="headline"` 设置
3245
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tooltip#attributes-headline
3246
+ */
3247
+ 'headline'?: string;
3248
+ /**
3249
+ * tooltip 的内容。也可以通过 `slot="content"` 设置
3250
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tooltip#attributes-content
3251
+ */
3252
+ 'content'?: string;
3253
+ /**
3254
+ * 触发方式,支持多个值,用空格分隔。可选值包括:
3255
+ *
3256
+ * * `click`:点击时触发
3257
+ * * `hover`:鼠标悬浮时触发
3258
+ * * `focus`:聚焦时触发
3259
+ * * `manual`:只能通过编程方式打开和关闭 tooltip,不能再指定其他触发方式
3260
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tooltip#attributes-trigger
3261
+ */
3262
+ 'trigger'?: 'click' | 'hover' | 'focus' | 'manual' | string;
3263
+ /**
3264
+ * 是否禁用 tooltip
3265
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tooltip#attributes-disabled
3266
+ */
3267
+ 'disabled'?: boolean;
3268
+ /**
3269
+ * 是否显示 tooltip
3270
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tooltip#attributes-open
3271
+ */
3272
+ 'open'?: boolean;
3273
+ } & HTMLElementProps;
3274
+ /**
3275
+ * 顶部应用栏组件
3276
+ *
3277
+ * ```html
3278
+ * <mdui-top-app-bar>
3279
+ * <mdui-button-icon icon="menu"></mdui-button-icon>
3280
+ * <mdui-top-app-bar-title>Title</mdui-top-app-bar-title>
3281
+ * <div style="flex-grow: 1"></div>
3282
+ * <mdui-button-icon icon="more_vert"></mdui-button-icon>
3283
+ * </mdui-top-app-bar>
3284
+ * ```
3285
+ * @see https://www.mdui.org/zh-cn/docs/2/components/top-app-bar
3286
+ */
3287
+ 'mdui-top-app-bar': {
3288
+ /**
3289
+ * 顶部应用栏的形状。默认为 `small`。可选值包括:
3290
+ *
3291
+ * * `center-aligned`:小型应用栏,标题居中
3292
+ * * `small`:小型应用栏
3293
+ * * `medium`:中型应用栏
3294
+ * * `large`:大型应用栏
3295
+ * @see https://www.mdui.org/zh-cn/docs/2/components/top-app-bar#top-app-bar-attributes-variant
3296
+ */
3297
+ 'variant'?: 'center-aligned' | 'small' | 'medium' | 'large';
3298
+ /**
3299
+ * 是否隐藏
3300
+ * @see https://www.mdui.org/zh-cn/docs/2/components/top-app-bar#top-app-bar-attributes-hide
3301
+ */
3302
+ 'hide'?: boolean;
3303
+ /**
3304
+ * 是否缩小为 `variant="small"` 的样式,仅在 `variant="medium"` 或 `variant="large"` 时生效
3305
+ * @see https://www.mdui.org/zh-cn/docs/2/components/top-app-bar#top-app-bar-attributes-shrink
3306
+ */
3307
+ 'shrink'?: boolean;
3308
+ /**
3309
+ * 滚动行为。可同时使用多个值,用空格分隔。可选值包括:
3310
+ *
3311
+ * * `hide`:滚动时隐藏
3312
+ * * `shrink`:在中型、大型应用栏中可使用,滚动时缩小成小型应用栏的样式
3313
+ * * `elevate`:滚动时添加阴影
3314
+ * @see https://www.mdui.org/zh-cn/docs/2/components/top-app-bar#top-app-bar-attributes-scroll-behavior
3315
+ */
3316
+ 'scroll-behavior'?: 'hide' | 'shrink' | 'elevate';
3317
+ /**
3318
+ * 需要监听其滚动事件的元素。值可以是 CSS 选择器、DOM 元素、或 [JQ 对象](https://www.mdui.org/zh-cn/docs/2/functions/jq)。默认监听 `window` 的滚动事件
3319
+ * @see https://www.mdui.org/zh-cn/docs/2/components/top-app-bar#top-app-bar-attributes-scroll-target
3320
+ */
3321
+ 'scroll-target'?: string | HTMLElement | JQ<HTMLElement>;
3322
+ /**
3323
+ * 在滚动多少距离之后触发滚动行为,单位为 `px`
3324
+ * @see https://www.mdui.org/zh-cn/docs/2/components/top-app-bar#top-app-bar-attributes-scroll-threshold
3325
+ */
3326
+ 'scroll-threshold'?: number;
3327
+ /**
3328
+ * 该组件在 [`<mdui-layout>`](https://www.mdui.org/zh-cn/docs/2/components/layout) 中的布局顺序,按从小到大排序。默认为 `0`
3329
+ * @see https://www.mdui.org/zh-cn/docs/2/components/top-app-bar#top-app-bar-attributes-order
3330
+ */
3331
+ 'order'?: number;
3332
+ } & HTMLElementProps;
3333
+ /**
3334
+ * 顶部应用栏标题组件。需配合 `<mdui-top-app-bar>` 组件使用
3335
+ *
3336
+ * ```html
3337
+ * <mdui-top-app-bar>
3338
+ * <mdui-button-icon icon="menu"></mdui-button-icon>
3339
+ * <mdui-top-app-bar-title>Title</mdui-top-app-bar-title>
3340
+ * <div style="flex-grow: 1"></div>
3341
+ * <mdui-button-icon icon="more_vert"></mdui-button-icon>
3342
+ * </mdui-top-app-bar>
3343
+ * ```
3344
+ * @see https://www.mdui.org/zh-cn/docs/2/components/top-app-bar
3345
+ */
3346
+ 'mdui-top-app-bar-title': {
3347
+
3348
+ } & HTMLElementProps;
3349
+ }
3350
+ }
3351
+ }