mdui 2.0.0 → 2.0.2

package/html-data.zh-cn.json

@@ -398,12 +398,12 @@
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/button#attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/button#attributes-tabIndex"
             }
           ]
         },
@@ -784,12 +784,12 @@
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/button-icon#attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/button-icon#attributes-tabIndex"
             }
           ]
         },
@@ -971,6 +971,202 @@
         }
       ]
     },
+    {
+      "name": "mdui-card",
+      "description": "卡片组件\n\n```html\n<mdui-card>card content</mdui-card>\n```",
+      "attributes": [
+        {
+          "name": "variant",
+          "description": "卡片形状。可选值为：\n\n* `elevated`：具有阴影，与背景的分离度比 `filled` 更高，但小于 `outlined`\n* `filled`：与背景的分离度最小\n* `outlined`：具有边框，与背景的分离度最大",
+          "values": [
+            {
+              "name": "elevated",
+              "description": "具有阴影，与背景的分离度比 `filled` 更高，但小于 `outlined`"
+            },
+            {
+              "name": "filled",
+              "description": "与背景的分离度最小"
+            },
+            {
+              "name": "outlined",
+              "description": "具有边框，与背景的分离度最大"
+            }
+          ],
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/card#attributes-variant"
+            }
+          ]
+        },
+        {
+          "name": "clickable",
+          "description": "是否可点击。为 `true` 时，会添加鼠标悬浮效果、及点击涟漪效果",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/card#attributes-clickable"
+            }
+          ]
+        },
+        {
+          "name": "disabled",
+          "description": "是否禁用",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/card#attributes-disabled"
+            }
+          ]
+        },
+        {
+          "name": "href",
+          "description": "链接指向的页面的 URL。\n\n若指定了该属性，则组件内部会渲染为 `<a>` 元素，并可以使用链接相关的属性",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/card#attributes-href"
+            }
+          ]
+        },
+        {
+          "name": "download",
+          "description": "被下载的超链接目标。\n\n**Note**：仅在指定了 `href` 属性时可用",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/card#attributes-download"
+            }
+          ]
+        },
+        {
+          "name": "target",
+          "description": "在何处打开链接。可选值为：\n\n* `_blank`：在新窗口中打开链接\n* `_parent`：在父框架中打开链接\n* `_self`：默认。在相同的框架中打开链接\n* `_top`：在整个窗口中打开链接\n\n**Note**：仅在指定了 `href` 属性时可用",
+          "values": [
+            {
+              "name": "_blank",
+              "description": "在新窗口中打开链接"
+            },
+            {
+              "name": "_parent",
+              "description": "在父框架中打开链接"
+            },
+            {
+              "name": "_self",
+              "description": "默认。在相同的框架中打开链接"
+            },
+            {
+              "name": "_top",
+              "description": "在整个窗口中打开链接"
+            }
+          ],
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/card#attributes-target"
+            }
+          ]
+        },
+        {
+          "name": "rel",
+          "description": "当前文档与被链接文档之间的关系。可选值为：\n\n* `alternate`：当前文档的替代描述\n* `author`：当前文档或文章的作者\n* `bookmark`：到最近祖先章节的永久链接\n* `external`：引用的文档与当前的文档不属于同一个站点\n* `help`：链接到上下文相关的帮助\n* `license`：表示当前文档的主要内容由被引用文件描述的版权许可所涵盖\n* `me`：表示当前文档代表拥有链接内容的人\n* `next`：表示当前文档是一个系列的一部分，被引用的文档是该系列中的下一个文档\n* `nofollow`：表示当前文档的原作者或出版商不认可被引用的文件\n* `noreferrer`：不会包含 `Referer` 标头。和 `noopener` 效果类似\n* `opener`：如果超链接会创建一个非辅助浏览上下文的顶级浏览上下文（即以 `_blank` 作为 `target` 属性值），则创建一个辅助浏览上下文\n* `prev`：表示当前文档是系列的一部分，被引用的文档是该系列中的上一个文档\n* `search`：给出一个资源的链接，可以用来搜索当前文件及其相关页面\n* `tag`：给出一个适用于当前文档的标签（由给定地址识别）\n\n**Note**：仅在指定了 `href` 属性时可用",
+          "values": [
+            {
+              "name": "alternate",
+              "description": "当前文档的替代描述"
+            },
+            {
+              "name": "author",
+              "description": "当前文档或文章的作者"
+            },
+            {
+              "name": "bookmark",
+              "description": "到最近祖先章节的永久链接"
+            },
+            {
+              "name": "external",
+              "description": "引用的文档与当前的文档不属于同一个站点"
+            },
+            {
+              "name": "help",
+              "description": "链接到上下文相关的帮助"
+            },
+            {
+              "name": "license",
+              "description": "表示当前文档的主要内容由被引用文件描述的版权许可所涵盖"
+            },
+            {
+              "name": "me",
+              "description": "表示当前文档代表拥有链接内容的人"
+            },
+            {
+              "name": "next",
+              "description": "表示当前文档是一个系列的一部分，被引用的文档是该系列中的下一个文档"
+            },
+            {
+              "name": "nofollow",
+              "description": "表示当前文档的原作者或出版商不认可被引用的文件"
+            },
+            {
+              "name": "noreferrer",
+              "description": "不会包含 `Referer` 标头。和 `noopener` 效果类似"
+            },
+            {
+              "name": "opener",
+              "description": "如果超链接会创建一个非辅助浏览上下文的顶级浏览上下文（即以 `_blank` 作为 `target` 属性值），则创建一个辅助浏览上下文"
+            },
+            {
+              "name": "prev",
+              "description": "表示当前文档是系列的一部分，被引用的文档是该系列中的上一个文档"
+            },
+            {
+              "name": "search",
+              "description": "给出一个资源的链接，可以用来搜索当前文件及其相关页面"
+            },
+            {
+              "name": "tag",
+              "description": "给出一个适用于当前文档的标签（由给定地址识别）"
+            }
+          ],
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/card#attributes-rel"
+            }
+          ]
+        },
+        {
+          "name": "autofocus",
+          "description": "是否在页面加载完成后自动获得焦点",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/card#attributes-autofocus"
+            }
+          ]
+        },
+        {
+          "name": "tabIndex",
+          "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/card#attributes-tabIndex"
+            }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "开发文档",
+          "url": "https://www.mdui.org/docs/2/components/card"
+        },
+        {
+          "name": "Github",
+          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/card/index.ts"
+        }
+      ]
+    },
     {
       "name": "mdui-checkbox",
       "description": "复选框组件\n\n```html\n<mdui-checkbox>Checkbox</mdui-checkbox>\n```",
@@ -1086,12 +1282,12 @@
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/checkbox#attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/checkbox#attributes-tabIndex"
             }
           ]
         }
