mdui 2.0.3 → 2.0.4

package/components/list/list-item.d.ts

@@ -4,7 +4,7 @@ import type { Ripple } from '../ripple/index.js';
 import type { CSSResultGroup, TemplateResult } from 'lit';
 declare const ListItem_base: import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/anchor.js").AnchorMixinInterface> & import("@open-wc/dedupe-mixin").Constructor<import("../ripple/ripple-mixin.js").RippleMixinInterface> & import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/focusable.js").FocusableMixinInterface> & typeof MduiElement;
 /**
- * @summary 列表项组件。需与 `<mdui-list>` 组件配合使用
+ * @summary 列表项组件。需配合 `<mdui-list>` 组件使用
  *
  * ```html
  * <mdui-list>
@@ -30,8 +30,8 @@ declare const ListItem_base: import("@open-wc/dedupe-mixin").Constructor<import(
  * @csspart headline - 主标题
  * @csspart description - 副标题
  *
- * @cssprop --shape-corner - 列表项的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
- * @cssprop --shape-corner-rounded - 指定了 `rounded` 时，列表项的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner - 列表项的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner-rounded - 指定了 `rounded` 属性时，列表项的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
 export declare class ListItem extends ListItem_base<ListItemEventMap> {
     static styles: CSSResultGroup;
@@ -40,25 +40,25 @@ export declare class ListItem extends ListItem_base<ListItemEventMap> {
      */
     headline?: string;
     /**
-     * 主文本行数，超过行数限制后会截断显示。默认为没有行数限制。可选值为：
+     * 主文本行数，超过限制后将截断显示。默认无行数限制。可选值包括：
      *
-     * * `1`：显示单行文本，超出后截断显示
-     * * `2`：显示两行文本，超出后截断显示
-     * * `3`：显示三行文本，超出后截断显示
+     * * `1`：显示单行，超出后截断
+     * * `2`：显示两行，超出后截断
+     * * `3`：显示三行，超出后截断
      */
-    headlineLine?: /*显示单行文本，超出后截断显示*/ 1 | /*显示两行文本，超出后截断显示*/ 2 | /*显示三行文本，超出后截断显示*/ 3;
+    headlineLine?: /*显示单行，超出后截断*/ 1 | /*显示两行，超出后截断*/ 2 | /*显示三行，超出后截断*/ 3;
     /**
      * 副文本。也可以通过 `slot="description"` 设置
      */
     description?: string;
     /**
-     * 副文本行数，超过行数限制后会截断显示。默认为没有行数限制。可选值为：
+     * 副文本行数，超过限制后将截断显示。默认无行数限制。可选值包括：
      *
-     * * `1`：显示单行文本，超出后截断显示
-     * * `2`：显示两行文本，超出后截断显示
-     * * `3`：显示三行文本，超出后截断显示
+     * * `1`：显示单行，超出后截断
+     * * `2`：显示两行，超出后截断
+     * * `3`：显示三行，超出后截断
      */
-    descriptionLine?: 1 | 2 | 3;
+    descriptionLine?: /*显示单行，超出后截断*/ 1 | /*显示两行，超出后截断*/ 2 | /*显示三行，超出后截断*/ 3;
     /**
      * 左侧的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
      */
