mdui 2.1.0 → 2.1.2

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 (44) hide show
  1. package/components/avatar/style.js +1 -1
  2. package/components/badge/style.js +1 -1
  3. package/components/bottom-app-bar/index.d.ts +1 -1
  4. package/components/button/button-base.d.ts +1 -1
  5. package/components/button/style.js +1 -1
  6. package/components/button-icon/style.js +1 -1
  7. package/components/card/index.d.ts +1 -1
  8. package/components/checkbox/index.d.ts +1 -1
  9. package/components/checkbox/style.js +1 -1
  10. package/components/chip/style.js +1 -1
  11. package/components/circular-progress/style.js +1 -1
  12. package/components/dialog/style.js +1 -1
  13. package/components/fab/style.js +1 -1
  14. package/components/icon/style.js +1 -1
  15. package/components/list/list-item.d.ts +1 -1
  16. package/components/menu/menu-item.d.ts +1 -1
  17. package/components/navigation-bar/navigation-bar-item.d.ts +1 -1
  18. package/components/navigation-bar/navigation-bar.d.ts +1 -1
  19. package/components/navigation-rail/navigation-rail-item.d.ts +1 -1
  20. package/components/radio/radio-style.js +1 -1
  21. package/components/radio/radio.d.ts +1 -1
  22. package/components/ripple/ripple-mixin.d.ts +1 -1
  23. package/components/select/index.d.ts +1 -1
  24. package/components/select/index.js +3 -2
  25. package/components/slider/slider-base-style.js +1 -1
  26. package/components/slider/slider-base.d.ts +1 -1
  27. package/components/switch/index.d.ts +1 -1
  28. package/components/tabs/tab.d.ts +1 -1
  29. package/components/text-field/index.d.ts +1 -1
  30. package/components/text-field/index.js +5 -1
  31. package/components/text-field/style.js +1 -1
  32. package/components/top-app-bar/top-app-bar.d.ts +1 -1
  33. package/custom-elements.json +13813 -15187
  34. package/functions/prompt.d.ts +1 -1
  35. package/functions/prompt.js +1 -1
  36. package/html-data.en.json +582 -578
  37. package/html-data.zh-cn.json +582 -578
  38. package/jsx.en.d.ts +422 -422
  39. package/jsx.zh-cn.d.ts +422 -422
  40. package/mdui.esm.js +7 -7
  41. package/mdui.global.js +8 -8
  42. package/package.json +9 -9
  43. package/web-types.en.json +1269 -1253
  44. package/web-types.zh-cn.json +1269 -1253
package/jsx.zh-cn.d.ts CHANGED
@@ -110,52 +110,56 @@ declare global {
110
110
  'order'?: number;
111
111
  } & HTMLElementProps;
112
112
  /**
113
- * 按钮组件
113
+ * 图标按钮组件
114
114
  *
115
115
  * ```html
116
- * <mdui-button>Button</mdui-button>
116
+ * <mdui-button-icon icon="search"></mdui-button-icon>
117
117
  * ```
118
- * @see https://www.mdui.org/zh-cn/docs/2/components/button
118
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon
119
119
  */