@@ -1346,12 +1542,12 @@
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/chip#attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/chip#attributes-tabIndex"
             }
           ]
         },
@@ -1534,228 +1730,68 @@
       ]
     },
     {
-      "name": "mdui-card",
-      "description": "卡片组件\n\n```html\n<mdui-card>card content</mdui-card>\n```",
+      "name": "mdui-circular-progress",
+      "description": "圆形进度指示器组件\n\n```html\n<mdui-circular-progress></mdui-circular-progress>\n```",
       "attributes": [
         {
-          "name": "variant",
-          "description": "卡片形状。可选值为：\n\n* `elevated`：具有阴影，与背景的分离度比 `filled` 更高，但小于 `outlined`\n* `filled`：与背景的分离度最小\n* `outlined`：具有边框，与背景的分离度最大",
-          "values": [
-            {
-              "name": "elevated",
-              "description": "具有阴影，与背景的分离度比 `filled` 更高，但小于 `outlined`"
-            },
-            {
-              "name": "filled",
-              "description": "与背景的分离度最小"
-            },
-            {
-              "name": "outlined",
-              "description": "具有边框，与背景的分离度最大"
-            }
-          ],
+          "name": "max",
+          "description": "进度指示器的最大值，默认为 1",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/card#attributes-variant"
+              "url": "https://www.mdui.org/docs/2/components/circular-progress#attributes-max"
             }
           ]
         },
         {
-          "name": "clickable",
-          "description": "是否可点击。为 `true` 时，会添加鼠标悬浮效果、及点击涟漪效果",
+          "name": "value",
+          "description": "进度指示器的当前值。若未指定该值，则为不确定状态",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/card#attributes-clickable"
+              "url": "https://www.mdui.org/docs/2/components/circular-progress#attributes-value"
             }
           ]