@@ -68,7 +68,7 @@ export declare class ListItem extends ListItem_base<ListItemEventMap> {
      */
     endIcon?: string;
     /**
-     * 是否禁用该列表项，列表项将置灰，且其中的 [`<mdui-checkbox>`](/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等都将禁用
+     * 是否禁用该列表项，禁用后，列表项将变为灰色，且其中的 [`<mdui-checkbox>`](/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等也将禁用
      */
     disabled: boolean;
     /**
@@ -76,15 +76,15 @@ export declare class ListItem extends ListItem_base<ListItemEventMap> {
      */
     active: boolean;
     /**
-     * 是否使列表项不可点击，但其中的 [`<mdui-checkbox>`](/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等仍可进行交互
+     * 是否使列表项不可点击。设置后，列表项中的 [`<mdui-checkbox>`](/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等仍可交互
      */
     nonclickable: boolean;
     /**
-     * 使用圆角形状的列表项
+     * 是否使用圆角形状的列表项
      */
     rounded: boolean;
     /**
-     * 列表项的垂直对齐方式。可选值为：
+     * 列表项的垂直对齐方式。可选值包括：
      *
      * * `start`：顶部对齐
      * * `center`：居中对齐

package/components/list/list-item.js

@@ -15,7 +15,7 @@ import '../icon.js';
 import { RippleMixin } from '../ripple/ripple-mixin.js';
 import { listItemStyle } from './list-item-style.js';
 /**
- * @summary 列表项组件。需与 `<mdui-list>` 组件配合使用
+ * @summary 列表项组件。需配合 `<mdui-list>` 组件使用
  *
  * ```html
  * <mdui-list>
@@ -41,14 +41,14 @@ import { listItemStyle } from './list-item-style.js';
  * @csspart headline - 主标题
  * @csspart description - 副标题
  *
- * @cssprop --shape-corner - 列表项的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
- * @cssprop --shape-corner-rounded - 指定了 `rounded` 时，列表项的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner - 列表项的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner-rounded - 指定了 `rounded` 属性时，列表项的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
 let ListItem = class ListItem extends AnchorMixin(RippleMixin(FocusableMixin(MduiElement))) {
     constructor() {
         super(...arguments);
         /**
-         * 是否禁用该列表项，列表项将置灰，且其中的 [`<mdui-checkbox>`](/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等都将禁用
+         * 是否禁用该列表项，禁用后，列表项将变为灰色，且其中的 [`<mdui-checkbox>`](/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等也将禁用
          */
         this.disabled = false;
         /**
@@ -56,15 +56,15 @@ let ListItem = class ListItem extends AnchorMixin(RippleMixin(FocusableMixin(Mdu
          */
         this.active = false;
         /**
-         * 是否使列表项不可点击，但其中的 [`<mdui-checkbox>`](/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等仍可进行交互
+         * 是否使列表项不可点击。设置后，列表项中的 [`<mdui-checkbox>`](/docs/2/components/checkbox)、[`<mdui-radio>`](/docs/2/components/radio)、[`<mdui-switch>`](/docs/2/components/switch) 等仍可交互
          */
         this.nonclickable = false;
         /**
-         * 使用圆角形状的列表项
+         * 是否使用圆角形状的列表项
          */
         this.rounded = false;
         /**
-         * 列表项的垂直对齐方式。可选值为：
+         * 列表项的垂直对齐方式。可选值包括：
          *
          * * `start`：顶部对齐
          * * `center`：居中对齐

package/components/list/list-subheader.d.ts

@@ -1,7 +1,7 @@
 import { MduiElement } from '@mdui/shared/base/mdui-element.js';
 import type { CSSResultGroup, TemplateResult } from 'lit';
 /**
- * @summary 列表标题组件。需与 `<mdui-list>` 组件配合使用
+ * @summary 列表标题组件。需配合 `<mdui-list>` 组件使用
  *
  * ```html
  * <mdui-list>
@@ -11,7 +11,7 @@ import type { CSSResultGroup, TemplateResult } from 'lit';
  * </mdui-list>
  * ```
  *
- * @slot - 文本
+ * @slot - 列表标题文本
  */
 export declare class ListSubheader extends MduiElement<ListSubheaderEventMap> {
     static styles: CSSResultGroup;

package/components/list/list-subheader.js

@@ -5,7 +5,7 @@ import { MduiElement } from '@mdui/shared/base/mdui-element.js';
 import { componentStyle } from '@mdui/shared/lit-styles/component-style.js';
 import { listSubheaderStyle } from './list-subheader-style.js';
 /**
- * @summary 列表标题组件。需与 `<mdui-list>` 组件配合使用
+ * @summary 列表标题组件。需配合 `<mdui-list>` 组件使用
  *
  * ```html
  * <mdui-list>
@@ -15,7 +15,7 @@ import { listSubheaderStyle } from './list-subheader-style.js';
  * </mdui-list>
  * ```
  *
- * @slot - 文本
+ * @slot - 列表标题文本
  */
 let ListSubheader = class ListSubheader extends MduiElement {
     render() {

package/components/list/list.d.ts

@@ -1,7 +1,7 @@
 import { MduiElement } from '@mdui/shared/base/mdui-element.js';
 import type { CSSResultGroup, TemplateResult } from 'lit';
 /**
- * @summary 列表组件。需与 `<mdui-list-item>` 组件配合使用
+ * @summary 列表组件。需配合 `<mdui-list-item>` 组件使用
  *
  * ```html
  * <mdui-list>

package/components/list/list.js

@@ -5,7 +5,7 @@ import { MduiElement } from '@mdui/shared/base/mdui-element.js';
 import { componentStyle } from '@mdui/shared/lit-styles/component-style.js';
 import { listStyle } from './list-style.js';
 /**
- * @summary 列表组件。需与 `<mdui-list-item>` 组件配合使用
+ * @summary 列表组件。需配合 `<mdui-list-item>` 组件使用
  *
  * ```html
  * <mdui-list>

package/components/menu/menu-item.d.ts

@@ -12,7 +12,7 @@ import type { Ripple } from '../ripple/index.js';
 import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
 declare const MenuItem_base: import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/anchor.js").AnchorMixinInterface> & import("@open-wc/dedupe-mixin").Constructor<import("../ripple/ripple-mixin.js").RippleMixinInterface> & import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/focusable.js").FocusableMixinInterface> & typeof MduiElement;
 /**
- * @summary 菜单项组件
+ * @summary 菜单项组件。需配合 `<mdui-menu>` 组件使用
  *
  * ```html
  * <mdui-menu>
@@ -47,17 +47,17 @@ declare const MenuItem_base: import("@open-wc/dedupe-mixin").Constructor<import(
 export declare class MenuItem extends MenuItem_base<MenuItemEventMap> {
     static styles: CSSResultGroup;
     /**
-     * 该菜单项的值
+     * 菜单项的值
      */
     value?: string;
     /**
-     * 是否禁用该菜单项
+     * 是否禁用菜单项
      */
     disabled: boolean;
     /**
      * 左侧的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
      *
-     * 如果需要在左侧留出一个图标的位置，可以传入空字符串进行占位
+     * 如果左侧不需要显示图标，但需要预留一个图标的位置，可传入空字符串进行占位
      */
     icon?: string;
     /**

package/components/menu/menu-item.js

@@ -30,7 +30,7 @@ import '../icon.js';
 import { RippleMixin } from '../ripple/ripple-mixin.js';
 import { menuItemStyle } from './menu-item-style.js';
 /**
- * @summary 菜单项组件
+ * @summary 菜单项组件。需配合 `<mdui-menu>` 组件使用
  *
  * ```html
  * <mdui-menu>
@@ -66,7 +66,7 @@ let MenuItem = class MenuItem extends AnchorMixin(RippleMixin(FocusableMixin(Mdu
     constructor() {
         super();
         /**
-         * 是否禁用该菜单项
+         * 是否禁用菜单项
          */
         this.disabled = false;
         /**

package/components/menu/menu.d.ts

@@ -15,7 +15,7 @@ import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
  * * `Enter` - 包含子菜单时，打开子菜单；为链接时，跳转链接
  * * `Escape` - 子菜单已打开时，关闭子菜单
  *
- * @summary 菜单组件。需与 `<mdui-menu-item>` 组件配合使用
+ * @summary 菜单组件。需配合 `<mdui-menu-item>` 组件使用
  *
  * ```html
  * <mdui-menu>
@@ -24,49 +24,46 @@ import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
  * </mdui-menu>
  * ```
  *
- * @event change - 菜单项的选中状态变化时触发
+ * @event change - 菜单项选中状态变化时触发
  *
  * @slot - 子菜单项（`<mdui-menu-item>`）、分割线（[`<mdui-divider>`](/docs/2/components/divider)）等元素
  *
- * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
 export declare class Menu extends MduiElement<MenuEventMap> {
     static styles: CSSResultGroup;
     /**
-     * 菜单项的可选中状态。默认为不可选中。可选值为：
+     * 菜单项的可选状态。默认不可选。可选值包括：
      *
-     * * `single`：最多只能选中一个
-     * * `multiple`：可以选中多个
+     * * `single`：单选
+     * * `multiple`：多选
      */
-    selects?: /*最多只能选中一个*/ 'single' | /*可以选中多个*/ 'multiple';
+    selects?: /*单选*/ 'single' | /*多选*/ 'multiple';
     /**
-     * 当前选中的 `<mdui-menu-item>` 的值
+     * 当前选中的 `<mdui-menu-item>` 的值。
      *
-     * Note:
-     * 该属性的 HTML 属性始终为字符串，且仅在 `selects="single"` 时可以通过 HTML 属性设置初始值；
-     * 该属性的 JavaScript 属性值在 `selects="single"` 时为字符串、在 `selects="multiple"` 时为字符串数组。
-     * 所以，在 `selects="multiple"` 时，如果要修改该值，只能通过修改 JavaScript 属性值实现。
+     * **Note**：该属性的 HTML 属性始终为字符串，仅在 `selects="single"` 时可通过 HTML 属性设置初始值；该属性的 JavaScript 属性值在 `selects="single"` 时为字符串，在 `selects="multiple"` 时为字符串数组。因此，在 `selects="multiple"` 时，若要修改该值，只能通过修改 JavaScript 属性值实现。
      */
     value?: string | string[];
     /**
-     * 菜单项是否使用更紧凑的布局
+     * 菜单项是否使用紧凑布局
      */
     dense: boolean;
     /**
-     * 子菜单的触发方式，支持传入多个值，用空格分隔。可选值为：
+     * 子菜单的触发方式，支持多个值，用空格分隔。可选值包括：
      *
      * * `click`：点击菜单项时打开子菜单
      * * `hover`：鼠标悬浮到菜单项上时打开子菜单
      * * `focus`：聚焦到菜单项上时打开子菜单
-     * * `manual`：使用了该值时，只能使用编程方式打开和关闭子菜单，且不能再指定其他触发方式
+     * * `manual`：仅能通过编程方式打开和关闭子菜单，不能再指定其他触发方式
      */
-    submenuTrigger: /*点击菜单项时打开子菜单*/ 'click' | /*鼠标悬浮到菜单项上时打开子菜单*/ 'hover' | /*聚焦到菜单项上时打开子菜单*/ 'focus' | /*使用了该值时，只能使用编程方式打开和关闭子菜单，且不能再指定其他触发方式*/ 'manual' | string;
+    submenuTrigger: /*点击菜单项时打开子菜单*/ 'click' | /*鼠标悬浮到菜单项上时打开子菜单*/ 'hover' | /*聚焦到菜单项上时打开子菜单*/ 'focus' | /*仅能通过编程方式打开和关闭子菜单，不能再指定其他触发方式*/ 'manual' | string;
     /**
-     * 通过 hover 触发子菜单打开时的延时，单位为毫秒
+     * 鼠标悬浮触发子菜单打开的延时，单位毫秒
      */
     submenuOpenDelay: number;
     /**
-     * 通过 hover 触发子菜单关闭时的延时，单位为毫秒
+     * 鼠标悬浮触发子菜单关闭的延时，单位毫秒
      */
     submenuCloseDelay: number;
     private selectedKeys;

package/components/menu/menu.js

@@ -26,7 +26,7 @@ import { menuStyle } from './menu-style.js';
  * * `Enter` - 包含子菜单时，打开子菜单；为链接时，跳转链接
  * * `Escape` - 子菜单已打开时，关闭子菜单
  *
- * @summary 菜单组件。需与 `<mdui-menu-item>` 组件配合使用
+ * @summary 菜单组件。需配合 `<mdui-menu-item>` 组件使用
  *
  * ```html
  * <mdui-menu>
@@ -35,34 +35,34 @@ import { menuStyle } from './menu-style.js';
  * </mdui-menu>
  * ```
  *
- * @event change - 菜单项的选中状态变化时触发
+ * @event change - 菜单项选中状态变化时触发
  *
  * @slot - 子菜单项（`<mdui-menu-item>`）、分割线（[`<mdui-divider>`](/docs/2/components/divider)）等元素
  *
- * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
 let Menu = class Menu extends MduiElement {
     constructor() {
         super(...arguments);
         /**
-         * 菜单项是否使用更紧凑的布局
+         * 菜单项是否使用紧凑布局
          */
         this.dense = false;
         /**
-         * 子菜单的触发方式，支持传入多个值，用空格分隔。可选值为：
+         * 子菜单的触发方式，支持多个值，用空格分隔。可选值包括：
          *
          * * `click`：点击菜单项时打开子菜单
          * * `hover`：鼠标悬浮到菜单项上时打开子菜单
          * * `focus`：聚焦到菜单项上时打开子菜单
-         * * `manual`：使用了该值时，只能使用编程方式打开和关闭子菜单，且不能再指定其他触发方式
+         * * `manual`：仅能通过编程方式打开和关闭子菜单，不能再指定其他触发方式
          */
         this.submenuTrigger = 'click hover';
         /**
-         * 通过 hover 触发子菜单打开时的延时，单位为毫秒
+         * 鼠标悬浮触发子菜单打开的延时，单位毫秒
          */
         this.submenuOpenDelay = 200;
         /**
-         * 通过 hover 触发子菜单关闭时的延时，单位为毫秒
+         * 鼠标悬浮触发子菜单关闭的延时，单位毫秒
          */
         this.submenuCloseDelay = 200;
         // 因为 menu-item 的 value 可能会重复，所有在每一个 menu-item 元素上都加了一个唯一的 key 属性，通过 selectedKeys 来记录选中状态的 key

package/components/navigation-bar/navigation-bar-item.d.ts

@@ -4,7 +4,7 @@ import type { Ripple } from '../ripple/index.js';
 import type { CSSResultGroup, TemplateResult } from 'lit';
 declare const NavigationBarItem_base: import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/anchor.js").AnchorMixinInterface> & import("@open-wc/dedupe-mixin").Constructor<import("../ripple/ripple-mixin.js").RippleMixinInterface> & import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/focusable.js").FocusableMixinInterface> & typeof MduiElement;
 /**
- * @summary 底部导航栏项组件。需与 `<mdui-navigation-bar>` 组件配合使用
+ * @summary 底部导航栏项组件。需配合 `<mdui-navigation-bar>` 组件使用
  *
  * ```html
  * <mdui-navigation-bar>
@@ -14,7 +14,7 @@ declare const NavigationBarItem_base: import("@open-wc/dedupe-mixin").Constructo
  * </mdui-navigation-bar>
  * ```
  *
- * @slot - 文本
+ * @slot - 导航项文本
  * @slot icon - 图标
  * @slot active-icon - 激活状态的图标元素
  * @slot badge - 徽标
@@ -27,9 +27,9 @@ declare const NavigationBarItem_base: import("@open-wc/dedupe-mixin").Constructo
  * @csspart badge - 徽标
  * @csspart icon - 图标
  * @csspart active-icon - 激活状态的图标
- * @csspart label - 文本
+ * @csspart label - 导航项文本
  *
- * @cssprop --shape-corner-indicator - 指示器的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner-indicator - 指示器的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
 export declare class NavigationBarItem extends NavigationBarItem_base<NavigationBarItemEventMap> {
     static styles: CSSResultGroup;
@@ -42,7 +42,7 @@ export declare class NavigationBarItem extends NavigationBarItem_base<Navigation
      */
     activeIcon?: string;
     /**
-     * 该导航项的值
+     * 导航项的值
      */
     value?: string;
     /**

package/components/navigation-bar/navigation-bar-item.js

@@ -15,7 +15,7 @@ import '../icon.js';
 import { RippleMixin } from '../ripple/ripple-mixin.js';
 import { navigationBarItemStyle } from './navigation-bar-item-style.js';
 /**
- * @summary 底部导航栏项组件。需与 `<mdui-navigation-bar>` 组件配合使用
+ * @summary 底部导航栏项组件。需配合 `<mdui-navigation-bar>` 组件使用
  *
  * ```html
  * <mdui-navigation-bar>
@@ -25,7 +25,7 @@ import { navigationBarItemStyle } from './navigation-bar-item-style.js';
  * </mdui-navigation-bar>
  * ```
  *
- * @slot - 文本
+ * @slot - 导航项文本
  * @slot icon - 图标
  * @slot active-icon - 激活状态的图标元素
  * @slot badge - 徽标
@@ -38,9 +38,9 @@ import { navigationBarItemStyle } from './navigation-bar-item-style.js';
  * @csspart badge - 徽标
  * @csspart icon - 图标
  * @csspart active-icon - 激活状态的图标
- * @csspart label - 文本
+ * @csspart label - 导航项文本
  *
- * @cssprop --shape-corner-indicator - 指示器的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner-indicator - 指示器的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
 let NavigationBarItem = class NavigationBarItem extends AnchorMixin(RippleMixin(FocusableMixin(MduiElement))) {
     constructor() {

package/components/navigation-bar/navigation-bar.d.ts

@@ -5,7 +5,7 @@ import type { ScrollPaddingPosition } from '@mdui/shared/mixins/scrollBehavior.j
 import type { CSSResultGroup, TemplateResult } from 'lit';
 declare const NavigationBar_base: import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/scrollBehavior.js").ScrollBehaviorMixinInterface> & typeof LayoutItemBase;
 /**
- * @summary 底部导航栏组件。需与 `<mdui-navigation-bar-item>` 组件配合使用
+ * @summary 底部导航栏组件。需配合 `<mdui-navigation-bar-item>` 组件使用
  *
  * ```html
  * <mdui-navigation-bar>
@@ -23,8 +23,8 @@ declare const NavigationBar_base: import("@open-wc/dedupe-mixin").Constructor<im
  *
  * @slot - `<mdui-navigation-bar-item>` 组件
  *
- * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
- * @cssprop --z-index - 组件的 CSS 的 `z-index` 值
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --z-index - 组件的 CSS `z-index` 值
  */
 export declare class NavigationBar extends NavigationBar_base<NavigationBarEventMap> {
     static styles: CSSResultGroup;
@@ -33,20 +33,21 @@ export declare class NavigationBar extends NavigationBar_base<NavigationBarEvent
      */
     hide: boolean;
     /**
-     * 文本的可视状态。可选值为：
+     * 文本的可视状态。可选值包括：
      *
-     * * `auto`：小于等于3个选项时，始终显示；大于3个选项时，仅显示选中状态的文本
-     * * `selected`：仅选中状态显示文本
+     * * `auto`：当选项小于等于3个时，始终显示文本；当选项大于3个时，仅显示选中状态的文本
+     * * `selected`：仅在选中状态显示文本
      * * `labeled`：始终显示文本
      * * `unlabeled`：始终不显示文本
      */
-    labelVisibility: /*小于等于3个选项时，始终显示；大于3个选项时，仅显示选中状态的文本*/ 'auto' | /*仅选中状态显示文本*/ 'selected' | /*始终显示文本*/ 'labeled' | /*始终不显示文本*/ 'unlabeled';
+    labelVisibility: /*当选项小于等于3个时，始终显示文本；当选项大于3个时，仅显示选中状态的文本*/ 'auto' | /*仅在选中状态显示文本*/ 'selected' | /*始终显示文本*/ 'labeled' | /*始终不显示文本*/ 'unlabeled';
     /**
      * 当前选中的 `<mdui-navigation-bar-item>` 的值
      */
     value?: string;
     /**
-     * 滚动行为。可选值为：
+     * 滚动行为。可选值包括：
+     *
      * * `hide`：滚动时隐藏
      */
     scrollBehavior?: 'hide';

package/components/navigation-bar/navigation-bar.js

@@ -9,7 +9,7 @@ import { ScrollBehaviorMixin } from '@mdui/shared/mixins/scrollBehavior.js';
 import { LayoutItemBase } from '../layout/layout-item-base.js';
 import { navigationBarStyle } from './navigation-bar-style.js';
 /**
- * @summary 底部导航栏组件。需与 `<mdui-navigation-bar-item>` 组件配合使用
+ * @summary 底部导航栏组件。需配合 `<mdui-navigation-bar-item>` 组件使用
  *
  * ```html
  * <mdui-navigation-bar>
@@ -27,8 +27,8 @@ import { navigationBarStyle } from './navigation-bar-style.js';
  *
  * @slot - `<mdui-navigation-bar-item>` 组件
  *
- * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
- * @cssprop --z-index - 组件的 CSS 的 `z-index` 值
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --z-index - 组件的 CSS `z-index` 值
  */
 let NavigationBar = class NavigationBar extends ScrollBehaviorMixin(LayoutItemBase) {
     constructor() {
@@ -38,10 +38,10 @@ let NavigationBar = class NavigationBar extends ScrollBehaviorMixin(LayoutItemBa
          */
         this.hide = false;
         /**
-         * 文本的可视状态。可选值为：
+         * 文本的可视状态。可选值包括：
          *
-         * * `auto`：小于等于3个选项时，始终显示；大于3个选项时，仅显示选中状态的文本
-         * * `selected`：仅选中状态显示文本
+         * * `auto`：当选项小于等于3个时，始终显示文本；当选项大于3个时，仅显示选中状态的文本
+         * * `selected`：仅在选中状态显示文本
          * * `labeled`：始终显示文本
          * * `unlabeled`：始终不显示文本
          */

package/components/navigation-drawer/index.d.ts

@@ -12,52 +12,51 @@ import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
  * <mdui-navigation-drawer>content</mdui-navigation-drawer>
  * ```
  *
- * @event open - 在抽屉导航打开之前触发。可以通过调用 `event.preventDefault()` 阻止抽屉导航打开
- * @event opened - 在抽屉导航打开之后触发
- * @event close - 在抽屉导航关闭之前触发。可以通过调用 `event.preventDefault()` 阻止抽屉导航关闭
- * @event closed - 在抽屉导航关闭之后触发
+ * @event open - 抽屉栏打开之前触发。可以通过调用 `event.preventDefault()` 阻止抽屉栏打开
+ * @event opened - 抽屉栏打开动画完成之后触发
+ * @event close - 抽屉栏关闭之前触发。可以通过调用 `event.preventDefault()` 阻止抽屉栏关闭
+ * @event closed - 抽屉栏关闭动画完成之后触发
  * @event overlay-click - 点击遮罩层时触发
  *
- * @slot - 抽屉导航中的内容
+ * @slot - 抽屉栏中的内容
  *
  * @csspart overlay - 遮罩层
- * @csspart panel - 抽屉导航容器
+ * @csspart panel - 抽屉栏容器
  *
- * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
- * @cssprop --z-index - 组件的 CSS 的 `z-index` 值
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --z-index - 组件的 CSS `z-index` 值
  */
 export declare class NavigationDrawer extends LayoutItemBase<NavigationDrawerEventMap> {
     static styles: CSSResultGroup;
     /**
-     * 是否打开抽屉导航
+     * 是否打开抽屉栏
      */
     open: boolean;
     /**
-     * 打开时，是否显示遮罩层
+     * 抽屉栏打开时，是否显示遮罩层
      *
-     * 较窄的设备上（屏幕宽度小于 [`--mdui-breakpoint-md`](/docs/2/styles/design-tokens#breakpoint) 时），会无视该参数，始终显示遮罩层
+     * 在窄屏设备上（屏幕宽度小于 [`--mdui-breakpoint-md`](/docs/2/styles/design-tokens#breakpoint)），会始终显示遮罩层，无视该参数
      */
     modal: boolean;
     /**
-     * 在含遮罩层时，是否在按下 ESC 键时，关闭抽屉导航
+     * 在有遮罩层的情况下，按下 ESC 键是否关闭抽屉栏
      */
     closeOnEsc: boolean;
     /**
-     * 是否在点击遮罩时，关闭抽屉导航
+     * 点击遮罩层时，是否关闭抽屉栏
      */
     closeOnOverlayClick: boolean;
     /**
-     * 抽屉导航的显示位置。可选值为：
+     * 抽屉栏的位置。可选值包括：
      *
-     * * `left`：显示在左侧
-     * * `right`：显示在右侧
+     * * `left`：左侧
+     * * `right`：右侧
      */
-    placement: /*显示在左侧*/ 'left' | /*显示在右侧*/ 'right';
+    placement: /*左侧*/ 'left' | /*右侧*/ 'right';
     /**
-     * 默认抽屉导航相对于 `body` 元素显示，该参数设置为 `true` 时，抽屉导航将相对于它的父元素显示
+     * 默认情况下，抽屉栏相对于 `body` 元素显示。当该参数设置为 `true` 时，抽屉栏将相对于其父元素显示。
      *
-     * Note:
-     * 设置了该属性时，必须手动在父元素上设置样式 `position: relative; overflow: hidden;`
+     * **Note**：设置该属性时，必须在父元素上手动设置样式 `position: relative; overflow: hidden;`。
      */
     contained: boolean;
     private mobile;