120
- 'mdui-button': {
120
+ 'mdui-button-icon': {
121
121
  /**
122
- * 按钮的形状。可选值包括:
122
+ * 图标按钮的形状。可选值包括:
123
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
124
+ * * `standard`:适用于最低优先级的操作
125
+ * * `filled`:视觉效果强烈,适用于高优先级的操作
126
+ * * `tonal`:视觉效果介于 `filled` 和 `outlined` 之间,适用于中高优先级的操作
127
+ * * `outlined`:适用于中等优先级的操作
128
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-variant
130
129
  */
131
- 'variant'?: 'elevated' | 'filled' | 'tonal' | 'outlined' | 'text';
130
+ 'variant'?: 'standard' | 'filled' | 'tonal' | 'outlined';
132
131
  /**
133
- * 是否填满父元素宽度
134
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-full-width
132
+ * Material Icons 图标名。也可以通过 default slot 设置
133
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-icon
135
134
  */
136
- 'full-width'?: boolean;
135
+ 'icon'?: string;
137
136
  /**
138
- * 左侧的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
139
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-icon
137
+ * 选中状态的 Material Icons 图标名。也可以通过 `slot="selected-icon"` 设置
138
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-selected-icon
140
139
  */
141
- 'icon'?: string;
140
+ 'selected-icon'?: string;
142
141
  /**
143
- * 右侧的 Material Icons 图标名。也可以通过 `slot="end-icon"` 设置
144
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-end-icon
142
+ * 是否可选中
143
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-selectable
145
144
  */
146
- 'end-icon'?: string;
145
+ 'selectable'?: boolean;
146
+ /**
147
+ * 是否已被选中
148
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-selected
149
+ */
150
+ 'selected'?: boolean;
147
151
  /**
148
152
  * 链接的目标 URL。
149
153
  *
150
154
  * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。
151
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-href
155
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-href
152
156
  */
153
157
  'href'?: string;
154
158
  /**
155
159
  * 下载链接的目标。
156
160
  *
157
161
  * **Note**:仅在设置了 `href` 属性时,此属性才有效。
158
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-download
162
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-download
159
163
  */
160
164
  'download'?: string;
161
165
  /**
@@ -167,7 +171,7 @@ declare global {
167
171
  * * `_top`:在整个窗口中打开链接
168
172
  *
169
173
  * **Note**:仅在设置了 `href` 属性时,此属性才有效。
170
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-target
174
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-target
171
175
  */
172
176
  'target'?: '_blank' | '_parent' | '_self' | '_top';
173
177
  /**
@@ -189,41 +193,41 @@ declare global {
189
193
  * * `tag`:提供一个适用于当前文档的标签(由给定地址识别)
190
194
  *
191
195
  * **Note**:仅在指定了 `href` 属性时可用。
192
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-rel
196
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-rel
193
197
  */
194
198
  'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag';
195
199
  /**
196
200
  * 是否在页面加载完成后自动获取焦点
197
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-autofocus
201
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-autofocus
198
202
  */
199
203
  'autofocus'?: boolean;
200
204
  /**
201
205
  * 元素在使用 Tab 键切换焦点时的顺序
202
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-tabindex
206
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-tabindex
203
207
  */
204
208
  'tabindex'?: number;
205
209
  /**
206
210
  * 是否禁用
207
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-disabled
211
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-disabled
208
212
  */
209
213
  'disabled'?: boolean;
210
214
  /**
211
215
  * 是否处于加载中状态
212
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-loading
216
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-loading
213
217
  */
214
218
  'loading'?: boolean;
215
219
  /**
216
220
  * 按钮的名称,将与表单数据一起提交。
217
221
  *
218
222
  * **Note**:仅在未设置 `href` 属性时,此属性才有效。
219
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-name
223
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-name
220
224
  */
221
225
  'name'?: string;
222
226
  /**
223
227
  * 按钮的初始值,将与表单数据一起提交。
224
228
  *
225
229
  * **Note**:仅在未设置 `href` 属性时,此属性才有效。
226
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-value
230
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-value
227
231
  */
228
232
  'value'?: string;
229
233
  /**
@@ -234,7 +238,7 @@ declare global {
234
238
  * * `button`:此类型的按钮没有默认行为
235
239
  *
236
240
  * **Note**:仅在未指定 `href` 属性时,此属性才有效。
237
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-type
241
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-type
238
242
  */
239
243
  'type'?: 'submit' | 'reset' | 'button';
240
244
  /**
@@ -243,7 +247,7 @@ declare global {
243
247
  * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
244
248
  *
245
249
  * **Note**:仅在未指定 `href` 属性时,此属性才有效。
246
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-form
250
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-form
247
251
  */
248
252
  'form'?: string;
249
253
  /**
@@ -252,7 +256,7 @@ declare global {
252
256
  * 如果指定了此属性,将覆盖 `<form>` 元素的 `action` 属性。
253
257
  *
254
258
  * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。
255
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formaction
259
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formaction
256
260
  */
257
261
  'formaction'?: string;
258
262
  /**
@@ -265,7 +269,7 @@ declare global {
265
269
  * 如果指定了此属性,将覆盖 `<form>` 元素的 `enctype` 属性。
266
270
  *
267
271
  * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。
268
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formenctype
272
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formenctype
269
273
  */
270
274
  'formenctype'?: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain';
271
275
  /**
@@ -277,7 +281,7 @@ declare global {
277
281
  * 如果设置了此属性,将覆盖 `<form>` 元素的 `method` 属性。
278
282
  *
279
283
  * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
280
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formmethod
284
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formmethod
281
285
  */
282
286
  'formmethod'?: 'post' | 'get';
283
287
  /**
@@ -286,7 +290,7 @@ declare global {
286
290
  * 如果设置了此属性,将覆盖 `<form>` 元素的 `novalidate` 属性。
287
291
  *
288
292
  * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
289
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formnovalidate
293
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formnovalidate
290
294
  */
291
295
  'formnovalidate'?: boolean;
292
296
  /**
@@ -300,61 +304,57 @@ declare global {
300
304
  * 如果设置了此属性,将覆盖 `<form>` 元素的 `target` 属性。
301
305
  *
302
306
  * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
303
- * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formtarget
307
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formtarget
304
308
  */
305
309
  'formtarget'?: '_self' | '_blank' | '_parent' | '_top';
306
310
  } & HTMLElementProps;
307
311
  /**
308
- * 图标按钮组件
312
+ * 按钮组件
309
313
  *
310
314
  * ```html
311
- * <mdui-button-icon icon="search"></mdui-button-icon>
315
+ * <mdui-button>Button</mdui-button>
312
316
  * ```
313
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon
317
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button
314
318
  */
315
- 'mdui-button-icon': {
319
+ 'mdui-button': {
316
320
  /**
317
- * 图标按钮的形状。可选值包括:
321
+ * 按钮的形状。可选值包括:
318
322
  *
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
323
+ * * `elevated`:带阴影的按钮,适用于需要将按钮与背景视觉分离的场景
324
+ * * `filled`:视觉效果强烈,适用于重要流程的最终操作,如“保存”、“确认”等
325
+ * * `tonal`:视觉效果介于 `filled` 和 `outlined` 之间,适用于中高优先级的操作,如流程中的“下一步”
326
+ * * `outlined`:带边框的按钮,适用于中等优先级,且次要的操作,如“返回”
327
+ * * `text`:文本按钮,适用于最低优先级的操作
328
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-variant
329
329
  */
330
- 'icon'?: string;
330
+ 'variant'?: 'elevated' | 'filled' | 'tonal' | 'outlined' | 'text';
331
331
  /**
332
- * 选中状态的 Material Icons 图标名。也可以通过 `slot="selected-icon"` 设置
333
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-selected-icon
332
+ * 是否填满父元素宽度
333
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-full-width
334
334
  */
335
- 'selected-icon'?: string;
335
+ 'full-width'?: boolean;
336
336
  /**
337
- * 是否可选中
338
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-selectable
337
+ * 左侧的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
338
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-icon
339
339
  */
340
- 'selectable'?: boolean;
340
+ 'icon'?: string;
341
341
  /**
342
- * 是否已被选中
343
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-selected
342
+ * 右侧的 Material Icons 图标名。也可以通过 `slot="end-icon"` 设置
343
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-end-icon
344
344
  */
345
- 'selected'?: boolean;
345
+ 'end-icon'?: string;
346
346
  /**
347
347
  * 链接的目标 URL。
348
348
  *
349
349
  * 如果设置了此属性,组件内部将渲染为 `<a>` 元素,并可以使用链接相关的属性。
350
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-href
350
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-href
351
351
  */
352
352
  'href'?: string;
353
353
  /**
354
354
  * 下载链接的目标。
355
355
  *
356
356
  * **Note**:仅在设置了 `href` 属性时,此属性才有效。
357
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-download
357
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-download
358
358
  */
359
359
  'download'?: string;
360
360
  /**
@@ -366,7 +366,7 @@ declare global {
366
366
  * * `_top`:在整个窗口中打开链接
367
367
  *
368
368
  * **Note**:仅在设置了 `href` 属性时,此属性才有效。
369
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-target
369
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-target
370
370
  */
371
371
  'target'?: '_blank' | '_parent' | '_self' | '_top';
372
372
  /**
@@ -388,41 +388,41 @@ declare global {
388
388
  * * `tag`:提供一个适用于当前文档的标签(由给定地址识别)
389
389
  *
390
390
  * **Note**:仅在指定了 `href` 属性时可用。
391
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-rel
391
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-rel
392
392
  */
393
393
  'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag';
394
394
  /**
395
395
  * 是否在页面加载完成后自动获取焦点
396
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-autofocus
396
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-autofocus
397
397
  */
398
398
  'autofocus'?: boolean;
399
399
  /**
400
400
  * 元素在使用 Tab 键切换焦点时的顺序
401
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-tabindex
401
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-tabindex
402
402
  */
403
403
  'tabindex'?: number;
404
404
  /**
405
405
  * 是否禁用
406
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-disabled
406
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-disabled
407
407
  */
408
408
  'disabled'?: boolean;
409
409
  /**
410
410
  * 是否处于加载中状态
411
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-loading
411
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-loading
412
412
  */
413
413
  'loading'?: boolean;
414
414
  /**
415
415
  * 按钮的名称,将与表单数据一起提交。
416
416
  *
417
417
  * **Note**:仅在未设置 `href` 属性时,此属性才有效。
418
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-name
418
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-name
419
419
  */
420
420
  'name'?: string;
421
421
  /**
422
422
  * 按钮的初始值,将与表单数据一起提交。
423
423
  *
424
424
  * **Note**:仅在未设置 `href` 属性时,此属性才有效。
425
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-value
425
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-value
426
426
  */
427
427
  'value'?: string;
428
428
  /**
@@ -433,7 +433,7 @@ declare global {
433
433
  * * `button`:此类型的按钮没有默认行为
434
434
  *
435
435
  * **Note**:仅在未指定 `href` 属性时,此属性才有效。
436
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-type
436
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-type
437
437
  */
438
438
  'type'?: 'submit' | 'reset' | 'button';
439
439
  /**
@@ -442,7 +442,7 @@ declare global {
442
442
  * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
443
443
  *
444
444
  * **Note**:仅在未指定 `href` 属性时,此属性才有效。
445
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-form
445
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-form
446
446
  */
447
447
  'form'?: string;
448
448
  /**
@@ -451,7 +451,7 @@ declare global {
451
451
  * 如果指定了此属性,将覆盖 `<form>` 元素的 `action` 属性。
452
452
  *
453
453
  * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。
454
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formaction
454
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formaction
455
455
  */
456
456
  'formaction'?: string;
457
457
  /**
@@ -464,7 +464,7 @@ declare global {
464
464
  * 如果指定了此属性,将覆盖 `<form>` 元素的 `enctype` 属性。
465
465
  *
466
466
  * **Note**:仅在未指定 `href` 属性且 `type="submit"` 时,此属性才有效。
467
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formenctype
467
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formenctype
468
468
  */
469
469
  'formenctype'?: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain';
470
470
  /**
@@ -476,7 +476,7 @@ declare global {
476
476
  * 如果设置了此属性,将覆盖 `<form>` 元素的 `method` 属性。
477
477
  *
478
478
  * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
479
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formmethod
479
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formmethod
480
480
  */
481
481
  'formmethod'?: 'post' | 'get';
482
482
  /**
@@ -485,7 +485,7 @@ declare global {
485
485
  * 如果设置了此属性,将覆盖 `<form>` 元素的 `novalidate` 属性。
486
486
  *
487
487
  * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
488
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formnovalidate
488
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formnovalidate
489
489
  */
490
490
  'formnovalidate'?: boolean;
491
491
  /**
@@ -499,7 +499,7 @@ declare global {
499
499
  * 如果设置了此属性,将覆盖 `<form>` 元素的 `target` 属性。
500
500
  *
501
501
  * **Note**:仅在未设置 `href` 属性且 `type="submit"` 时,此属性才有效。
502
- * @see https://www.mdui.org/zh-cn/docs/2/components/button-icon#attributes-formtarget
502
+ * @see https://www.mdui.org/zh-cn/docs/2/components/button#attributes-formtarget
503
503
  */
504
504
  'formtarget'?: '_self' | '_blank' | '_parent' | '_top';
505
505
  } & HTMLElementProps;
@@ -902,7 +902,7 @@ declare global {
902
902
  'value'?: number;
903
903
  } & HTMLElementProps;
904
904
  /**
905
- * 折叠面板组件,需配合 `<mdui-collapse-item>` 组件使用
905
+ * 折叠面板项组件,需配合 `<mdui-collapse>` 组件使用
906
906
  *
907
907
  * ```html
908
908
  * <mdui-collapse>
@@ -912,27 +912,30 @@ declare global {
912
912
  * ```
913
913
  * @see https://www.mdui.org/zh-cn/docs/2/components/collapse
914
914
  */
915
- 'mdui-collapse': {
915
+ 'mdui-collapse-item': {
916
916
  /**
917
- * 是否启用手风琴模式
918
- * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-attributes-accordion
917
+ * 此折叠面板项的值
918
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-item-attributes-value
919
919
  */
920
- 'accordion'?: boolean;
920
+ 'value'?: string;
921
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
922
+ * 此折叠面板项的头部文本
923
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-item-attributes-header
926
924
  */
927
- 'value'?: string | string[];
925
+ 'header'?: string;
928
926
  /**
929
- * 是否禁用此折叠面板
930
- * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-attributes-disabled
927
+ * 是否禁用此折叠面板项
928
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-item-attributes-disabled
931
929
  */
932
930
  'disabled'?: boolean;
931
+ /**
932
+ * 点击该元素时触发折叠,值可以是 CSS 选择器、DOM 元素、或 [JQ 对象](https://www.mdui.org/zh-cn/docs/2/functions/jq)。默认为点击整个 header 区域触发
933
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-item-attributes-trigger
934
+ */
935
+ 'trigger'?: string | HTMLElement | JQ<HTMLElement>;
933
936
  } & HTMLElementProps;
934
937
  /**
935
- * 折叠面板项组件,需配合 `<mdui-collapse>` 组件使用
938
+ * 折叠面板组件,需配合 `<mdui-collapse-item>` 组件使用
936
939
  *
937
940
  * ```html
938
941
  * <mdui-collapse>
@@ -942,27 +945,24 @@ declare global {
942
945
  * ```
943
946
  * @see https://www.mdui.org/zh-cn/docs/2/components/collapse
944
947
  */
945
- 'mdui-collapse-item': {
948
+ 'mdui-collapse': {
946
949
  /**
947
- * 此折叠面板项的值
948
- * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-item-attributes-value
950
+ * 是否启用手风琴模式
951
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-attributes-accordion
949
952
  */
950
- 'value'?: string;
953
+ 'accordion'?: boolean;
951
954
  /**
952
- * 此折叠面板项的头部文本
953
- * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-item-attributes-header
955
+ * 当前展开的 `<mdui-collapse-item>` 的值
956
+ *
957
+ * **Note**:该属性的 HTML 属性始终为字符串,只有在 `accordion` 为 `true` 时,才能设置初始值;该属性的 JavaScript 属性值在 `accordion` 为 `true` 时为字符串,在 `accordion` 为 `false` 时为字符串数组。因此,当 `accordion` 为 `false` 时,只能通过修改 JavaScript 属性值来改变此值。
958
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-attributes-value
954
959
  */
955
- 'header'?: string;
960
+ 'value'?: string | string[];
956
961
  /**
957
- * 是否禁用此折叠面板项
958
- * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-item-attributes-disabled
962
+ * 是否禁用此折叠面板
963
+ * @see https://www.mdui.org/zh-cn/docs/2/components/collapse#collapse-attributes-disabled
959
964
  */
960
965
  '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
966
  } & HTMLElementProps;
967
967
  /**
968
968
  * 对话框组件
@@ -1332,25 +1332,6 @@ declare global {
1332
1332
  */
1333
1333
  'src'?: string;
1334
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
1335
  /**
1355
1336
  * 布局项组件
1356
1337
  *
@@ -1394,6 +1375,25 @@ declare global {
1394
1375
  */
1395
1376
  'mdui-layout-main': {
1396
1377
 
1378
+ } & HTMLElementProps;
1379
+ /**
1380
+ * 布局组件
1381
+ *
1382
+ * ```html
1383
+ * <mdui-layout>
1384
+ * <mdui-layout-item></mdui-layout-item>
1385
+ * <mdui-layout-item></mdui-layout-item>
1386
+ * <mdui-layout-main></mdui-layout-main>
1387
+ * </mdui-layout>
1388
+ * ```
1389
+ * @see https://www.mdui.org/zh-cn/docs/2/components/layout
1390
+ */
1391
+ 'mdui-layout': {
1392
+ /**
1393
+ * 设置当前布局的高度为 100%
1394
+ * @see https://www.mdui.org/zh-cn/docs/2/components/layout#layout-attributes-full-height
1395
+ */
1396
+ 'full-height'?: boolean;
1397
1397
  } & HTMLElementProps;
1398
1398
  /**
1399
1399
  * 线性进度指示器组件
@@ -1416,22 +1416,7 @@ declare global {
1416
1416
  'value'?: number;
1417
1417
  } & HTMLElementProps;
1418
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>` 组件使用
1419
+ * 列表项组件。需配合 `<mdui-list>` 组件使用
1435
1420
  *
1436
1421
  * ```html
1437
1422
  * <mdui-list>
@@ -1585,57 +1570,19 @@ declare global {
1585
1570
 
1586
1571
  } & HTMLElementProps;
1587
1572
  /**
1588
- * 菜单组件。需配合 `<mdui-menu-item>` 组件使用
1573
+ * 列表组件。需配合 `<mdui-list-item>` 组件使用
1589
1574
  *
1590
1575
  * ```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>
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>
1595
1581
  * ```
1596
- * @see https://www.mdui.org/zh-cn/docs/2/components/menu
1582
+ * @see https://www.mdui.org/zh-cn/docs/2/components/list
1597
1583
  */
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;
1584
+ 'mdui-list': {
1585
+
1639
1586
  } & HTMLElementProps;
1640
1587
  /**
1641
1588
  * 菜单项组件。需配合 `<mdui-menu>` 组件使用
@@ -1746,60 +1693,57 @@ declare global {
1746
1693
  'tabindex'?: number;
1747
1694
  } & HTMLElementProps;
1748
1695
  /**
1749
- * 底部导航栏组件。需配合 `<mdui-navigation-bar-item>` 组件使用
1696
+ * 菜单组件。需配合 `<mdui-menu-item>` 组件使用
1750
1697
  *
1751
1698
  * ```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>
1699
+ * <mdui-menu>
1700
+ * <mdui-menu-item>Item 1</mdui-menu-item>
1701
+ * <mdui-menu-item>Item 2</mdui-menu-item>
1702
+ * </mdui-menu>
1757
1703
  * ```
1758
- * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar
1704
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu
1759
1705
  */
1760
- 'mdui-navigation-bar': {
1706
+ 'mdui-menu': {
1761
1707
  /**
1762
- * 是否隐藏
1763
- * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-hide
1708
+ * 菜单项的可选状态。默认不可选。可选值包括:
1709
+ *
1710
+ * * `single`:单选
1711
+ * * `multiple`:多选
1712
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-attributes-selects
1764
1713
  */
1765
- 'hide'?: boolean;
1714
+ 'selects'?: 'single' | 'multiple';
1766
1715
  /**
1767
- * 文本的可视状态。可选值包括:
1716
+ * 当前选中的 `<mdui-menu-item>` 的值。
1768
1717
  *
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
1718
+ * **Note**:该属性的 HTML 属性始终为字符串,仅在 `selects="single"` 时可通过 HTML 属性设置初始值;该属性的 JavaScript 属性值在 `selects="single"` 时为字符串,在 `selects="multiple"` 时为字符串数组。因此,在 `selects="multiple"` 时,若要修改该值,只能通过修改 JavaScript 属性值实现。
1719
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-attributes-value
1774
1720
  */
1775
- 'label-visibility'?: 'auto' | 'selected' | 'labeled' | 'unlabeled';
1721
+ 'value'?: string | string[];
1776
1722
  /**
1777
- * 当前选中的 `<mdui-navigation-bar-item>` 的值
1778
- * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-value
1723
+ * 菜单项是否使用紧凑布局
1724
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-attributes-dense
1779
1725
  */
1780
- 'value'?: string;
1726
+ 'dense'?: boolean;
1781
1727
  /**
1782
- * 滚动行为。可选值包括:
1728
+ * 子菜单的触发方式,支持多个值,用空格分隔。可选值包括:
1783
1729
  *
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' | 'shrink' | 'elevate';
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
1730
+ * * `click`:点击菜单项时打开子菜单
1731
+ * * `hover`:鼠标悬浮到菜单项上时打开子菜单
1732
+ * * `focus`:聚焦到菜单项上时打开子菜单
1733
+ * * `manual`:仅能通过编程方式打开和关闭子菜单,不能再指定其他触发方式
1734
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-attributes-submenu-trigger
1791
1735
  */
1792
- 'scroll-target'?: string | HTMLElement | JQ<HTMLElement>;
1736
+ 'submenu-trigger'?: 'click' | 'hover' | 'focus' | 'manual' | string;
1793
1737
  /**
1794
- * 在滚动多少距离之后触发滚动行为,单位为 `px`
1795
- * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-scroll-threshold
1738
+ * 鼠标悬浮触发子菜单打开的延时,单位毫秒
1739
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-attributes-submenu-open-delay
1796
1740
  */
1797
- 'scroll-threshold'?: number;
1741
+ 'submenu-open-delay'?: number;
1798
1742
  /**
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
1743
+ * 鼠标悬浮触发子菜单关闭的延时,单位毫秒
1744
+ * @see https://www.mdui.org/zh-cn/docs/2/components/menu#menu-attributes-submenu-close-delay
1801
1745
  */
1802
- 'order'?: number;
1746
+ 'submenu-close-delay'?: number;
1803
1747
  } & HTMLElementProps;
1804
1748
  /**
1805
1749
  * 底部导航栏项组件。需配合 `<mdui-navigation-bar>` 组件使用
@@ -1888,6 +1832,62 @@ declare global {
1888
1832
  */
1889
1833
  'tabindex'?: number;
1890
1834
  } & HTMLElementProps;
1835
+ /**
1836
+ * 底部导航栏组件。需配合 `<mdui-navigation-bar-item>` 组件使用
1837
+ *
1838
+ * ```html
1839
+ * <mdui-navigation-bar>
1840
+ * <mdui-navigation-bar-item icon="place">Item 1</mdui-navigation-bar-item>
1841
+ * <mdui-navigation-bar-item icon="commute">Item 2</mdui-navigation-bar-item>
1842
+ * <mdui-navigation-bar-item icon="people">Item 3</mdui-navigation-bar-item>
1843
+ * </mdui-navigation-bar>
1844
+ * ```
1845
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar
1846
+ */
1847
+ 'mdui-navigation-bar': {
1848
+ /**
1849
+ * 是否隐藏
1850
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-hide
1851
+ */
1852
+ 'hide'?: boolean;
1853
+ /**
1854
+ * 文本的可视状态。可选值包括:
1855
+ *
1856
+ * * `auto`:当选项小于等于3个时,始终显示文本;当选项大于3个时,仅显示选中状态的文本
1857
+ * * `selected`:仅在选中状态显示文本
1858
+ * * `labeled`:始终显示文本
1859
+ * * `unlabeled`:始终不显示文本
1860
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-label-visibility
1861
+ */
1862
+ 'label-visibility'?: 'auto' | 'selected' | 'labeled' | 'unlabeled';
1863
+ /**
1864
+ * 当前选中的 `<mdui-navigation-bar-item>` 的值
1865
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-value
1866
+ */
1867
+ 'value'?: string;
1868
+ /**
1869
+ * 滚动行为。可选值包括:
1870
+ *
1871
+ * * `hide`:滚动时隐藏
1872
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-scroll-behavior
1873
+ */
1874
+ 'scroll-behavior'?: 'hide' | 'shrink' | 'elevate';
1875
+ /**
1876
+ * 需要监听其滚动事件的元素。值可以是 CSS 选择器、DOM 元素、或 [JQ 对象](https://www.mdui.org/zh-cn/docs/2/functions/jq)。默认监听 `window` 的滚动事件
1877
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-scroll-target
1878
+ */
1879
+ 'scroll-target'?: string | HTMLElement | JQ<HTMLElement>;
1880
+ /**
1881
+ * 在滚动多少距离之后触发滚动行为,单位为 `px`
1882
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-scroll-threshold
1883
+ */
1884
+ 'scroll-threshold'?: number;
1885
+ /**
1886
+ * 该组件在 [`<mdui-layout>`](https://www.mdui.org/zh-cn/docs/2/components/layout) 中的布局顺序,按从小到大排序。默认为 `0`
1887
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-bar#navigation-bar-attributes-order
1888
+ */
1889
+ 'order'?: number;
1890
+ } & HTMLElementProps;
1891
1891
  /**
1892
1892
  * 侧边抽屉栏组件
1893
1893
  *
@@ -1940,59 +1940,6 @@ declare global {
1940
1940
  */
1941
1941
  'order'?: number;
1942
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
1943
  /**
1997
1944
  * 侧边导航项组件。需配合 `<mdui-navigation-rail>` 组件使用
1998
1945
  *
@@ -2065,20 +2012,113 @@ declare global {
2065
2012
  * * `search`:提供一个资源链接,可用于搜索当前文件及其相关页面
2066
2013
  * * `tag`:提供一个适用于当前文档的标签(由给定地址识别)
2067
2014
  *
2068
- * **Note**:仅在指定了 `href` 属性时可用。
2069
- * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-item-attributes-rel
2015
+ * **Note**:仅在指定了 `href` 属性时可用。
2016
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-item-attributes-rel
2017
+ */
2018
+ 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag';
2019
+ /**
2020
+ * 是否在页面加载完成后自动获取焦点
2021
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-item-attributes-autofocus
2022
+ */
2023
+ 'autofocus'?: boolean;
2024
+ /**
2025
+ * 元素在使用 Tab 键切换焦点时的顺序
2026
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-item-attributes-tabindex
2027
+ */
2028
+ 'tabindex'?: number;
2029
+ } & HTMLElementProps;
2030
+ /**
2031
+ * 侧边导航栏组件。需配合 `<mdui-navigation-rail-item>` 组件使用
2032
+ *
2033
+ * ```html
2034
+ * <mdui-navigation-rail>
2035
+ * <mdui-navigation-rail-item icon="watch_later">Recent</mdui-navigation-rail-item>
2036
+ * <mdui-navigation-rail-item icon="image">Images</mdui-navigation-rail-item>
2037
+ * <mdui-navigation-rail-item icon="library_music">Library</mdui-navigation-rail-item>
2038
+ * </mdui-navigation-rail>
2039
+ * ```
2040
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail
2041
+ */
2042
+ 'mdui-navigation-rail': {
2043
+ /**
2044
+ * 当前选中的 `<mdui-navigation-rail-item>` 的值
2045
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-attributes-value
2046
+ */
2047
+ 'value'?: string;
2048
+ /**
2049
+ * 导航栏的位置。可选值包括:
2050
+ *
2051
+ * * `left`:左侧
2052
+ * * `right`:右侧
2053
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-attributes-placement
2054
+ */
2055
+ 'placement'?: 'left' | 'right';
2056
+ /**
2057
+ * `<mdui-navigation-rail-item>` 元素的对齐方式。可选值包括:
2058
+ *
2059
+ * * `start`:顶部对齐
2060
+ * * `center`:居中对齐
2061
+ * * `end`:底部对齐
2062
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-attributes-alignment
2063
+ */
2064
+ 'alignment'?: 'start' | 'center' | 'end';
2065
+ /**
2066
+ * 默认情况下,导航栏相对于 `body` 元素显示。当该参数设置为 `true` 时,导航栏将相对于其父元素显示。
2067
+ *
2068
+ * **Note**:设置该属性时,必须在父元素上手动设置样式 `position: relative;`。
2069
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-attributes-contained
2070
+ */
2071
+ 'contained'?: boolean;
2072
+ /**
2073
+ * 是否在导航栏和页面内容之间添加分割线
2074
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-attributes-divider
2075
+ */
2076
+ 'divider'?: boolean;
2077
+ /**
2078
+ * 该组件在 [`<mdui-layout>`](https://www.mdui.org/zh-cn/docs/2/components/layout) 中的布局顺序,按从小到大排序。默认为 `0`
2079
+ * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-attributes-order
2080
+ */
2081
+ 'order'?: number;
2082
+ } & HTMLElementProps;
2083
+ /**
2084
+ * 单选框组组件。需配合 `<mdui-radio>` 组件使用
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-group': {
2095
+ /**
2096
+ * 是否禁用此组件
2097
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-group-attributes-disabled
2098
+ */
2099
+ 'disabled'?: boolean;
2100
+ /**
2101
+ * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
2102
+ *
2103
+ * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
2104
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-group-attributes-form
2070
2105
  */
2071
- 'rel'?: 'alternate' | 'author' | 'bookmark' | 'external' | 'help' | 'license' | 'me' | 'next' | 'nofollow' | 'noreferrer' | 'opener' | 'prev' | 'search' | 'tag';
2106
+ 'form'?: string;
2072
2107
  /**
2073
- * 是否在页面加载完成后自动获取焦点
2074
- * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-item-attributes-autofocus
2108
+ * 单选框组的名称,将与表单数据一起提交
2109
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-group-attributes-name
2075
2110
  */
2076
- 'autofocus'?: boolean;
2111
+ 'name'?: string;
2077
2112
  /**
2078
- * 元素在使用 Tab 键切换焦点时的顺序
2079
- * @see https://www.mdui.org/zh-cn/docs/2/components/navigation-rail#navigation-rail-item-attributes-tabindex
2113
+ * 单选框组的名称,将于表单数据一起提交
2114
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-group-attributes-value
2080
2115
  */
2081
- 'tabindex'?: number;
2116
+ 'value'?: string;
2117
+ /**
2118
+ * 提交表单时,是否必须选中其中一个单选框
2119
+ * @see https://www.mdui.org/zh-cn/docs/2/components/radio#radio-group-attributes-required
2120
+ */
2121
+ 'required'?: boolean;
2082
2122
  } & HTMLElementProps;
2083
2123
  /**
2084
2124
  * 单选框组件。需配合 `<mdui-radio-group>` 组件使用
@@ -2128,46 +2168,6 @@ declare global {
2128
2168
  */
2129
2169
  'tabindex'?: number;
2130
2170
  } & 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
2171
  /**
2172
2172
  * 范围滑块组件
2173
2173
  *
@@ -2230,6 +2230,62 @@ declare global {
2230
2230
  */
2231
2231
  'name'?: string;
2232
2232
  } & HTMLElementProps;