+        }
+      ],
+      "references": [
+        {
+          "name": "开发文档",
+          "url": "https://www.mdui.org/docs/2/components/circular-progress"
         },
         {
-          "name": "disabled",
-          "description": "是否禁用",
+          "name": "Github",
+          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/circular-progress/index.ts"
+        }
+      ]
+    },
+    {
+      "name": "mdui-collapse-item",
+      "description": "折叠面板项组件。需与 `<mdui-collapse>` 组件配合使用\n\n```html\n<mdui-collapse>\n  <mdui-collapse-item header=\"header-1\">content-1</mdui-collapse-item>\n  <mdui-collapse-item header=\"header-2\">content-2</mdui-collapse-item>\n</mdui-collapse>\n```",
+      "attributes": [
+        {
+          "name": "value",
+          "description": "该折叠面板项的值",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/card#attributes-disabled"
+              "url": "https://www.mdui.org/docs/2/components/collapse#collapse-item-attributes-value"
             }
           ]
         },
         {
-          "name": "href",
-          "description": "链接指向的页面的 URL。\n\n若指定了该属性，则组件内部会渲染为 `<a>` 元素，并可以使用链接相关的属性",
+          "name": "header",
+          "description": "该折叠面板项的头部文本",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/card#attributes-href"
+              "url": "https://www.mdui.org/docs/2/components/collapse#collapse-item-attributes-header"
             }
           ]
         },
         {
-          "name": "download",
-          "description": "被下载的超链接目标。\n\n**Note**：仅在指定了 `href` 属性时可用",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/card#attributes-download"
-            }
-          ]
-        },
-        {
-          "name": "target",
-          "description": "在何处打开链接。可选值为：\n\n* `_blank`：在新窗口中打开链接\n* `_parent`：在父框架中打开链接\n* `_self`：默认。在相同的框架中打开链接\n* `_top`：在整个窗口中打开链接\n\n**Note**：仅在指定了 `href` 属性时可用",
-          "values": [
-            {
-              "name": "_blank",
-              "description": "在新窗口中打开链接"
-            },
-            {
-              "name": "_parent",
-              "description": "在父框架中打开链接"
-            },
-            {
-              "name": "_self",
-              "description": "默认。在相同的框架中打开链接"
-            },
-            {
-              "name": "_top",
-              "description": "在整个窗口中打开链接"
-            }
-          ],
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/card#attributes-target"
-            }
-          ]
-        },
-        {
-          "name": "rel",
-          "description": "当前文档与被链接文档之间的关系。可选值为：\n\n* `alternate`：当前文档的替代描述\n* `author`：当前文档或文章的作者\n* `bookmark`：到最近祖先章节的永久链接\n* `external`：引用的文档与当前的文档不属于同一个站点\n* `help`：链接到上下文相关的帮助\n* `license`：表示当前文档的主要内容由被引用文件描述的版权许可所涵盖\n* `me`：表示当前文档代表拥有链接内容的人\n* `next`：表示当前文档是一个系列的一部分，被引用的文档是该系列中的下一个文档\n* `nofollow`：表示当前文档的原作者或出版商不认可被引用的文件\n* `noreferrer`：不会包含 `Referer` 标头。和 `noopener` 效果类似\n* `opener`：如果超链接会创建一个非辅助浏览上下文的顶级浏览上下文（即以 `_blank` 作为 `target` 属性值），则创建一个辅助浏览上下文\n* `prev`：表示当前文档是系列的一部分，被引用的文档是该系列中的上一个文档\n* `search`：给出一个资源的链接，可以用来搜索当前文件及其相关页面\n* `tag`：给出一个适用于当前文档的标签（由给定地址识别）\n\n**Note**：仅在指定了 `href` 属性时可用",
-          "values": [
-            {
-              "name": "alternate",
-              "description": "当前文档的替代描述"
-            },
-            {
-              "name": "author",
-              "description": "当前文档或文章的作者"
-            },
-            {
-              "name": "bookmark",
-              "description": "到最近祖先章节的永久链接"
-            },
-            {
-              "name": "external",
-              "description": "引用的文档与当前的文档不属于同一个站点"
-            },
-            {
-              "name": "help",
-              "description": "链接到上下文相关的帮助"
-            },
-            {
-              "name": "license",
-              "description": "表示当前文档的主要内容由被引用文件描述的版权许可所涵盖"
-            },
-            {
-              "name": "me",
-              "description": "表示当前文档代表拥有链接内容的人"
-            },
-            {
-              "name": "next",
-              "description": "表示当前文档是一个系列的一部分，被引用的文档是该系列中的下一个文档"
-            },
-            {
-              "name": "nofollow",
-              "description": "表示当前文档的原作者或出版商不认可被引用的文件"
-            },
-            {
-              "name": "noreferrer",
-              "description": "不会包含 `Referer` 标头。和 `noopener` 效果类似"
-            },
-            {
-              "name": "opener",
-              "description": "如果超链接会创建一个非辅助浏览上下文的顶级浏览上下文（即以 `_blank` 作为 `target` 属性值），则创建一个辅助浏览上下文"
-            },
-            {
-              "name": "prev",
-              "description": "表示当前文档是系列的一部分，被引用的文档是该系列中的上一个文档"
-            },
-            {
-              "name": "search",
-              "description": "给出一个资源的链接，可以用来搜索当前文件及其相关页面"
-            },
-            {
-              "name": "tag",
-              "description": "给出一个适用于当前文档的标签（由给定地址识别）"
-            }
-          ],
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/card#attributes-rel"
-            }
-          ]
-        },
-        {
-          "name": "autofocus",
-          "description": "是否在页面加载完成后自动获得焦点",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/card#attributes-autofocus"
-            }
-          ]
-        },
-        {
-          "name": "tabindex",
-          "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/card#attributes-tabindex"
-            }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "开发文档",
-          "url": "https://www.mdui.org/docs/2/components/card"
-        },
-        {
-          "name": "Github",
-          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/card/index.ts"
-        }
-      ]
-    },
-    {
-      "name": "mdui-collapse-item",
-      "description": "折叠面板项组件。需与 `<mdui-collapse>` 组件配合使用\n\n```html\n<mdui-collapse>\n  <mdui-collapse-item header=\"header-1\">content-1</mdui-collapse-item>\n  <mdui-collapse-item header=\"header-2\">content-2</mdui-collapse-item>\n</mdui-collapse>\n```",
-      "attributes": [
-        {
-          "name": "value",
-          "description": "该折叠面板项的值",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/collapse#collapse-item-attributes-value"
-            }
-          ]
-        },
-        {
-          "name": "header",
-          "description": "该折叠面板项的头部文本",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/collapse#collapse-item-attributes-header"
-            }
-          ]
-        },
-        {
-          "name": "disabled",
-          "description": "是否禁用该折叠面板项",
+          "name": "disabled",
+          "description": "是否禁用该折叠面板项",
           "references": [
             {
               "name": "开发文档",
@@ -1831,42 +1867,6 @@
         }
       ]
     },
