mdui 2.0.2 → 2.0.3

package/web-types.zh-cn.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/web-types",
   "name": "mdui",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "js-types-syntax": "typescript",
   "description-markup": "markdown",
   "framework-config": {
@@ -450,12 +450,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/button#attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/button#attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/button#attributes-tabindex"
             },
             {
               "name": "disabled",
@@ -975,12 +975,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/button-icon#attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/button-icon#attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/button-icon#attributes-tabindex"
             },
             {
               "name": "disabled",
@@ -1485,12 +1485,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/card#attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/card#attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/card#attributes-tabindex"
             }
           ],
           "priority": "highest",
@@ -1717,12 +1717,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/checkbox#attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/checkbox#attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/checkbox#attributes-tabindex"
             }
           ],
           "priority": "highest",
@@ -2072,12 +2072,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/chip#attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/chip#attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/chip#attributes-tabindex"
             },
             {
               "name": "disabled",
@@ -3127,6 +3127,243 @@
             ]
           }
         },
+        {
+          "name": "mdui-dropdown",
+          "description": "下拉组件\n\n```html\n<mdui-dropdown>\n  <mdui-button slot=\"trigger\">open dropdown</mdui-button>\n  <mdui-menu>\n    <mdui-menu-item>Item 1</mdui-menu-item>\n    <mdui-menu-item>Item 2</mdui-menu-item>\n  </mdui-menu>\n</mdui-dropdown>\n```",
+          "attributes": [
+            {
+              "name": "open",
+              "description": "dropdown 是否打开",
+              "value": {
+                "type": "boolean"
+              },
+              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-open"
+            },
+            {
+              "name": "disabled",
+              "description": "是否禁用 dropdown",
+              "value": {
+                "type": "boolean"
+              },
+              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-disabled"
+            },
+            {
+              "name": "trigger",
+              "description": "dropdown 的触发方式，支持传入多个值，用空格分隔。可选值为：\n\n* `click`：点击时触发\n* `hover`：鼠标悬浮触发\n* `focus`：聚焦时触发\n* `contextmenu`：鼠标右键点击、或触摸长按时触发\n* `manual`：使用了该值时，只能使用编程方式打开和关闭 dropdown，且不能再指定其他触发方式",
+              "value": {
+                "type": [
+                  "'click'",
+                  "'hover'",
+                  "'focus'",
+                  "'contextmenu'",
+                  "'manual'",
+                  "string"
+                ]
+              },
+              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-trigger"
+            },
+            {
+              "name": "placement",
+              "description": "dropdown 内容的位置。可选值为：\n\n* `auto`：自动判断位置\n* `top-start`：位于上方，且左对齐\n* `top`：位于上方，且居中对齐\n* `top-end`：位于上方，且右对齐\n* `bottom-start`：位于下方，且左对齐\n* `bottom`：位于下方，且居中对齐\n* `bottom-end`：位于下方，且右对齐\n* `left-start`：位于左侧，且顶部对齐\n* `left`：位于左侧，且居中对齐\n* `left-end`：位于左侧，且底部对齐\n* `right-start`：位于右侧，且顶部对齐\n* `right`：位于右侧，且居中对齐\n* `right-end`：位于右侧，且底部对齐",
+              "value": {
+                "type": [
+                  "'auto'",
+                  "'top-start'",
+                  "'top'",
+                  "'top-end'",
+                  "'bottom-start'",
+                  "'bottom'",
+                  "'bottom-end'",
+                  "'left-start'",
+                  "'left'",
+                  "'left-end'",
+                  "'right-start'",
+                  "'right'",
+                  "'right-end'"
+                ]
+              },
+              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-placement"
+            },
+            {
+              "name": "stay-open-on-click",
+              "description": "在点击 [`<mdui-menu-item>`](https://www.mdui.org/docs/2/components/menu#menu-item-api) 元素后，是否仍保持 dropdown 为打开状态",
+              "value": {
+                "type": "boolean"
+              },
+              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-stay-open-on-click"
+            },
+            {
+              "name": "open-delay",
+              "description": "通过 hover 触发 dropdown 打开时的延时，单位为毫秒",
+              "value": {
+                "type": "number"
+              },
+              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-open-delay"
+            },
+            {
+              "name": "close-delay",
+              "description": "通过 hover 触发 dropdown 关闭时的延时，单位为毫秒",
+              "value": {
+                "type": "number"
+              },
+              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-close-delay"
+            },
+            {
+              "name": "open-on-pointer",
+              "description": "是否在触发 dropdown 时的光标所在的位置打开 dropdown。通常用于在打开鼠标右键菜单时使用",
+              "value": {
+                "type": "boolean"
+              },
+              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-open-on-pointer"
+            }
+          ],
+          "priority": "highest",
+          "doc-url": "https://www.mdui.org/docs/2/components/dropdown",
+          "slots": [
+            {
+              "name": "",
+              "description": "dropdown 的内容",
+              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#slot-"
+            },
+            {
+              "name": "trigger",
+              "description": "触发 dropdown 的元素，例如 [`<mdui-button>`](https://www.mdui.org/docs/2/components/button) 元素",
+              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#slot-trigger"
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "open",
+                "description": "dropdown 是否打开",
+                "value": {
+                  "type": "boolean"
+                },
+                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-open"
+              },
+              {
+                "name": "disabled",
+                "description": "是否禁用 dropdown",
+                "value": {
+                  "type": "boolean"
+                },
+                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-disabled"
+              },
+              {
+                "name": "trigger",
+                "description": "dropdown 的触发方式，支持传入多个值，用空格分隔。可选值为：\n\n* `click`：点击时触发\n* `hover`：鼠标悬浮触发\n* `focus`：聚焦时触发\n* `contextmenu`：鼠标右键点击、或触摸长按时触发\n* `manual`：使用了该值时，只能使用编程方式打开和关闭 dropdown，且不能再指定其他触发方式",
+                "value": {
+                  "type": [
+                    "'click'",
+                    "'hover'",
+                    "'focus'",
+                    "'contextmenu'",
+                    "'manual'",
+                    "string"
+                  ]
+                },
+                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-trigger"
+              },
+              {
+                "name": "placement",
+                "description": "dropdown 内容的位置。可选值为：\n\n* `auto`：自动判断位置\n* `top-start`：位于上方，且左对齐\n* `top`：位于上方，且居中对齐\n* `top-end`：位于上方，且右对齐\n* `bottom-start`：位于下方，且左对齐\n* `bottom`：位于下方，且居中对齐\n* `bottom-end`：位于下方，且右对齐\n* `left-start`：位于左侧，且顶部对齐\n* `left`：位于左侧，且居中对齐\n* `left-end`：位于左侧，且底部对齐\n* `right-start`：位于右侧，且顶部对齐\n* `right`：位于右侧，且居中对齐\n* `right-end`：位于右侧，且底部对齐",
+                "value": {
+                  "type": [
+                    "'auto'",
+                    "'top-start'",
+                    "'top'",
+                    "'top-end'",
+                    "'bottom-start'",
+                    "'bottom'",
+                    "'bottom-end'",
+                    "'left-start'",
+                    "'left'",
+                    "'left-end'",
+                    "'right-start'",
+                    "'right'",
+                    "'right-end'"
+                  ]
+                },
+                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-placement"
+              },
+              {
+                "name": "stayOpenOnClick",
+                "description": "在点击 [`<mdui-menu-item>`](https://www.mdui.org/docs/2/components/menu#menu-item-api) 元素后，是否仍保持 dropdown 为打开状态",
+                "value": {
+                  "type": "boolean"
+                },
+                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-stayOpenOnClick"
+              },
+              {
+                "name": "openDelay",
+                "description": "通过 hover 触发 dropdown 打开时的延时，单位为毫秒",
+                "value": {
+                  "type": "number"
+                },
+                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-openDelay"
+              },
+              {
+                "name": "closeDelay",
+                "description": "通过 hover 触发 dropdown 关闭时的延时，单位为毫秒",
+                "value": {
+                  "type": "number"
+                },
+                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-closeDelay"
+              },
+              {
+                "name": "openOnPointer",
+                "description": "是否在触发 dropdown 时的光标所在的位置打开 dropdown。通常用于在打开鼠标右键菜单时使用",
+                "value": {
+                  "type": "boolean"
+                },
+                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-openOnPointer"
+              }
+            ],
+            "events": [
+              {
+                "name": "open",
+                "description": "dropdown 开始打开时，事件被触发。可以通过调用 `event.preventDefault()` 阻止 dropdown 打开",
+                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#event-open"
+              },
+              {
+                "name": "opened",
+                "description": "dropdown 打开动画完成时，事件被触发",
+                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#event-opened"
+              },
+              {
+                "name": "close",
+                "description": "dropdown 开始关闭时，事件被触发。可以通过调用 `event.preventDefault()` 阻止 dropdown 关闭",
+                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#event-close"
+              },
+              {
+                "name": "closed",
+                "description": "dropdown 关闭动画完成时，事件被触发",
+                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#event-closed"
+              }
+            ]
+          },
+          "css": {
+            "properties": [
+              {
+                "name": "--z-index",
+                "description": "组件的 CSS 的 `z-index` 值",
+                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#css-properties-z-index"
+              }
+            ],
+            "parts": [
+              {
+                "name": "trigger",
+                "description": "触发 dropdown 的元素的容器，即 `trigger` slot 的容器",
+                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#css-parts-trigger"
+              },
+              {
+                "name": "panel",
+                "description": "dropdown 内容的容器",
+                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#css-parts-panel"
+              }
+            ]
+          }
+        },
         {
           "name": "mdui-fab",
           "description": "浮动操作按钮组件\n\n```html\n<mdui-fab icon=\"edit\"></mdui-fab>\n```",
@@ -3233,12 +3470,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/fab#attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/fab#attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/fab#attributes-tabindex"
             },
             {
               "name": "disabled",
@@ -3812,32 +4049,116 @@
           }
         },
         {
-          "name": "mdui-menu-item",
-          "description": "菜单项组件\n\n```html\n<mdui-menu>\n  <mdui-menu-item>Item 1</mdui-menu-item>\n  <mdui-menu-item>Item 2</mdui-menu-item>\n</mdui-menu>\n```",
+          "name": "mdui-linear-progress",
+          "description": "线性进度指示器组件\n\n```html\n<mdui-linear-progress></mdui-linear-progress>\n```",
           "attributes": [
             {
-              "name": "value",
-              "description": "该菜单项的值",
+              "name": "max",
+              "description": "进度指示器的最大值，默认为 1",
               "value": {
-                "type": "string"
+                "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-value"
+              "doc-url": "https://www.mdui.org/docs/2/components/linear-progress#attributes-max"
             },
             {
-              "name": "disabled",
-              "description": "是否禁用该菜单项",
+              "name": "value",
+              "description": "进度指示器的当前值。若未指定该值，则为不确定状态",
               "value": {
-                "type": "boolean"
+                "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-disabled"
+              "doc-url": "https://www.mdui.org/docs/2/components/linear-progress#attributes-value"
+            }
+          ],
+          "priority": "highest",
+          "doc-url": "https://www.mdui.org/docs/2/components/linear-progress",
+          "js": {
+            "properties": [
+              {
+                "name": "max",
+                "description": "进度指示器的最大值，默认为 1",
+                "value": {
+                  "type": "number"
+                },
+                "doc-url": "https://www.mdui.org/docs/2/components/linear-progress#attributes-max"
+              },
+              {
+                "name": "value",
+                "description": "进度指示器的当前值。若未指定该值，则为不确定状态",
+                "value": {
+                  "type": "number"
+                },
+                "doc-url": "https://www.mdui.org/docs/2/components/linear-progress#attributes-value"
+              }
+            ]
+          },
+          "css": {
+            "properties": [
+              {
+                "name": "--shape-corner",
+                "description": "组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](https://www.mdui.org/docs/2/styles/design-tokens#shape-corner)",
+                "doc-url": "https://www.mdui.org/docs/2/components/linear-progress#css-properties-shape-corner"
+              }
+            ],
+            "parts": [
+              {
+                "name": "indicator",
+                "description": "指示器",
+                "doc-url": "https://www.mdui.org/docs/2/components/linear-progress#css-parts-indicator"
+              }
+            ]
+          }
+        },
+        {
+          "name": "mdui-list-item",
+          "description": "列表项组件。需与 `<mdui-list>` 组件配合使用\n\n```html\n<mdui-list>\n  <mdui-list-subheader>Subheader</mdui-list-subheader>\n  <mdui-list-item>Item 1</mdui-list-item>\n  <mdui-list-item>Item 2</mdui-list-item>\n</mdui-list>\n```",
+          "attributes": [
+            {
+              "name": "headline",
+              "description": "主文本。也可以通过 default slot 设置",
+              "value": {
+                "type": "string"
+              },
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-headline"
+            },
+            {
+              "name": "headline-line",
+              "description": "主文本行数，超过行数限制后会截断显示。默认为没有行数限制。可选值为：\n\n* `1`：显示单行文本，超出后截断显示\n* `2`：显示两行文本，超出后截断显示\n* `3`：显示三行文本，超出后截断显示",
+              "value": {
+                "type": [
+                  "1",
+                  "2",
+                  "3"
+                ]
+              },
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-headline-line"
+            },
+            {
+              "name": "description",
+              "description": "副文本。也可以通过 `slot=\"description\"` 设置",
+              "value": {
+                "type": "string"
+              },
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-description"
+            },
+            {
+              "name": "description-line",
+              "description": "副文本行数，超过行数限制后会截断显示。默认为没有行数限制。可选值为：\n\n* `1`：显示单行文本，超出后截断显示\n* `2`：显示两行文本，超出后截断显示\n* `3`：显示三行文本，超出后截断显示",
+              "value": {
+                "type": [
+                  "1",
+                  "2",
+                  "3"
+                ]
+              },
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-description-line"
             },
             {
               "name": "icon",
-              "description": "左侧的 Material Icons 图标名。也可以通过 `slot=\"icon\"` 设置\n\n如果需要在左侧留出一个图标的位置，可以传入空字符串进行占位",
+              "description": "左侧的 Material Icons 图标名。也可以通过 `slot=\"icon\"` 设置",
               "value": {
                 "type": "string"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-icon"
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-icon"
             },
             {
               "name": "end-icon",
@@ -3845,31 +4166,51 @@
               "value": {
                 "type": "string"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-end-icon"
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-end-icon"
             },
             {
-              "name": "end-text",
-              "description": "右侧的文本。也可以通过 `slot=\"end-text\"` 设置",
+              "name": "disabled",
+              "description": "是否禁用该列表项，列表项将置灰，且其中的 [`<mdui-checkbox>`](https://www.mdui.org/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等都将禁用",
               "value": {
-                "type": "string"
+                "type": "boolean"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-end-text"
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-disabled"
             },
             {
-              "name": "selected-icon",
-              "description": "选中状态的 Material Icons 图标名。也可以通过 `slot=\"selected-icon\"` 设置",
+              "name": "active",
+              "description": "是否激活该列表项",
               "value": {
-                "type": "string"
+                "type": "boolean"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-selected-icon"
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-active"
             },
             {
-              "name": "submenu-open",
-              "description": "是否打开子菜单",
+              "name": "nonclickable",
+              "description": "是否使列表项不可点击，但其中的 [`<mdui-checkbox>`](https://www.mdui.org/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等仍可进行交互",
               "value": {
                 "type": "boolean"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-submenu-open"
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-nonclickable"
+            },
+            {
+              "name": "rounded",
+              "description": "使用圆角形状的列表项",
+              "value": {
+                "type": "boolean"
+              },
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-rounded"
+            },
+            {
+              "name": "alignment",
+              "description": "列表项的垂直对齐方式。可选值为：\n\n* `start`：顶部对齐\n* `center`：居中对齐\n* `end`：底部对齐",
+              "value": {
+                "type": [
+                  "'start'",
+                  "'center'",
+                  "'end'"
+                ]
+              },
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-alignment"
             },
             {
               "name": "href",
@@ -3877,7 +4218,7 @@
               "value": {
                 "type": "string"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-href"
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-href"
             },
             {
               "name": "download",
@@ -3885,7 +4226,7 @@
               "value": {
                 "type": "string"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-download"
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-download"
             },
             {
               "name": "target",
@@ -3898,7 +4239,7 @@
                   "'_top'"
                 ]
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-target"
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-target"
             },
             {
               "name": "rel",
@@ -3921,7 +4262,7 @@
                   "'tag'"
                 ]
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-rel"
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-rel"
             },
             {
               "name": "autofocus",
@@ -3929,142 +4270,176 @@
               "value": {
                 "type": "boolean"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-autofocus"
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-tabindex"
             }
           ],
           "priority": "highest",
-          "doc-url": "https://www.mdui.org/docs/2/components/menu",
+          "doc-url": "https://www.mdui.org/docs/2/components/list",
           "slots": [
             {
               "name": "",
-              "description": "菜单项的文本",
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-slot-"
-            },
-            {
-              "name": "icon",
-              "description": "菜单项左侧图标",
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-slot-icon"
-            },
-            {
-              "name": "end-icon",
-              "description": "菜单项右侧图标",
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-slot-end-icon"
+              "description": "主文本",
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-slot-"
             },
             {
-              "name": "end-text",
-              "description": "菜单右侧的文本",
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-slot-end-text"
+              "name": "description",
+              "description": "副文本",
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-slot-description"
             },
             {
-              "name": "selected-icon",
-              "description": "选中状态的图标",
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-slot-selected-icon"
+              "name": "icon",
+              "description": "列表项左侧的元素",
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-slot-icon"
             },
             {
-              "name": "submenu",
-              "description": "子菜单",
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-slot-submenu"
+              "name": "end-icon",
+              "description": "列表项右侧的元素",
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-slot-end-icon"
             },
             {
               "name": "custom",
               "description": "任意自定义内容",
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-slot-custom"
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-slot-custom"
             }
           ],
           "js": {
             "properties": [
               {
-                "name": "value",
-                "description": "该菜单项的值",
+                "name": "headline",
+                "description": "主文本。也可以通过 default slot 设置",
                 "value": {
                   "type": "string"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-value"
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-headline"
               },
               {
-                "name": "disabled",
-                "description": "是否禁用该菜单项",
+                "name": "headlineLine",
+                "description": "主文本行数，超过行数限制后会截断显示。默认为没有行数限制。可选值为：\n\n* `1`：显示单行文本，超出后截断显示\n* `2`：显示两行文本，超出后截断显示\n* `3`：显示三行文本，超出后截断显示",
                 "value": {
-                  "type": "boolean"
+                  "type": [
+                    "1",
+                    "2",
+                    "3"
+                  ]
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-disabled"
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-headlineLine"
               },
               {
-                "name": "icon",
-                "description": "左侧的 Material Icons 图标名。也可以通过 `slot=\"icon\"` 设置\n\n如果需要在左侧留出一个图标的位置，可以传入空字符串进行占位",
+                "name": "description",
+                "description": "副文本。也可以通过 `slot=\"description\"` 设置",
                 "value": {
                   "type": "string"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-icon"
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-description"
               },
               {
-                "name": "endIcon",
-                "description": "右侧的 Material Icons 图标名。也可以通过 `slot=\"end-icon\"` 设置",
+                "name": "descriptionLine",
+                "description": "副文本行数，超过行数限制后会截断显示。默认为没有行数限制。可选值为：\n\n* `1`：显示单行文本，超出后截断显示\n* `2`：显示两行文本，超出后截断显示\n* `3`：显示三行文本，超出后截断显示",
                 "value": {
-                  "type": "string"
+                  "type": [
+                    "1",
+                    "2",
+                    "3"
+                  ]
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-endIcon"
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-descriptionLine"
               },
               {
-                "name": "endText",
-                "description": "右侧的文本。也可以通过 `slot=\"end-text\"` 设置",
+                "name": "icon",
+                "description": "左侧的 Material Icons 图标名。也可以通过 `slot=\"icon\"` 设置",
                 "value": {
                   "type": "string"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-endText"
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-icon"
               },
               {
-                "name": "selectedIcon",
-                "description": "选中状态的 Material Icons 图标名。也可以通过 `slot=\"selected-icon\"` 设置",
+                "name": "endIcon",
+                "description": "右侧的 Material Icons 图标名。也可以通过 `slot=\"end-icon\"` 设置",
                 "value": {
                   "type": "string"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-selectedIcon"
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-endIcon"
               },
               {
-                "name": "submenuOpen",
-                "description": "是否打开子菜单",
+                "name": "disabled",
+                "description": "是否禁用该列表项，列表项将置灰，且其中的 [`<mdui-checkbox>`](https://www.mdui.org/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等都将禁用",
                 "value": {
                   "type": "boolean"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-submenuOpen"
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-disabled"
               },
               {
-                "name": "href",
-                "description": "链接指向的页面的 URL。\n\n若指定了该属性，则组件内部会渲染为 `<a>` 元素，并可以使用链接相关的属性",
+                "name": "active",
+                "description": "是否激活该列表项",
                 "value": {
-                  "type": "string"
+                  "type": "boolean"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-href"
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-active"
               },
               {
-                "name": "download",
-                "description": "被下载的超链接目标。\n\n**Note**：仅在指定了 `href` 属性时可用",
+                "name": "nonclickable",
+                "description": "是否使列表项不可点击，但其中的 [`<mdui-checkbox>`](https://www.mdui.org/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等仍可进行交互",
                 "value": {
-                  "type": "string"
+                  "type": "boolean"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-download"
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-nonclickable"
               },
               {
-                "name": "target",
-                "description": "在何处打开链接。可选值为：\n\n* `_blank`：在新窗口中打开链接\n* `_parent`：在父框架中打开链接\n* `_self`：默认。在相同的框架中打开链接\n* `_top`：在整个窗口中打开链接\n\n**Note**：仅在指定了 `href` 属性时可用",
+                "name": "rounded",
+                "description": "使用圆角形状的列表项",
                 "value": {
-                  "type": [
-                    "'_blank'",
-                    "'_parent'",
+                  "type": "boolean"
+                },
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-rounded"
+              },
+              {
+                "name": "alignment",
+                "description": "列表项的垂直对齐方式。可选值为：\n\n* `start`：顶部对齐\n* `center`：居中对齐\n* `end`：底部对齐",
+                "value": {
+                  "type": [
+                    "'start'",
+                    "'center'",
+                    "'end'"
+                  ]
+                },
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-alignment"
+              },
+              {
+                "name": "href",
+                "description": "链接指向的页面的 URL。\n\n若指定了该属性，则组件内部会渲染为 `<a>` 元素，并可以使用链接相关的属性",
+                "value": {
+                  "type": "string"
+                },
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-href"
+              },
+              {
+                "name": "download",
+                "description": "被下载的超链接目标。\n\n**Note**：仅在指定了 `href` 属性时可用",
+                "value": {
+                  "type": "string"
+                },
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-download"
+              },
+              {
+                "name": "target",
+                "description": "在何处打开链接。可选值为：\n\n* `_blank`：在新窗口中打开链接\n* `_parent`：在父框架中打开链接\n* `_self`：默认。在相同的框架中打开链接\n* `_top`：在整个窗口中打开链接\n\n**Note**：仅在指定了 `href` 属性时可用",
+                "value": {
+                  "type": [
+                    "'_blank'",
+                    "'_parent'",
                     "'_self'",
                     "'_top'"
                   ]
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-target"
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-target"
               },
               {
                 "name": "rel",
@@ -4087,7 +4462,7 @@
                     "'tag'"
                   ]
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-rel"
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-rel"
               },
               {
                 "name": "autofocus",
@@ -4095,7 +4470,7 @@
                 "value": {
                   "type": "boolean"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-autofocus"
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-autofocus"
               },
               {
                 "name": "tabIndex",
@@ -4103,408 +4478,162 @@
                 "value": {
                   "type": "number"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-tabIndex"
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-tabIndex"
               }
             ],
             "events": [
               {
                 "name": "focus",
                 "description": "获得焦点时触发",
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-event-focus"
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-event-focus"
               },
               {
                 "name": "blur",
                 "description": "失去焦点时触发",
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-event-blur"
-              },
-              {
-                "name": "submenu-open",
-                "description": "子菜单开始打开时，事件被触发。可以通过调用 `event.preventDefault()` 阻止子菜单打开",
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-event-submenu-open"
-              },
-              {
-                "name": "submenu-opened",
-                "description": "子菜单打开动画完成时，事件被触发",
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-event-submenu-opened"
-              },
-              {
-                "name": "submenu-close",
-                "description": "子菜单开始关闭时，事件被触发。可以通过调用 `event.preventDefault()` 阻止子菜单关闭",
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-event-submenu-close"
-              },
-              {
-                "name": "submenu-closed",
-                "description": "子菜单关闭动画完成时，事件被触发",
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-event-submenu-closed"
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-event-blur"
               }
             ]
           },
           "css": {
+            "properties": [
+              {
+                "name": "--shape-corner",
+                "description": "列表项的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](https://www.mdui.org/docs/2/styles/design-tokens#shape-corner)",
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-properties-shape-corner"
+              },
+              {
+                "name": "--shape-corner-rounded",
+                "description": "指定了 `rounded` 时，列表项的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](https://www.mdui.org/docs/2/styles/design-tokens#shape-corner)",
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-properties-shape-corner-rounded"
+              }
+            ],
             "parts": [
               {
                 "name": "container",
-                "description": "菜单项的容器",
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-css-parts-container"
+                "description": "列表项容器",
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-parts-container"
               },
               {
                 "name": "icon",
-                "description": "左侧的图标",
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-css-parts-icon"
-              },
-              {
-                "name": "label",
-                "description": "文本内容",
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-css-parts-label"
+                "description": "左侧图标",
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-parts-icon"
               },
               {
                 "name": "end-icon",
-                "description": "右侧的图标",
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-css-parts-end-icon"
+                "description": "右侧图标",
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-parts-end-icon"
               },
               {
-                "name": "end-text",
-                "description": "右侧的文本",
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-css-parts-end-text"
+                "name": "body",
+                "description": "中间部分",
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-parts-body"
               },
               {
-                "name": "selected-icon",
-                "description": "选中状态的图标",
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-css-parts-selected-icon"
+                "name": "headline",
+                "description": "主标题",
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-parts-headline"
               },
               {
-                "name": "submenu",
-                "description": "子菜单元素",
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-css-parts-submenu"
+                "name": "description",
+                "description": "副标题",
+                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-parts-description"
               }
             ]
           }
         },
         {
-          "name": "mdui-menu",
-          "description": "菜单组件。需与 `<mdui-menu-item>` 组件配合使用\n\n```html\n<mdui-menu>\n  <mdui-menu-item>Item 1</mdui-menu-item>\n  <mdui-menu-item>Item 2</mdui-menu-item>\n</mdui-menu>\n```",
+          "name": "mdui-list-subheader",
+          "description": "列表标题组件。需与 `<mdui-list>` 组件配合使用\n\n```html\n<mdui-list>\n  <mdui-list-subheader>Subheader</mdui-list-subheader>\n  <mdui-list-item>Item 1</mdui-list-item>\n  <mdui-list-item>Item 2</mdui-list-item>\n</mdui-list>\n```",
+          "priority": "highest",
+          "doc-url": "https://www.mdui.org/docs/2/components/list",
+          "slots": [
+            {
+              "name": "",
+              "description": "文本",
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-subheader-slot-"
+            }
+          ]
+        },
+        {
+          "name": "mdui-list",
+          "description": "列表组件。需与 `<mdui-list-item>` 组件配合使用\n\n```html\n<mdui-list>\n  <mdui-list-subheader>Subheader</mdui-list-subheader>\n  <mdui-list-item>Item 1</mdui-list-item>\n  <mdui-list-item>Item 2</mdui-list-item>\n</mdui-list>\n```",
+          "priority": "highest",
+          "doc-url": "https://www.mdui.org/docs/2/components/list",
+          "slots": [
+            {
+              "name": "",
+              "description": "`<mdui-list-item>` 元素",
+              "doc-url": "https://www.mdui.org/docs/2/components/list#list-slot-"
+            }
+          ]
+        },
+        {
+          "name": "mdui-menu-item",
+          "description": "菜单项组件\n\n```html\n<mdui-menu>\n  <mdui-menu-item>Item 1</mdui-menu-item>\n  <mdui-menu-item>Item 2</mdui-menu-item>\n</mdui-menu>\n```",
           "attributes": [
             {
-              "name": "selects",
-              "description": "菜单项的可选中状态。默认为不可选中。可选值为：\n\n* `single`：最多只能选中一个\n* `multiple`：可以选中多个",
+              "name": "value",
+              "description": "该菜单项的值",
               "value": {
-                "type": [
-                  "'single'",
-                  "'multiple'"
-                ]
+                "type": "string"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-selects"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-value"
             },
             {
-              "name": "value",
-              "description": "当前选中的 `<mdui-menu-item>` 的值\n\nNote:\n该属性的 HTML 属性始终为字符串，且仅在 `selects=\"single\"` 时可以通过 HTML 属性设置初始值；\n该属性的 JavaScript 属性值在 `selects=\"single\"` 时为字符串、在 `selects=\"multiple\"` 时为字符串数组。\n所以，在 `selects=\"multiple\"` 时，如果要修改该值，只能通过修改 JavaScript 属性值实现。",
+              "name": "disabled",
+              "description": "是否禁用该菜单项",
               "value": {
-                "type": [
-                  "string",
-                  "string[]"
-                ]
+                "type": "boolean"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-value"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-disabled"
             },
             {
-              "name": "dense",
-              "description": "菜单项是否使用更紧凑的布局",
+              "name": "icon",
+              "description": "左侧的 Material Icons 图标名。也可以通过 `slot=\"icon\"` 设置\n\n如果需要在左侧留出一个图标的位置，可以传入空字符串进行占位",
               "value": {
-                "type": "boolean"
+                "type": "string"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-dense"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-icon"
             },
             {
-              "name": "submenu-trigger",
-              "description": "子菜单的触发方式，支持传入多个值，用空格分隔。可选值为：\n\n* `click`：点击菜单项时打开子菜单\n* `hover`：鼠标悬浮到菜单项上时打开子菜单\n* `focus`：聚焦到菜单项上时打开子菜单\n* `manual`：使用了该值时，只能使用编程方式打开和关闭子菜单，且不能再指定其他触发方式",
+              "name": "end-icon",
+              "description": "右侧的 Material Icons 图标名。也可以通过 `slot=\"end-icon\"` 设置",
               "value": {
-                "type": [
-                  "'click'",
-                  "'hover'",
-                  "'focus'",
-                  "'manual'",
-                  "string"
-                ]
+                "type": "string"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenu-trigger"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-end-icon"
             },
             {
-              "name": "submenu-open-delay",
-              "description": "通过 hover 触发子菜单打开时的延时，单位为毫秒",
+              "name": "end-text",
+              "description": "右侧的文本。也可以通过 `slot=\"end-text\"` 设置",
               "value": {
-                "type": "number"
+                "type": "string"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenu-open-delay"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-end-text"
             },
             {
-              "name": "submenu-close-delay",
-              "description": "通过 hover 触发子菜单关闭时的延时，单位为毫秒",
+              "name": "selected-icon",
+              "description": "选中状态的 Material Icons 图标名。也可以通过 `slot=\"selected-icon\"` 设置",
               "value": {
-                "type": "number"
+                "type": "string"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenu-close-delay"
-            }
-          ],
-          "priority": "highest",
-          "doc-url": "https://www.mdui.org/docs/2/components/menu",
-          "slots": [
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-selected-icon"
+            },
             {
-              "name": "",
-              "description": "子菜单项（`<mdui-menu-item>`）、分割线（[`<mdui-divider>`](https://www.mdui.org/docs/2/components/divider)）等元素",
-              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-slot-"
-            }
-          ],
-          "js": {
-            "properties": [
-              {
-                "name": "selects",
-                "description": "菜单项的可选中状态。默认为不可选中。可选值为：\n\n* `single`：最多只能选中一个\n* `multiple`：可以选中多个",
-                "value": {
-                  "type": [
-                    "'single'",
-                    "'multiple'"
-                  ]
-                },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-selects"
+              "name": "submenu-open",
+              "description": "是否打开子菜单",
+              "value": {
+                "type": "boolean"
               },
-              {
-                "name": "value",
-                "description": "当前选中的 `<mdui-menu-item>` 的值\n\nNote:\n该属性的 HTML 属性始终为字符串，且仅在 `selects=\"single\"` 时可以通过 HTML 属性设置初始值；\n该属性的 JavaScript 属性值在 `selects=\"single\"` 时为字符串、在 `selects=\"multiple\"` 时为字符串数组。\n所以，在 `selects=\"multiple\"` 时，如果要修改该值，只能通过修改 JavaScript 属性值实现。",
-                "value": {
-                  "type": [
-                    "string",
-                    "string[]"
-                  ]
-                },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-value"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-submenu-open"
+            },
+            {
+              "name": "href",
+              "description": "链接指向的页面的 URL。\n\n若指定了该属性，则组件内部会渲染为 `<a>` 元素，并可以使用链接相关的属性",
+              "value": {
+                "type": "string"
               },
-              {
-                "name": "dense",
-                "description": "菜单项是否使用更紧凑的布局",
-                "value": {
-                  "type": "boolean"
-                },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-dense"
-              },
-              {
-                "name": "submenuTrigger",
-                "description": "子菜单的触发方式，支持传入多个值，用空格分隔。可选值为：\n\n* `click`：点击菜单项时打开子菜单\n* `hover`：鼠标悬浮到菜单项上时打开子菜单\n* `focus`：聚焦到菜单项上时打开子菜单\n* `manual`：使用了该值时，只能使用编程方式打开和关闭子菜单，且不能再指定其他触发方式",
-                "value": {
-                  "type": [
-                    "'click'",
-                    "'hover'",
-                    "'focus'",
-                    "'manual'",
-                    "string"
-                  ]
-                },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenuTrigger"
-              },
-              {
-                "name": "submenuOpenDelay",
-                "description": "通过 hover 触发子菜单打开时的延时，单位为毫秒",
-                "value": {
-                  "type": "number"
-                },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenuOpenDelay"
-              },
-              {
-                "name": "submenuCloseDelay",
-                "description": "通过 hover 触发子菜单关闭时的延时，单位为毫秒",
-                "value": {
-                  "type": "number"
-                },
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenuCloseDelay"
-              }
-            ],
-            "events": [
-              {
-                "name": "change",
-                "description": "菜单项的选中状态变化时触发",
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-event-change"
-              }
-            ]
-          },
-          "css": {
-            "properties": [
-              {
-                "name": "--shape-corner",
-                "description": "组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](https://www.mdui.org/docs/2/styles/design-tokens#shape-corner)",
-                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-css-properties-shape-corner"
-              }
-            ]
-          }
-        },
-        {
-          "name": "mdui-linear-progress",
-          "description": "线性进度指示器组件\n\n```html\n<mdui-linear-progress></mdui-linear-progress>\n```",
-          "attributes": [
-            {
-              "name": "max",
-              "description": "进度指示器的最大值，默认为 1",
-              "value": {
-                "type": "number"
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/linear-progress#attributes-max"
-            },
-            {
-              "name": "value",
-              "description": "进度指示器的当前值。若未指定该值，则为不确定状态",
-              "value": {
-                "type": "number"
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/linear-progress#attributes-value"
-            }
-          ],
-          "priority": "highest",
-          "doc-url": "https://www.mdui.org/docs/2/components/linear-progress",
-          "js": {
-            "properties": [
-              {
-                "name": "max",
-                "description": "进度指示器的最大值，默认为 1",
-                "value": {
-                  "type": "number"
-                },
-                "doc-url": "https://www.mdui.org/docs/2/components/linear-progress#attributes-max"
-              },
-              {
-                "name": "value",
-                "description": "进度指示器的当前值。若未指定该值，则为不确定状态",
-                "value": {
-                  "type": "number"
-                },
-                "doc-url": "https://www.mdui.org/docs/2/components/linear-progress#attributes-value"
-              }
-            ]
-          },
-          "css": {
-            "properties": [
-              {
-                "name": "--shape-corner",
-                "description": "组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](https://www.mdui.org/docs/2/styles/design-tokens#shape-corner)",
-                "doc-url": "https://www.mdui.org/docs/2/components/linear-progress#css-properties-shape-corner"
-              }
-            ],
-            "parts": [
-              {
-                "name": "indicator",
-                "description": "指示器",
-                "doc-url": "https://www.mdui.org/docs/2/components/linear-progress#css-parts-indicator"
-              }
-            ]
-          }
-        },
-        {
-          "name": "mdui-list-item",
-          "description": "列表项组件。需与 `<mdui-list>` 组件配合使用\n\n```html\n<mdui-list>\n  <mdui-list-subheader>Subheader</mdui-list-subheader>\n  <mdui-list-item>Item 1</mdui-list-item>\n  <mdui-list-item>Item 2</mdui-list-item>\n</mdui-list>\n```",
-          "attributes": [
-            {
-              "name": "headline",
-              "description": "主文本。也可以通过 default slot 设置",
-              "value": {
-                "type": "string"
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-headline"
-            },
-            {
-              "name": "headline-line",
-              "description": "主文本行数，超过行数限制后会截断显示。默认为没有行数限制。可选值为：\n\n* `1`：显示单行文本，超出后截断显示\n* `2`：显示两行文本，超出后截断显示\n* `3`：显示三行文本，超出后截断显示",
-              "value": {
-                "type": [
-                  "1",
-                  "2",
-                  "3"
-                ]
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-headline-line"
-            },
-            {
-              "name": "description",
-              "description": "副文本。也可以通过 `slot=\"description\"` 设置",
-              "value": {
-                "type": "string"
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-description"
-            },
-            {
-              "name": "description-line",
-              "description": "副文本行数，超过行数限制后会截断显示。默认为没有行数限制。可选值为：\n\n* `1`：显示单行文本，超出后截断显示\n* `2`：显示两行文本，超出后截断显示\n* `3`：显示三行文本，超出后截断显示",
-              "value": {
-                "type": [
-                  "1",
-                  "2",
-                  "3"
-                ]
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-description-line"
-            },
-            {
-              "name": "icon",
-              "description": "左侧的 Material Icons 图标名。也可以通过 `slot=\"icon\"` 设置",
-              "value": {
-                "type": "string"
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-icon"
-            },
-            {
-              "name": "end-icon",
-              "description": "右侧的 Material Icons 图标名。也可以通过 `slot=\"end-icon\"` 设置",
-              "value": {
-                "type": "string"
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-end-icon"
-            },
-            {
-              "name": "disabled",
-              "description": "是否禁用该列表项，列表项将置灰，且其中的 [`<mdui-checkbox>`](https://www.mdui.org/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等都将禁用",
-              "value": {
-                "type": "boolean"
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-disabled"
-            },
-            {
-              "name": "active",
-              "description": "是否激活该列表项",
-              "value": {
-                "type": "boolean"
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-active"
-            },
-            {
-              "name": "nonclickable",
-              "description": "是否使列表项不可点击，但其中的 [`<mdui-checkbox>`](https://www.mdui.org/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等仍可进行交互",
-              "value": {
-                "type": "boolean"
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-nonclickable"
-            },
-            {
-              "name": "rounded",
-              "description": "使用圆角形状的列表项",
-              "value": {
-                "type": "boolean"
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-rounded"
-            },
-            {
-              "name": "alignment",
-              "description": "列表项的垂直对齐方式。可选值为：\n\n* `start`：顶部对齐\n* `center`：居中对齐\n* `end`：底部对齐",
-              "value": {
-                "type": [
-                  "'start'",
-                  "'center'",
-                  "'end'"
-                ]
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-alignment"
-            },
-            {
-              "name": "href",
-              "description": "链接指向的页面的 URL。\n\n若指定了该属性，则组件内部会渲染为 `<a>` 元素，并可以使用链接相关的属性",
-              "value": {
-                "type": "string"
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-href"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-href"
             },
             {
               "name": "download",
@@ -4512,7 +4641,7 @@
               "value": {
                 "type": "string"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-download"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-download"
             },
             {
               "name": "target",
@@ -4525,7 +4654,7 @@
                   "'_top'"
                 ]
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-target"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-target"
             },
             {
               "name": "rel",
@@ -4548,7 +4677,7 @@
                   "'tag'"
                 ]
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-rel"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-rel"
             },
             {
               "name": "autofocus",
@@ -4556,95 +4685,81 @@
               "value": {
                 "type": "boolean"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-autofocus"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-tabindex"
             }
           ],
           "priority": "highest",
-          "doc-url": "https://www.mdui.org/docs/2/components/list",
+          "doc-url": "https://www.mdui.org/docs/2/components/menu",
           "slots": [
             {
               "name": "",
-              "description": "主文本",
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-slot-"
-            },
-            {
-              "name": "description",
-              "description": "副文本",
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-slot-description"
+              "description": "菜单项的文本",
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-slot-"
             },
             {
               "name": "icon",
-              "description": "列表项左侧的元素",
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-slot-icon"
+              "description": "菜单项左侧图标",
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-slot-icon"
             },
             {
               "name": "end-icon",
-              "description": "列表项右侧的元素",
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-slot-end-icon"
+              "description": "菜单项右侧图标",
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-slot-end-icon"
+            },
+            {
+              "name": "end-text",
+              "description": "菜单右侧的文本",
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-slot-end-text"
+            },
+            {
+              "name": "selected-icon",
+              "description": "选中状态的图标",
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-slot-selected-icon"
+            },
+            {
+              "name": "submenu",
+              "description": "子菜单",
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-slot-submenu"
             },
             {
               "name": "custom",
               "description": "任意自定义内容",
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-slot-custom"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-slot-custom"
             }
           ],
           "js": {
             "properties": [
               {
-                "name": "headline",
-                "description": "主文本。也可以通过 default slot 设置",
-                "value": {
-                  "type": "string"
-                },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-headline"
-              },
-              {
-                "name": "headlineLine",
-                "description": "主文本行数，超过行数限制后会截断显示。默认为没有行数限制。可选值为：\n\n* `1`：显示单行文本，超出后截断显示\n* `2`：显示两行文本，超出后截断显示\n* `3`：显示三行文本，超出后截断显示",
-                "value": {
-                  "type": [
-                    "1",
-                    "2",
-                    "3"
-                  ]
-                },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-headlineLine"
-              },
-              {
-                "name": "description",
-                "description": "副文本。也可以通过 `slot=\"description\"` 设置",
+                "name": "value",
+                "description": "该菜单项的值",
                 "value": {
                   "type": "string"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-description"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-value"
               },
               {
-                "name": "descriptionLine",
-                "description": "副文本行数，超过行数限制后会截断显示。默认为没有行数限制。可选值为：\n\n* `1`：显示单行文本，超出后截断显示\n* `2`：显示两行文本，超出后截断显示\n* `3`：显示三行文本，超出后截断显示",
+                "name": "disabled",
+                "description": "是否禁用该菜单项",
                 "value": {
-                  "type": [
-                    "1",
-                    "2",
-                    "3"
-                  ]
+                  "type": "boolean"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-descriptionLine"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-disabled"
               },
               {
                 "name": "icon",
-                "description": "左侧的 Material Icons 图标名。也可以通过 `slot=\"icon\"` 设置",
+                "description": "左侧的 Material Icons 图标名。也可以通过 `slot=\"icon\"` 设置\n\n如果需要在左侧留出一个图标的位置，可以传入空字符串进行占位",
                 "value": {
                   "type": "string"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-icon"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-icon"
               },
               {
                 "name": "endIcon",
@@ -4652,51 +4767,31 @@
                 "value": {
                   "type": "string"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-endIcon"
-              },
-              {
-                "name": "disabled",
-                "description": "是否禁用该列表项，列表项将置灰，且其中的 [`<mdui-checkbox>`](https://www.mdui.org/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等都将禁用",
-                "value": {
-                  "type": "boolean"
-                },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-disabled"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-endIcon"
               },
               {
-                "name": "active",
-                "description": "是否激活该列表项",
+                "name": "endText",
+                "description": "右侧的文本。也可以通过 `slot=\"end-text\"` 设置",
                 "value": {
-                  "type": "boolean"
+                  "type": "string"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-active"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-endText"
               },
               {
-                "name": "nonclickable",
-                "description": "是否使列表项不可点击，但其中的 [`<mdui-checkbox>`](https://www.mdui.org/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等仍可进行交互",
+                "name": "selectedIcon",
+                "description": "选中状态的 Material Icons 图标名。也可以通过 `slot=\"selected-icon\"` 设置",
                 "value": {
-                  "type": "boolean"
+                  "type": "string"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-nonclickable"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-selectedIcon"
               },
               {
-                "name": "rounded",
-                "description": "使用圆角形状的列表项",
+                "name": "submenuOpen",
+                "description": "是否打开子菜单",
                 "value": {
                   "type": "boolean"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-rounded"
-              },
-              {
-                "name": "alignment",
-                "description": "列表项的垂直对齐方式。可选值为：\n\n* `start`：顶部对齐\n* `center`：居中对齐\n* `end`：底部对齐",
-                "value": {
-                  "type": [
-                    "'start'",
-                    "'center'",
-                    "'end'"
-                  ]
-                },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-alignment"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-submenuOpen"
               },
               {
                 "name": "href",
@@ -4704,7 +4799,7 @@
                 "value": {
                   "type": "string"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-href"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-href"
               },
               {
                 "name": "download",
@@ -4712,7 +4807,7 @@
                 "value": {
                   "type": "string"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-download"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-download"
               },
               {
                 "name": "target",
@@ -4725,7 +4820,7 @@
                     "'_top'"
                   ]
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-target"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-target"
               },
               {
                 "name": "rel",
@@ -4748,7 +4843,7 @@
                     "'tag'"
                   ]
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-rel"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-rel"
               },
               {
                 "name": "autofocus",
@@ -4756,7 +4851,7 @@
                 "value": {
                   "type": "boolean"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-autofocus"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-autofocus"
               },
               {
                 "name": "tabIndex",
@@ -4764,328 +4859,233 @@
                 "value": {
                   "type": "number"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-tabIndex"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-tabIndex"
               }
             ],
             "events": [
               {
                 "name": "focus",
                 "description": "获得焦点时触发",
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-event-focus"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-event-focus"
               },
               {
                 "name": "blur",
                 "description": "失去焦点时触发",
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-event-blur"
-              }
-            ]
-          },
-          "css": {
-            "properties": [
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-event-blur"
+              },
               {
-                "name": "--shape-corner",
-                "description": "列表项的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](https://www.mdui.org/docs/2/styles/design-tokens#shape-corner)",
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-properties-shape-corner"
+                "name": "submenu-open",
+                "description": "子菜单开始打开时，事件被触发。可以通过调用 `event.preventDefault()` 阻止子菜单打开",
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-event-submenu-open"
               },
               {
-                "name": "--shape-corner-rounded",
-                "description": "指定了 `rounded` 时，列表项的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](https://www.mdui.org/docs/2/styles/design-tokens#shape-corner)",
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-properties-shape-corner-rounded"
+                "name": "submenu-opened",
+                "description": "子菜单打开动画完成时，事件被触发",
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-event-submenu-opened"
+              },
+              {
+                "name": "submenu-close",
+                "description": "子菜单开始关闭时，事件被触发。可以通过调用 `event.preventDefault()` 阻止子菜单关闭",
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-event-submenu-close"
+              },
+              {
+                "name": "submenu-closed",
+                "description": "子菜单关闭动画完成时，事件被触发",
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-event-submenu-closed"
               }
-            ],
+            ]
+          },
+          "css": {
             "parts": [
               {
                 "name": "container",
-                "description": "列表项容器",
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-parts-container"
+                "description": "菜单项的容器",
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-css-parts-container"
               },
               {
                 "name": "icon",
-                "description": "左侧图标",
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-parts-icon"
+                "description": "左侧的图标",
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-css-parts-icon"
+              },
+              {
+                "name": "label",
+                "description": "文本内容",
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-css-parts-label"
               },
               {
                 "name": "end-icon",
-                "description": "右侧图标",
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-parts-end-icon"
+                "description": "右侧的图标",
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-css-parts-end-icon"
               },
               {
-                "name": "body",
-                "description": "中间部分",
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-parts-body"
+                "name": "end-text",
+                "description": "右侧的文本",
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-css-parts-end-text"
               },
               {
-                "name": "headline",
-                "description": "主标题",
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-parts-headline"
+                "name": "selected-icon",
+                "description": "选中状态的图标",
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-css-parts-selected-icon"
               },
               {
-                "name": "description",
-                "description": "副标题",
-                "doc-url": "https://www.mdui.org/docs/2/components/list#list-item-css-parts-description"
+                "name": "submenu",
+                "description": "子菜单元素",
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-item-css-parts-submenu"
               }
             ]
           }
         },
         {
-          "name": "mdui-list-subheader",
-          "description": "列表标题组件。需与 `<mdui-list>` 组件配合使用\n\n```html\n<mdui-list>\n  <mdui-list-subheader>Subheader</mdui-list-subheader>\n  <mdui-list-item>Item 1</mdui-list-item>\n  <mdui-list-item>Item 2</mdui-list-item>\n</mdui-list>\n```",
-          "priority": "highest",
-          "doc-url": "https://www.mdui.org/docs/2/components/list",
-          "slots": [
-            {
-              "name": "",
-              "description": "文本",
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-subheader-slot-"
-            }
-          ]
-        },
-        {
-          "name": "mdui-list",
-          "description": "列表组件。需与 `<mdui-list-item>` 组件配合使用\n\n```html\n<mdui-list>\n  <mdui-list-subheader>Subheader</mdui-list-subheader>\n  <mdui-list-item>Item 1</mdui-list-item>\n  <mdui-list-item>Item 2</mdui-list-item>\n</mdui-list>\n```",
-          "priority": "highest",
-          "doc-url": "https://www.mdui.org/docs/2/components/list",
-          "slots": [
-            {
-              "name": "",
-              "description": "`<mdui-list-item>` 元素",
-              "doc-url": "https://www.mdui.org/docs/2/components/list#list-slot-"
-            }
-          ]
-        },
-        {
-          "name": "mdui-dropdown",
-          "description": "下拉组件\n\n```html\n<mdui-dropdown>\n  <mdui-button slot=\"trigger\">open dropdown</mdui-button>\n  <mdui-menu>\n    <mdui-menu-item>Item 1</mdui-menu-item>\n    <mdui-menu-item>Item 2</mdui-menu-item>\n  </mdui-menu>\n</mdui-dropdown>\n```",
+          "name": "mdui-menu",
+          "description": "菜单组件。需与 `<mdui-menu-item>` 组件配合使用\n\n```html\n<mdui-menu>\n  <mdui-menu-item>Item 1</mdui-menu-item>\n  <mdui-menu-item>Item 2</mdui-menu-item>\n</mdui-menu>\n```",
           "attributes": [
             {
-              "name": "open",
-              "description": "dropdown 是否打开",
-              "value": {
-                "type": "boolean"
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-open"
-            },
-            {
-              "name": "disabled",
-              "description": "是否禁用 dropdown",
-              "value": {
-                "type": "boolean"
-              },
-              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-disabled"
-            },
-            {
-              "name": "trigger",
-              "description": "dropdown 的触发方式，支持传入多个值，用空格分隔。可选值为：\n\n* `click`：点击时触发\n* `hover`：鼠标悬浮触发\n* `focus`：聚焦时触发\n* `contextmenu`：鼠标右键点击、或触摸长按时触发\n* `manual`：使用了该值时，只能使用编程方式打开和关闭 dropdown，且不能再指定其他触发方式",
+              "name": "selects",
+              "description": "菜单项的可选中状态。默认为不可选中。可选值为：\n\n* `single`：最多只能选中一个\n* `multiple`：可以选中多个",
               "value": {
                 "type": [
-                  "'click'",
-                  "'hover'",
-                  "'focus'",
-                  "'contextmenu'",
-                  "'manual'",
-                  "string"
+                  "'single'",
+                  "'multiple'"
                 ]
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-trigger"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-selects"
             },
             {
-              "name": "placement",
-              "description": "dropdown 内容的位置。可选值为：\n\n* `auto`：自动判断位置\n* `top-start`：位于上方，且左对齐\n* `top`：位于上方，且居中对齐\n* `top-end`：位于上方，且右对齐\n* `bottom-start`：位于下方，且左对齐\n* `bottom`：位于下方，且居中对齐\n* `bottom-end`：位于下方，且右对齐\n* `left-start`：位于左侧，且顶部对齐\n* `left`：位于左侧，且居中对齐\n* `left-end`：位于左侧，且底部对齐\n* `right-start`：位于右侧，且顶部对齐\n* `right`：位于右侧，且居中对齐\n* `right-end`：位于右侧，且底部对齐",
+              "name": "value",
+              "description": "当前选中的 `<mdui-menu-item>` 的值\n\nNote:\n该属性的 HTML 属性始终为字符串，且仅在 `selects=\"single\"` 时可以通过 HTML 属性设置初始值；\n该属性的 JavaScript 属性值在 `selects=\"single\"` 时为字符串、在 `selects=\"multiple\"` 时为字符串数组。\n所以，在 `selects=\"multiple\"` 时，如果要修改该值，只能通过修改 JavaScript 属性值实现。",
               "value": {
                 "type": [
-                  "'auto'",
-                  "'top-start'",
-                  "'top'",
-                  "'top-end'",
-                  "'bottom-start'",
-                  "'bottom'",
-                  "'bottom-end'",
-                  "'left-start'",
-                  "'left'",
-                  "'left-end'",
-                  "'right-start'",
-                  "'right'",
-                  "'right-end'"
+                  "string",
+                  "string[]"
                 ]
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-placement"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-value"
             },
             {
-              "name": "stay-open-on-click",
-              "description": "在点击 [`<mdui-menu-item>`](https://www.mdui.org/docs/2/components/menu#menu-item-api) 元素后，是否仍保持 dropdown 为打开状态",
+              "name": "dense",
+              "description": "菜单项是否使用更紧凑的布局",
               "value": {
                 "type": "boolean"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-stay-open-on-click"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-dense"
             },
             {
-              "name": "open-delay",
-              "description": "通过 hover 触发 dropdown 打开时的延时，单位为毫秒",
+              "name": "submenu-trigger",
+              "description": "子菜单的触发方式，支持传入多个值，用空格分隔。可选值为：\n\n* `click`：点击菜单项时打开子菜单\n* `hover`：鼠标悬浮到菜单项上时打开子菜单\n* `focus`：聚焦到菜单项上时打开子菜单\n* `manual`：使用了该值时，只能使用编程方式打开和关闭子菜单，且不能再指定其他触发方式",
               "value": {
-                "type": "number"
+                "type": [
+                  "'click'",
+                  "'hover'",
+                  "'focus'",
+                  "'manual'",
+                  "string"
+                ]
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-open-delay"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenu-trigger"
             },
             {
-              "name": "close-delay",
-              "description": "通过 hover 触发 dropdown 关闭时的延时，单位为毫秒",
+              "name": "submenu-open-delay",
+              "description": "通过 hover 触发子菜单打开时的延时，单位为毫秒",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-close-delay"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenu-open-delay"
             },
             {
-              "name": "open-on-pointer",
-              "description": "是否在触发 dropdown 时的光标所在的位置打开 dropdown。通常用于在打开鼠标右键菜单时使用",
+              "name": "submenu-close-delay",
+              "description": "通过 hover 触发子菜单关闭时的延时，单位为毫秒",
               "value": {
-                "type": "boolean"
+                "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-open-on-pointer"
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenu-close-delay"
             }
           ],
           "priority": "highest",
-          "doc-url": "https://www.mdui.org/docs/2/components/dropdown",
+          "doc-url": "https://www.mdui.org/docs/2/components/menu",
           "slots": [
             {
               "name": "",
-              "description": "dropdown 的内容",
-              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#slot-"
-            },
-            {
-              "name": "trigger",
-              "description": "触发 dropdown 的元素，例如 [`<mdui-button>`](https://www.mdui.org/docs/2/components/button) 元素",
-              "doc-url": "https://www.mdui.org/docs/2/components/dropdown#slot-trigger"
+              "description": "子菜单项（`<mdui-menu-item>`）、分割线（[`<mdui-divider>`](https://www.mdui.org/docs/2/components/divider)）等元素",
+              "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-slot-"
             }
           ],
           "js": {
             "properties": [
               {
-                "name": "open",
-                "description": "dropdown 是否打开",
-                "value": {
-                  "type": "boolean"
-                },
-                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-open"
-              },
-              {
-                "name": "disabled",
-                "description": "是否禁用 dropdown",
-                "value": {
-                  "type": "boolean"
-                },
-                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-disabled"
-              },
-              {
-                "name": "trigger",
-                "description": "dropdown 的触发方式，支持传入多个值，用空格分隔。可选值为：\n\n* `click`：点击时触发\n* `hover`：鼠标悬浮触发\n* `focus`：聚焦时触发\n* `contextmenu`：鼠标右键点击、或触摸长按时触发\n* `manual`：使用了该值时，只能使用编程方式打开和关闭 dropdown，且不能再指定其他触发方式",
+                "name": "selects",
+                "description": "菜单项的可选中状态。默认为不可选中。可选值为：\n\n* `single`：最多只能选中一个\n* `multiple`：可以选中多个",
                 "value": {
                   "type": [
-                    "'click'",
-                    "'hover'",
-                    "'focus'",
-                    "'contextmenu'",
-                    "'manual'",
-                    "string"
+                    "'single'",
+                    "'multiple'"
                   ]
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-trigger"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-selects"
               },
               {
-                "name": "placement",
-                "description": "dropdown 内容的位置。可选值为：\n\n* `auto`：自动判断位置\n* `top-start`：位于上方，且左对齐\n* `top`：位于上方，且居中对齐\n* `top-end`：位于上方，且右对齐\n* `bottom-start`：位于下方，且左对齐\n* `bottom`：位于下方，且居中对齐\n* `bottom-end`：位于下方，且右对齐\n* `left-start`：位于左侧，且顶部对齐\n* `left`：位于左侧，且居中对齐\n* `left-end`：位于左侧，且底部对齐\n* `right-start`：位于右侧，且顶部对齐\n* `right`：位于右侧，且居中对齐\n* `right-end`：位于右侧，且底部对齐",
+                "name": "value",
+                "description": "当前选中的 `<mdui-menu-item>` 的值\n\nNote:\n该属性的 HTML 属性始终为字符串，且仅在 `selects=\"single\"` 时可以通过 HTML 属性设置初始值；\n该属性的 JavaScript 属性值在 `selects=\"single\"` 时为字符串、在 `selects=\"multiple\"` 时为字符串数组。\n所以，在 `selects=\"multiple\"` 时，如果要修改该值，只能通过修改 JavaScript 属性值实现。",
                 "value": {
                   "type": [
-                    "'auto'",
-                    "'top-start'",
-                    "'top'",
-                    "'top-end'",
-                    "'bottom-start'",
-                    "'bottom'",
-                    "'bottom-end'",
-                    "'left-start'",
-                    "'left'",
-                    "'left-end'",
-                    "'right-start'",
-                    "'right'",
-                    "'right-end'"
+                    "string",
+                    "string[]"
                   ]
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-placement"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-value"
               },
               {
-                "name": "stayOpenOnClick",
-                "description": "在点击 [`<mdui-menu-item>`](https://www.mdui.org/docs/2/components/menu#menu-item-api) 元素后，是否仍保持 dropdown 为打开状态",
+                "name": "dense",
+                "description": "菜单项是否使用更紧凑的布局",
                 "value": {
                   "type": "boolean"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-stayOpenOnClick"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-dense"
               },
               {
-                "name": "openDelay",
-                "description": "通过 hover 触发 dropdown 打开时的延时，单位为毫秒",
+                "name": "submenuTrigger",
+                "description": "子菜单的触发方式，支持传入多个值，用空格分隔。可选值为：\n\n* `click`：点击菜单项时打开子菜单\n* `hover`：鼠标悬浮到菜单项上时打开子菜单\n* `focus`：聚焦到菜单项上时打开子菜单\n* `manual`：使用了该值时，只能使用编程方式打开和关闭子菜单，且不能再指定其他触发方式",
                 "value": {
-                  "type": "number"
+                  "type": [
+                    "'click'",
+                    "'hover'",
+                    "'focus'",
+                    "'manual'",
+                    "string"
+                  ]
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-openDelay"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenuTrigger"
               },
               {
-                "name": "closeDelay",
-                "description": "通过 hover 触发 dropdown 关闭时的延时，单位为毫秒",
+                "name": "submenuOpenDelay",
+                "description": "通过 hover 触发子菜单打开时的延时，单位为毫秒",
                 "value": {
                   "type": "number"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-closeDelay"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenuOpenDelay"
               },
               {
-                "name": "openOnPointer",
-                "description": "是否在触发 dropdown 时的光标所在的位置打开 dropdown。通常用于在打开鼠标右键菜单时使用",
+                "name": "submenuCloseDelay",
+                "description": "通过 hover 触发子菜单关闭时的延时，单位为毫秒",
                 "value": {
-                  "type": "boolean"
+                  "type": "number"
                 },
-                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#attributes-openOnPointer"
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenuCloseDelay"
               }
             ],
             "events": [
               {
-                "name": "open",
-                "description": "dropdown 开始打开时，事件被触发。可以通过调用 `event.preventDefault()` 阻止 dropdown 打开",
-                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#event-open"
-              },
-              {
-                "name": "opened",
-                "description": "dropdown 打开动画完成时，事件被触发",
-                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#event-opened"
-              },
-              {
-                "name": "close",
-                "description": "dropdown 开始关闭时，事件被触发。可以通过调用 `event.preventDefault()` 阻止 dropdown 关闭",
-                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#event-close"
-              },
-              {
-                "name": "closed",
-                "description": "dropdown 关闭动画完成时，事件被触发",
-                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#event-closed"
+                "name": "change",
+                "description": "菜单项的选中状态变化时触发",
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-event-change"
               }
             ]
           },
           "css": {
             "properties": [
               {
-                "name": "--z-index",
-                "description": "组件的 CSS 的 `z-index` 值",
-                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#css-properties-z-index"
-              }
-            ],
-            "parts": [
-              {
-                "name": "trigger",
-                "description": "触发 dropdown 的元素的容器，即 `trigger` slot 的容器",
-                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#css-parts-trigger"
-              },
-              {
-                "name": "panel",
-                "description": "dropdown 内容的容器",
-                "doc-url": "https://www.mdui.org/docs/2/components/dropdown#css-parts-panel"
+                "name": "--shape-corner",
+                "description": "组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](https://www.mdui.org/docs/2/styles/design-tokens#shape-corner)",
+                "doc-url": "https://www.mdui.org/docs/2/components/menu#menu-css-properties-shape-corner"
               }
             ]
           }
@@ -5179,12 +5179,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/navigation-bar#navigation-bar-item-attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/navigation-bar#navigation-bar-item-attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/navigation-bar#navigation-bar-item-attributes-tabindex"
             }
           ],
           "priority": "highest",
@@ -5838,12 +5838,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/navigation-rail#navigation-rail-item-attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/navigation-rail#navigation-rail-item-attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/navigation-rail#navigation-rail-item-attributes-tabindex"
             }
           ],
           "priority": "highest",
@@ -6390,12 +6390,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/radio#radio-attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/radio#radio-attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/radio#radio-attributes-tabindex"
             }
           ],
           "priority": "highest",
@@ -6532,12 +6532,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/range-slider#attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/range-slider#attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/range-slider#attributes-tabindex"
             },
             {
               "name": "min",
@@ -7067,12 +7067,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/segmented-button#segmented-button-attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/segmented-button#segmented-button-attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/segmented-button#segmented-button-attributes-tabindex"
             },
             {
               "name": "disabled",
@@ -7654,12 +7654,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/select#attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/select#attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/select#attributes-tabindex"
             }
           ],
           "priority": "highest",
@@ -7991,12 +7991,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/slider#attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/slider#attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/slider#attributes-tabindex"
             },
             {
               "name": "min",
@@ -8584,12 +8584,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/switch#attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/switch#attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/switch#attributes-tabindex"
             }
           ],
           "priority": "highest",
@@ -8850,12 +8850,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/tabs#tab-attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/tabs#tab-attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/tabs#tab-attributes-tabindex"
             }
           ],
           "priority": "highest",
@@ -9474,12 +9474,12 @@
               "doc-url": "https://www.mdui.org/docs/2/components/text-field#attributes-autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabindex",
               "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
               "value": {
                 "type": "number"
               },
-              "doc-url": "https://www.mdui.org/docs/2/components/text-field#attributes-tabIndex"
+              "doc-url": "https://www.mdui.org/docs/2/components/text-field#attributes-tabindex"
             }
           ],
           "priority": "highest",