2233
+ /**
2234
+ * 分段按钮组件。需配合 `<mdui-segmented-button>` 组件使用
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-group': {
2246
+ /**
2247
+ * 是否填满父元素宽度
2248
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-group-attributes-full-width
2249
+ */
2250
+ 'full-width'?: boolean;
2251
+ /**
2252
+ * 分段按钮的可选中状态,默认为不可选中。可选值包括:
2253
+ *
2254
+ * * `single`:单选
2255
+ * * `multiple`:多选
2256
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-group-attributes-selects
2257
+ */
2258
+ 'selects'?: 'single' | 'multiple';
2259
+ /**
2260
+ * 是否为禁用状态
2261
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-group-attributes-disabled
2262
+ */
2263
+ 'disabled'?: boolean;
2264
+ /**
2265
+ * 提交表单时,是否必须选中
2266
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-group-attributes-required
2267
+ */
2268
+ 'required'?: boolean;
2269
+ /**
2270
+ * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
2271
+ *
2272
+ * 如果未指定此属性,则该元素必须是 `<form>` 元素的子元素。通过此属性,你可以将元素放置在页面的任何位置,而不仅仅是 `<form>` 元素的子元素。
2273
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-group-attributes-form
2274
+ */
2275
+ 'form'?: string;
2276
+ /**
2277
+ * 提交表单时的名称,将与表单数据一起提交
2278
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-group-attributes-name
2279
+ */
2280
+ 'name'?: string;
2281
+ /**
2282
+ * 当前选中的 `<mdui-segmented-button>` 的值。
2283
+ *
2284
+ * **Note**:该属性的 HTML 属性始终为字符串,且仅在 `selects="single"` 时可以通过 HTML 属性设置初始值。该属性的 JavaScript 属性值在 `selects="single"` 时为字符串,在 `selects="multiple"` 时为字符串数组。所以,在 `selects="multiple"` 时,如果要修改该值,只能通过修改 JavaScript 属性值实现。
2285
+ * @see https://www.mdui.org/zh-cn/docs/2/components/segmented-button#segmented-button-group-attributes-value
2286
+ */
2287
+ 'value'?: string | string[];
2288
+ } & HTMLElementProps;
2233
2289
  /**
2234
2290
  * 分段按钮项组件。需配合 `<mdui-segmented-button-group>` 组件使用
2235
2291
  *
@@ -2418,62 +2474,6 @@ declare global {
2418
2474
  */