-    {
-      "name": "mdui-circular-progress",
-      "description": "圆形进度指示器组件\n\n```html\n<mdui-circular-progress></mdui-circular-progress>\n```",
-      "attributes": [
-        {
-          "name": "max",
-          "description": "进度指示器的最大值，默认为 1",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/circular-progress#attributes-max"
-            }
-          ]
-        },
-        {
-          "name": "value",
-          "description": "进度指示器的当前值。若未指定该值，则为不确定状态",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/circular-progress#attributes-value"
-            }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "开发文档",
-          "url": "https://www.mdui.org/docs/2/components/circular-progress"
-        },
-        {
-          "name": "Github",
-          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/circular-progress/index.ts"
-        }
-      ]
-    },
     {
       "name": "mdui-dialog",
       "description": "对话框组件\n\n```html\n<mdui-dialog>content</mdui-dialog>\n```",
@@ -2010,266 +2010,58 @@
       ]
     },
     {
-      "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-fab",
+      "description": "浮动操作按钮组件\n\n```html\n<mdui-fab icon=\"edit\"></mdui-fab>\n```",
       "attributes": [
         {
-          "name": "open",
-          "description": "dropdown 是否打开",
-          "references": [
+          "name": "variant",
+          "description": "FAB 形状，此组件的不同形状之间只有颜色不一样。可选值为：\n\n* `primary`：使用 Primary container 背景色\n* `surface`：使用 Surface container high 背景色\n* `secondary`：使用 Secondary container 背景色\n* `tertiary`：使用 Tertiary container 背景色",
+          "values": [
             {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/dropdown#attributes-open"
+              "name": "primary",
+              "description": "使用 Primary container 背景色"
+            },
+            {
+              "name": "surface",
+              "description": "使用 Surface container high 背景色"
+            },
+            {
+              "name": "secondary",
+              "description": "使用 Secondary container 背景色"
+            },
+            {
+              "name": "tertiary",
+              "description": "使用 Tertiary container 背景色"
             }
-          ]
-        },
-        {
-          "name": "disabled",
-          "description": "是否禁用 dropdown",
+          ],
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/dropdown#attributes-disabled"
+              "url": "https://www.mdui.org/docs/2/components/fab#attributes-variant"
             }
           ]
         },
         {
-          "name": "trigger",
-          "description": "dropdown 的触发方式，支持传入多个值，用空格分隔。可选值为：\n\n* `click`：点击时触发\n* `hover`：鼠标悬浮触发\n* `focus`：聚焦时触发\n* `contextmenu`：鼠标右键点击、或触摸长按时触发\n* `manual`：使用了该值时，只能使用编程方式打开和关闭 dropdown，且不能再指定其他触发方式",
+          "name": "size",
+          "description": "FAB 大小。可选值为：\n* `normal`：普通大小 FAB\n* `small`：小型 FAB\n* `large`：大型 FAB",
           "values": [
             {
-              "name": "click",
-              "description": "点击时触发"
-            },
-            {
-              "name": "hover",
-              "description": "鼠标悬浮触发"
-            },
-            {
-              "name": "focus",
-              "description": "聚焦时触发"
+              "name": "normal",
+              "description": "普通大小 FAB"
             },
             {
-              "name": "contextmenu",
-              "description": "鼠标右键点击、或触摸长按时触发"
+              "name": "small",
+              "description": "小型 FAB"
             },
             {
-              "name": "manual",
-              "description": "使用了该值时，只能使用编程方式打开和关闭 dropdown，且不能再指定其他触发方式"
+              "name": "large",
+              "description": "大型 FAB"
             }
           ],
           "references": [
             {
               "name": "开发文档",
-              "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`：位于右侧，且底部对齐",
-          "values": [
-            {
-              "name": "auto",
-              "description": "自动判断位置"
-            },
-            {
-              "name": "top-start",
-              "description": "位于上方，且左对齐"
-            },
-            {
-              "name": "top",
-              "description": "位于上方，且居中对齐"
-            },
-            {
-              "name": "top-end",
-              "description": "位于上方，且右对齐"
-            },
-            {
-              "name": "bottom-start",
-              "description": "位于下方，且左对齐"
-            },
-            {
-              "name": "bottom",
-              "description": "位于下方，且居中对齐"
-            },
-            {
-              "name": "bottom-end",
-              "description": "位于下方，且右对齐"
-            },
-            {
-              "name": "left-start",
-              "description": "位于左侧，且顶部对齐"
-            },
-            {
-              "name": "left",
-              "description": "位于左侧，且居中对齐"
-            },
-            {
-              "name": "left-end",
-              "description": "位于左侧，且底部对齐"
-            },
-            {
-              "name": "right-start",
-              "description": "位于右侧，且顶部对齐"
-            },
-            {
-              "name": "right",
-              "description": "位于右侧，且居中对齐"
-            },
-            {
-              "name": "right-end",
-              "description": "位于右侧，且底部对齐"
-            }
-          ],
-          "references": [
-            {
-              "name": "开发文档",
-              "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 为打开状态",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/dropdown#attributes-stay-open-on-click"
-            }
-          ]
-        },
-        {
-          "name": "open-delay",
-          "description": "通过 hover 触发 dropdown 打开时的延时，单位为毫秒",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/dropdown#attributes-open-delay"
-            }
-          ]
-        },
-        {
-          "name": "close-delay",
-          "description": "通过 hover 触发 dropdown 关闭时的延时，单位为毫秒",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/dropdown#attributes-close-delay"
-            }
-          ]
-        },
-        {
-          "name": "open-on-pointer",
-          "description": "是否在触发 dropdown 时的光标所在的位置打开 dropdown。通常用于在打开鼠标右键菜单时使用",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/dropdown#attributes-open-on-pointer"
-            }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "开发文档",
-          "url": "https://www.mdui.org/docs/2/components/dropdown"
-        },
-        {
-          "name": "Github",
-          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/dropdown/index.ts"
-        }
-      ]
-    },
-    {
-      "name": "mdui-icon",
-      "description": "图标组件\n\n```html\n<mdui-icon name=\"search\"></mdui-icon>\n```",
-      "attributes": [
-        {
-          "name": "name",
-          "description": "Material Icons 图标名",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/icon#attributes-name"
-            }
-          ]
-        },
-        {
-          "name": "src",
-          "description": "svg 图标的路径",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/icon#attributes-src"
-            }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "开发文档",
-          "url": "https://www.mdui.org/docs/2/components/icon"
-        },
-        {
-          "name": "Github",
-          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/icon/index.ts"
-        }
-      ]
-    },
-    {
-      "name": "mdui-fab",
-      "description": "浮动操作按钮组件\n\n```html\n<mdui-fab icon=\"edit\"></mdui-fab>\n```",
-      "attributes": [
-        {
-          "name": "variant",
-          "description": "FAB 形状，此组件的不同形状之间只有颜色不一样。可选值为：\n\n* `primary`：使用 Primary container 背景色\n* `surface`：使用 Surface container high 背景色\n* `secondary`：使用 Secondary container 背景色\n* `tertiary`：使用 Tertiary container 背景色",
-          "values": [
-            {
-              "name": "primary",
-              "description": "使用 Primary container 背景色"
-            },
-            {
-              "name": "surface",
-              "description": "使用 Surface container high 背景色"
-            },
-            {
-              "name": "secondary",
-              "description": "使用 Secondary container 背景色"
-            },
-            {
-              "name": "tertiary",
-              "description": "使用 Tertiary container 背景色"
-            }
-          ],
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/fab#attributes-variant"
-            }
-          ]
-        },
-        {
-          "name": "size",
-          "description": "FAB 大小。可选值为：\n* `normal`：普通大小 FAB\n* `small`：小型 FAB\n* `large`：大型 FAB",
-          "values": [
-            {
-              "name": "normal",
-              "description": "普通大小 FAB"
-            },
-            {
-              "name": "small",
-              "description": "小型 FAB"
-            },
-            {
-              "name": "large",
-              "description": "大型 FAB"
-            }
-          ],
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/fab#attributes-size"
+              "url": "https://www.mdui.org/docs/2/components/fab#attributes-size"
             }
           ]
         },
@@ -2420,12 +2212,12 @@
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/fab#attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/fab#attributes-tabIndex"
             }
           ]
         },
@@ -2607,6 +2399,42 @@
         }
       ]
     },
+    {
+      "name": "mdui-icon",
+      "description": "图标组件\n\n```html\n<mdui-icon name=\"search\"></mdui-icon>\n```",
+      "attributes": [
+        {
+          "name": "name",
+          "description": "Material Icons 图标名",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/icon#attributes-name"
+            }
+          ]
+        },
+        {
+          "name": "src",
+          "description": "svg 图标的路径",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/icon#attributes-src"
+            }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "开发文档",
+          "url": "https://www.mdui.org/docs/2/components/icon"
+        },
+        {
+          "name": "Github",
+          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/icon/index.ts"
+        }
+      ]
+    },
     {
       "name": "mdui-layout-item",
       "description": "布局项组件\n\n```html\n<mdui-layout>\n  <mdui-layout-item></mdui-layout-item>\n  <mdui-layout-item></mdui-layout-item>\n  <mdui-layout-main></mdui-layout-main>\n</mdui-layout>\n```",
@@ -2702,117 +2530,36 @@
       ]
     },
     {
-      "name": "mdui-linear-progress",
-      "description": "线性进度指示器组件\n\n```html\n<mdui-linear-progress></mdui-linear-progress>\n```",
+      "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": "max",
-          "description": "进度指示器的最大值，默认为 1",
+          "name": "value",
+          "description": "该菜单项的值",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/linear-progress#attributes-max"
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-value"
             }
           ]
         },
         {
-          "name": "value",
-          "description": "进度指示器的当前值。若未指定该值，则为不确定状态",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/linear-progress#attributes-value"
-            }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "开发文档",
-          "url": "https://www.mdui.org/docs/2/components/linear-progress"
-        },
-        {
-          "name": "Github",
-          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/linear-progress/index.ts"
-        }
-      ]
-    },
-    {
-      "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 设置",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-headline"
-            }
-          ]
-        },
-        {
-          "name": "headline-line",
-          "description": "主文本行数，超过行数限制后会截断显示。默认为没有行数限制。可选值为：\n\n* `1`：显示单行文本，超出后截断显示\n* `2`：显示两行文本，超出后截断显示\n* `3`：显示三行文本，超出后截断显示",
-          "values": [
-            {
-              "name": "1",
-              "description": "显示单行文本，超出后截断显示"
-            },
-            {
-              "name": "2",
-              "description": "显示两行文本，超出后截断显示"
-            },
-            {
-              "name": "3",
-              "description": "显示三行文本，超出后截断显示"
-            }
-          ],
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-headline-line"
-            }
-          ]
-        },
-        {
-          "name": "description",
-          "description": "副文本。也可以通过 `slot=\"description\"` 设置",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-description"
-            }
-          ]
-        },
-        {
-          "name": "description-line",
-          "description": "副文本行数，超过行数限制后会截断显示。默认为没有行数限制。可选值为：\n\n* `1`：显示单行文本，超出后截断显示\n* `2`：显示两行文本，超出后截断显示\n* `3`：显示三行文本，超出后截断显示",
-          "values": [
-            {
-              "name": "1"
-            },
-            {
-              "name": "2"
-            },
-            {
-              "name": "3"
-            }
-          ],
+          "name": "disabled",
+          "description": "是否禁用该菜单项",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-description-line"
+              "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如果需要在左侧留出一个图标的位置，可以传入空字符串进行占位",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-icon"
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-icon"
             }
           ]
         },
@@ -2822,71 +2569,37 @@
           "references": [
             {
               "name": "开发文档",
-              "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) 等都将禁用",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-disabled"
-            }
-          ]
-        },
-        {
-          "name": "active",
-          "description": "是否激活该列表项",
-          "references": [
-            {
-              "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-active"
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-end-icon"
             }
           ]
         },
         {
-          "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": "end-text",
+          "description": "右侧的文本。也可以通过 `slot=\"end-text\"` 设置",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-nonclickable"
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-end-text"
             }
           ]
         },
         {
-          "name": "rounded",
-          "description": "使用圆角形状的列表项",
+          "name": "selected-icon",
+          "description": "选中状态的 Material Icons 图标名。也可以通过 `slot=\"selected-icon\"` 设置",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-rounded"
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-selected-icon"
             }
           ]
         },
         {
-          "name": "alignment",
-          "description": "列表项的垂直对齐方式。可选值为：\n\n* `start`：顶部对齐\n* `center`：居中对齐\n* `end`：底部对齐",
-          "values": [
-            {
-              "name": "start",
-              "description": "顶部对齐"
-            },
-            {
-              "name": "center",
-              "description": "居中对齐"
-            },
-            {
-              "name": "end",
-              "description": "底部对齐"
-            }
-          ],
+          "name": "submenu-open",
+          "description": "是否打开子菜单",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-alignment"
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-submenu-open"
             }
           ]
         },
@@ -2896,7 +2609,7 @@
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-href"
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-href"
             }
           ]
         },
@@ -2906,7 +2619,7 @@
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-download"
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-download"
             }
           ]
         },
@@ -2934,7 +2647,7 @@
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-target"
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-target"
             }
           ]
         },
@@ -3002,7 +2715,7 @@
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-rel"
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-rel"
             }
           ]
         },