2419
2475
  'formtarget'?: '_self' | '_blank' | '_parent' | '_top';
2420
2476
  } & 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
2477
  /**
2478
2478
  * 选择框组件。需配合 `<mdui-menu-item>` 组件使用
2479
2479
  *
@@ -2804,6 +2804,29 @@ declare global {
2804
2804
  */
2805
2805
  'tabindex'?: number;
2806
2806
  } & HTMLElementProps;
2807
+ /**
2808
+ * 选项卡面板项组件。需配合 `<mdui-tabs>` 和 `<mdui-tab>` 组件使用
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-panel': {
2824
+ /**
2825
+ * 选项卡面板项的值
2826
+ * @see https://www.mdui.org/zh-cn/docs/2/components/tabs#tab-panel-attributes-value
2827
+ */
2828
+ 'value'?: string;
2829
+ } & HTMLElementProps;
2807
2830
  /**
2808
2831
  * 选项卡导航项组件。需配合 `<mdui-tabs>` 和 `<mdui-tab-panel>` 组件使用
2809
2832
  *
@@ -2847,29 +2870,6 @@ declare global {
2847
2870
  */
2848
2871
  'tabindex'?: number;
2849
2872
  } & 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
2873
  /**
2874
2874
  * 选项卡组件。需配合 `<mdui-tab>` 和 `<mdui-tab-panel>` 组件使用
2875
2875
  *
@@ -3270,6 +3270,22 @@ declare global {
3270
3270
  * @see https://www.mdui.org/zh-cn/docs/2/components/tooltip#attributes-open
3271
3271
  */
3272
3272
  'open'?: boolean;
3273
+ } & HTMLElementProps;
3274
+ /**
3275
+ * 顶部应用栏标题组件。需配合 `<mdui-top-app-bar>` 组件使用
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-title': {
3288
+
3273
3289
  } & HTMLElementProps;
3274
3290
  /**
3275
3291
  * 顶部应用栏组件
@@ -3330,22 +3346,6 @@ declare global {
3330
3346
  */
3331
3347
  'order'?: number;
3332
3348
  } & 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
3349
  }
3350
3350
  }
3351
3351
  }