@@ -3012,17 +2725,17 @@
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-autofocus"
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-autofocus"
             }
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-tabIndex"
             }
           ]
         }
@@ -3030,113 +2743,304 @@
       "references": [
         {
           "name": "开发文档",
-          "url": "https://www.mdui.org/docs/2/components/list"
+          "url": "https://www.mdui.org/docs/2/components/menu"
         },
         {
           "name": "Github",
-          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/list/list-item.ts"
+          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/menu/menu-item.ts"
         }
       ]
     },
     {
-      "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```",
+      "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": "selects",
+          "description": "菜单项的可选中状态。默认为不可选中。可选值为：\n\n* `single`：最多只能选中一个\n* `multiple`：可以选中多个",
+          "values": [
+            {
+              "name": "single",
+              "description": "最多只能选中一个"
+            },
+            {
+              "name": "multiple",
+              "description": "可以选中多个"
+            }
+          ],
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-selects"
+            }
+          ]
+        },
+        {
+          "name": "value",
+          "description": "当前选中的 `<mdui-menu-item>` 的值\n\nNote:\n该属性的 HTML 属性始终为字符串，且仅在 `selects=\"single\"` 时可以通过 HTML 属性设置初始值；\n该属性的 JavaScript 属性值在 `selects=\"single\"` 时为字符串、在 `selects=\"multiple\"` 时为字符串数组。\n所以，在 `selects=\"multiple\"` 时，如果要修改该值，只能通过修改 JavaScript 属性值实现。",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-value"
+            }
+          ]
+        },
+        {
+          "name": "dense",
+          "description": "菜单项是否使用更紧凑的布局",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-dense"
+            }
+          ]
+        },
+        {
+          "name": "submenu-trigger",
+          "description": "子菜单的触发方式，支持传入多个值，用空格分隔。可选值为：\n\n* `click`：点击菜单项时打开子菜单\n* `hover`：鼠标悬浮到菜单项上时打开子菜单\n* `focus`：聚焦到菜单项上时打开子菜单\n* `manual`：使用了该值时，只能使用编程方式打开和关闭子菜单，且不能再指定其他触发方式",
+          "values": [
+            {
+              "name": "click",
+              "description": "点击菜单项时打开子菜单"
+            },
+            {
+              "name": "hover",
+              "description": "鼠标悬浮到菜单项上时打开子菜单"
+            },
+            {
+              "name": "focus",
+              "description": "聚焦到菜单项上时打开子菜单"
+            },
+            {
+              "name": "manual",
+              "description": "使用了该值时，只能使用编程方式打开和关闭子菜单，且不能再指定其他触发方式"
+            }
+          ],
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenu-trigger"
+            }
+          ]
+        },
+        {
+          "name": "submenu-open-delay",
+          "description": "通过 hover 触发子菜单打开时的延时，单位为毫秒",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenu-open-delay"
+            }
+          ]
+        },
+        {
+          "name": "submenu-close-delay",
+          "description": "通过 hover 触发子菜单关闭时的延时，单位为毫秒",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenu-close-delay"
+            }
+          ]
+        }
+      ],
       "references": [
         {
           "name": "开发文档",
-          "url": "https://www.mdui.org/docs/2/components/list"
+          "url": "https://www.mdui.org/docs/2/components/menu"
         },
         {
           "name": "Github",
-          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/list/list-subheader.ts"
+          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/menu/menu.ts"
         }
       ]
     },
     {
-      "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```",
+      "name": "mdui-linear-progress",
+      "description": "线性进度指示器组件\n\n```html\n<mdui-linear-progress></mdui-linear-progress>\n```",
+      "attributes": [
+        {
+          "name": "max",
+          "description": "进度指示器的最大值，默认为 1",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/linear-progress#attributes-max"
+            }
+          ]
+        },
+        {
+          "name": "value",
+          "description": "进度指示器的当前值。若未指定该值，则为不确定状态",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/linear-progress#attributes-value"
+            }
+          ]
+        }
+      ],
       "references": [
         {
           "name": "开发文档",
-          "url": "https://www.mdui.org/docs/2/components/list"
+          "url": "https://www.mdui.org/docs/2/components/linear-progress"
+        },
+        {
+          "name": "Github",
+          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/linear-progress/index.ts"
+        }
+      ]
+    },
+    {
+      "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 设置",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-headline"
+            }
+          ]
+        },
+        {
+          "name": "headline-line",
+          "description": "主文本行数，超过行数限制后会截断显示。默认为没有行数限制。可选值为：\n\n* `1`：显示单行文本，超出后截断显示\n* `2`：显示两行文本，超出后截断显示\n* `3`：显示三行文本，超出后截断显示",
+          "values": [
+            {
+              "name": "1",
+              "description": "显示单行文本，超出后截断显示"
+            },
+            {
+              "name": "2",
+              "description": "显示两行文本，超出后截断显示"
+            },
+            {
+              "name": "3",
+              "description": "显示三行文本，超出后截断显示"
+            }
+          ],
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-headline-line"
+            }
+          ]
+        },
+        {
+          "name": "description",
+          "description": "副文本。也可以通过 `slot=\"description\"` 设置",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-description"
+            }
+          ]
+        },
+        {
+          "name": "description-line",
+          "description": "副文本行数，超过行数限制后会截断显示。默认为没有行数限制。可选值为：\n\n* `1`：显示单行文本，超出后截断显示\n* `2`：显示两行文本，超出后截断显示\n* `3`：显示三行文本，超出后截断显示",
+          "values": [
+            {
+              "name": "1"
+            },
+            {
+              "name": "2"
+            },
+            {
+              "name": "3"
+            }
+          ],
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-description-line"
+            }
+          ]
         },
         {
-          "name": "Github",
-          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/list/list.ts"
-        }
-      ]
-    },
-    {
-      "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": "value",
-          "description": "该菜单项的值",
+          "name": "icon",
+          "description": "左侧的 Material Icons 图标名。也可以通过 `slot=\"icon\"` 设置",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-value"
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-icon"
             }
           ]
         },
         {
-          "name": "disabled",
-          "description": "是否禁用该菜单项",
+          "name": "end-icon",
+          "description": "右侧的 Material Icons 图标名。也可以通过 `slot=\"end-icon\"` 设置",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-disabled"
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-end-icon"
             }
           ]
         },
         {
-          "name": "icon",
-          "description": "左侧的 Material Icons 图标名。也可以通过 `slot=\"icon\"` 设置\n\n如果需要在左侧留出一个图标的位置，可以传入空字符串进行占位",
+          "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) 等都将禁用",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-icon"
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-disabled"
             }
           ]
         },
         {
-          "name": "end-icon",
-          "description": "右侧的 Material Icons 图标名。也可以通过 `slot=\"end-icon\"` 设置",
+          "name": "active",
+          "description": "是否激活该列表项",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-end-icon"
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-active"
             }
           ]
         },
         {
-          "name": "end-text",
-          "description": "右侧的文本。也可以通过 `slot=\"end-text\"` 设置",
+          "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) 等仍可进行交互",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-end-text"
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-nonclickable"
             }
           ]
         },
         {
-          "name": "selected-icon",
-          "description": "选中状态的 Material Icons 图标名。也可以通过 `slot=\"selected-icon\"` 设置",
+          "name": "rounded",
+          "description": "使用圆角形状的列表项",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-selected-icon"
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-rounded"
             }
           ]
         },
         {
-          "name": "submenu-open",
-          "description": "是否打开子菜单",
+          "name": "alignment",
+          "description": "列表项的垂直对齐方式。可选值为：\n\n* `start`：顶部对齐\n* `center`：居中对齐\n* `end`：底部对齐",
+          "values": [
+            {
+              "name": "start",
+              "description": "顶部对齐"
+            },
+            {
+              "name": "center",
+              "description": "居中对齐"
+            },
+            {
+              "name": "end",
+              "description": "底部对齐"
+            }
+          ],
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-submenu-open"
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-alignment"
             }
           ]
         },
@@ -3146,7 +3050,7 @@
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-href"
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-href"
             }
           ]
         },
@@ -3156,7 +3060,7 @@
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-download"
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-download"
             }
           ]
         },
@@ -3184,7 +3088,7 @@
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-target"
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-target"
             }
           ]
         },
@@ -3252,7 +3156,7 @@
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-rel"
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-rel"
             }
           ]
         },
@@ -3262,17 +3166,17 @@
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-autofocus"
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-autofocus"
             }
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-item-attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/list#list-item-attributes-tabIndex"
             }
           ]
         }
@@ -3280,103 +3184,199 @@
       "references": [
         {
           "name": "开发文档",
-          "url": "https://www.mdui.org/docs/2/components/menu"
+          "url": "https://www.mdui.org/docs/2/components/list"
         },
         {
           "name": "Github",
-          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/menu/menu-item.ts"
+          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/list/list-item.ts"
         }
       ]
     },
     {
-      "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```",
+      "references": [
+        {
+          "name": "开发文档",
+          "url": "https://www.mdui.org/docs/2/components/list"
+        },
+        {
+          "name": "Github",
+          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/list/list-subheader.ts"
+        }
+      ]
+    },
+    {
+      "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```",
+      "references": [
+        {
+          "name": "开发文档",
+          "url": "https://www.mdui.org/docs/2/components/list"
+        },
+        {
+          "name": "Github",
+          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/list/list.ts"
+        }
+      ]
+    },
+    {
+      "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": "selects",
-          "description": "菜单项的可选中状态。默认为不可选中。可选值为：\n\n* `single`：最多只能选中一个\n* `multiple`：可以选中多个",
-          "values": [
-            {
-              "name": "single",
-              "description": "最多只能选中一个"
-            },
-            {
-              "name": "multiple",
-              "description": "可以选中多个"
-            }
-          ],
+          "name": "open",
+          "description": "dropdown 是否打开",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-selects"
+              "url": "https://www.mdui.org/docs/2/components/dropdown#attributes-open"
             }
           ]
         },
         {
-          "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": "是否禁用 dropdown",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-value"
+              "url": "https://www.mdui.org/docs/2/components/dropdown#attributes-disabled"
             }
           ]
         },
         {
-          "name": "dense",
-          "description": "菜单项是否使用更紧凑的布局",
+          "name": "trigger",
+          "description": "dropdown 的触发方式，支持传入多个值，用空格分隔。可选值为：\n\n* `click`：点击时触发\n* `hover`：鼠标悬浮触发\n* `focus`：聚焦时触发\n* `contextmenu`：鼠标右键点击、或触摸长按时触发\n* `manual`：使用了该值时，只能使用编程方式打开和关闭 dropdown，且不能再指定其他触发方式",
+          "values": [
+            {
+              "name": "click",
+              "description": "点击时触发"
+            },
+            {
+              "name": "hover",
+              "description": "鼠标悬浮触发"
+            },
+            {
+              "name": "focus",
+              "description": "聚焦时触发"
+            },
+            {
+              "name": "contextmenu",
+              "description": "鼠标右键点击、或触摸长按时触发"
+            },
+            {
+              "name": "manual",
+              "description": "使用了该值时，只能使用编程方式打开和关闭 dropdown，且不能再指定其他触发方式"
+            }
+          ],
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-dense"
+              "url": "https://www.mdui.org/docs/2/components/dropdown#attributes-trigger"
             }
           ]
         },
         {
-          "name": "submenu-trigger",
-          "description": "子菜单的触发方式，支持传入多个值，用空格分隔。可选值为：\n\n* `click`：点击菜单项时打开子菜单\n* `hover`：鼠标悬浮到菜单项上时打开子菜单\n* `focus`：聚焦到菜单项上时打开子菜单\n* `manual`：使用了该值时，只能使用编程方式打开和关闭子菜单，且不能再指定其他触发方式",
+          "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`：位于右侧，且底部对齐",
           "values": [
             {
-              "name": "click",
-              "description": "点击菜单项时打开子菜单"
+              "name": "auto",
+              "description": "自动判断位置"
             },
             {
-              "name": "hover",
-              "description": "鼠标悬浮到菜单项上时打开子菜单"
+              "name": "top-start",
+              "description": "位于上方，且左对齐"
             },
             {
-              "name": "focus",
-              "description": "聚焦到菜单项上时打开子菜单"
+              "name": "top",
+              "description": "位于上方，且居中对齐"
             },
             {
-              "name": "manual",
-              "description": "使用了该值时，只能使用编程方式打开和关闭子菜单，且不能再指定其他触发方式"
+              "name": "top-end",
+              "description": "位于上方，且右对齐"
+            },
+            {
+              "name": "bottom-start",
+              "description": "位于下方，且左对齐"
+            },
+            {
+              "name": "bottom",
+              "description": "位于下方，且居中对齐"
+            },
+            {
+              "name": "bottom-end",
+              "description": "位于下方，且右对齐"
+            },
+            {
+              "name": "left-start",
+              "description": "位于左侧，且顶部对齐"
+            },
+            {
+              "name": "left",
+              "description": "位于左侧，且居中对齐"
+            },
+            {
+              "name": "left-end",
+              "description": "位于左侧，且底部对齐"
+            },
+            {
+              "name": "right-start",
+              "description": "位于右侧，且顶部对齐"
+            },
+            {
+              "name": "right",
+              "description": "位于右侧，且居中对齐"
+            },
+            {
+              "name": "right-end",
+              "description": "位于右侧，且底部对齐"
             }
           ],
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenu-trigger"
+              "url": "https://www.mdui.org/docs/2/components/dropdown#attributes-placement"
             }
           ]
         },
         {
-          "name": "submenu-open-delay",
-          "description": "通过 hover 触发子菜单打开时的延时，单位为毫秒",
+          "name": "stay-open-on-click",
+          "description": "在点击 [`<mdui-menu-item>`](https://www.mdui.org/docs/2/components/menu#menu-item-api) 元素后，是否仍保持 dropdown 为打开状态",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenu-open-delay"
+              "url": "https://www.mdui.org/docs/2/components/dropdown#attributes-stay-open-on-click"
             }
           ]
         },
         {
-          "name": "submenu-close-delay",
-          "description": "通过 hover 触发子菜单关闭时的延时，单位为毫秒",
+          "name": "open-delay",
+          "description": "通过 hover 触发 dropdown 打开时的延时，单位为毫秒",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/menu#menu-attributes-submenu-close-delay"
+              "url": "https://www.mdui.org/docs/2/components/dropdown#attributes-open-delay"
+            }
+          ]
+        },
+        {
+          "name": "close-delay",
+          "description": "通过 hover 触发 dropdown 关闭时的延时，单位为毫秒",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/dropdown#attributes-close-delay"
+            }
+          ]
+        },
+        {
+          "name": "open-on-pointer",
+          "description": "是否在触发 dropdown 时的光标所在的位置打开 dropdown。通常用于在打开鼠标右键菜单时使用",
+          "references": [
+            {
+              "name": "开发文档",
+              "url": "https://www.mdui.org/docs/2/components/dropdown#attributes-open-on-pointer"
             }
           ]
         }
@@ -3384,11 +3384,11 @@
       "references": [
         {
           "name": "开发文档",
-          "url": "https://www.mdui.org/docs/2/components/menu"
+          "url": "https://www.mdui.org/docs/2/components/dropdown"
         },
         {
           "name": "Github",
-          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/menu/menu.ts"
+          "url": "https://github.com/zdhxiong/mdui/packages/mdui/src/components/dropdown/index.ts"
         }
       ]
     },
@@ -3553,12 +3553,12 @@
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/navigation-bar#navigation-bar-item-attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/navigation-bar#navigation-bar-item-attributes-tabIndex"
             }
           ]
         }
@@ -3949,12 +3949,12 @@
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/navigation-rail#navigation-rail-item-attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/navigation-rail#navigation-rail-item-attributes-tabIndex"
             }
           ]
         }
@@ -4201,12 +4201,12 @@
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/radio#radio-attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/radio#radio-attributes-tabIndex"
             }
           ]
         }
@@ -4237,12 +4237,12 @@
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/range-slider#attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/range-slider#attributes-tabIndex"
             }
           ]
         },
@@ -4595,12 +4595,12 @@
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/segmented-button#segmented-button-attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/segmented-button#segmented-button-attributes-tabIndex"
             }
           ]
         },
@@ -5021,12 +5021,12 @@
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/select#attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/select#attributes-tabIndex"
             }
           ]
         }
@@ -5067,12 +5067,12 @@
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/slider#attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/slider#attributes-tabIndex"
             }
           ]
         },
@@ -5405,12 +5405,12 @@
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/switch#attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/switch#attributes-tabIndex"
             }
           ]
         }
@@ -5497,12 +5497,12 @@
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/tabs#tab-attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/tabs#tab-attributes-tabIndex"
             }
           ]
         }
@@ -6205,12 +6205,12 @@
           ]
         },
         {
-          "name": "tabindex",
+          "name": "tabIndex",
           "description": "通过 Tab 键在元素之间切换焦点时，tabIndex 属性指定了元素获取焦点的顺序",
           "references": [
             {
               "name": "开发文档",
-              "url": "https://www.mdui.org/docs/2/components/text-field#attributes-tabindex"
+              "url": "https://www.mdui.org/docs/2/components/text-field#attributes-tabIndex"
             }
           ]
         }