mdui 2.0.3 → 2.0.4

package/components/dialog/index.js

@@ -24,10 +24,10 @@ import { style } from './style.js';
  * <mdui-dialog>content</mdui-dialog>
  * ```
  *
- * @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 header - 顶部元素，默认包含 `icon` slot 和 `headline` slot
@@ -39,15 +39,15 @@ import { style } from './style.js';
  *
  * @csspart overlay - 遮罩层
  * @csspart panel - 对话框容器
- * @csspart header - 对话框 header 部分，其中包含了 icon 和 headline
- * @csspart icon - 顶部的图标，位于 header 中
- * @csspart headline - 顶部的标题，位于 header 中
- * @csspart body - 对话框的 body 部分
+ * @csspart header - 对话框 header 部分，包含 icon 和 headline
+ * @csspart icon - 顶部图标，位于 header 中
+ * @csspart headline - 顶部标题，位于 header 中
+ * @csspart body - 对话框 body 部分
  * @csspart description - 副文本部分，位于 body 中
  * @csspart action - 底部操作按钮
  *
- * @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 Dialog = class Dialog extends MduiElement {
     constructor() {
@@ -57,15 +57,15 @@ let Dialog = class Dialog extends MduiElement {
          */
         this.open = false;
         /**
-         * 是否为全屏对话框
+         * 是否全屏显示对话框
          */
         this.fullscreen = false;
         /**
-         * 是否在按下 ESC 键时，关闭对话框
+         * 是否允许按下 ESC 键关闭对话框
          */
         this.closeOnEsc = false;
         /**
-         * 是否在点击遮罩时，关闭对话框
+         * 是否允许点击遮罩层关闭对话框
          */
         this.closeOnOverlayClick = false;
         /**

package/components/divider/index.d.ts

@@ -10,15 +10,15 @@ import type { CSSResultGroup, TemplateResult } from 'lit';
 export declare class Divider extends MduiElement<DividerEventMap> {
     static styles: CSSResultGroup;
     /**
-     * 是否显示垂直分割线
+     * 是否为垂直分割线
      */
     vertical: boolean;
     /**
-     * 是否左侧缩进
+     * 是否进行左侧缩进
      */
     inset: boolean;
     /**
-     * 是否左右两侧缩进
+     * 是否进行左右两侧缩进
      */
     middle: boolean;
     protected render(): TemplateResult;

package/components/divider/index.js

@@ -16,15 +16,15 @@ let Divider = class Divider extends MduiElement {
     constructor() {
         super(...arguments);
         /**
-         * 是否显示垂直分割线
+         * 是否为垂直分割线
          */
         this.vertical = false;
         /**
-         * 是否左侧缩进
+         * 是否进行左侧缩进
          */
         this.inset = false;
         /**
-         * 是否左右两侧缩进
+         * 是否进行左右两侧缩进
          */
         this.middle = false;
     }

package/components/dropdown/index.d.ts

@@ -16,71 +16,71 @@ import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
  * </mdui-dropdown>
  * ```
  *
- * @event open - dropdown 开始打开时，事件被触发。可以通过调用 `event.preventDefault()` 阻止 dropdown 打开
- * @event opened - dropdown 打开动画完成时，事件被触发
- * @event close - dropdown 开始关闭时，事件被触发。可以通过调用 `event.preventDefault()` 阻止 dropdown 关闭
- * @event closed - dropdown 关闭动画完成时，事件被触发
+ * @event open - 下拉组件开始打开时，事件被触发。可以通过调用 `event.preventDefault()` 阻止下拉组件打开
+ * @event opened - 下拉组件打开动画完成时，事件被触发
+ * @event close - 下拉组件开始关闭时，事件被触发。可以通过调用 `event.preventDefault()` 阻止下拉组件关闭
+ * @event closed - 下拉组件关闭动画完成时，事件被触发
  *
- * @slot - dropdown 的内容
- * @slot trigger - 触发 dropdown 的元素，例如 [`<mdui-button>`](/docs/2/components/button) 元素
+ * @slot - 下拉组件的内容
+ * @slot trigger - 触发下拉组件的元素，例如 [`<mdui-button>`](/docs/2/components/button) 元素
  *
- * @csspart trigger - 触发 dropdown 的元素的容器，即 `trigger` slot 的容器
- * @csspart panel - dropdown 内容的容器
+ * @csspart trigger - 触发下拉组件的元素的容器，即 `trigger` slot 的容器
+ * @csspart panel - 下拉组件内容的容器
  *
- * @cssprop --z-index - 组件的 CSS 的 `z-index` 值
+ * @cssprop --z-index - 组件的 CSS `z-index` 值
  */
 export declare class Dropdown extends MduiElement<DropdownEventMap> {
     static styles: CSSResultGroup;
     /**
-     * dropdown 是否打开
+     * 是否打开下拉组件
      */
     open: boolean;
     /**
-     * 是否禁用 dropdown
+     * 是否禁用下拉组件
      */
     disabled: boolean;
     /**
-     * dropdown 的触发方式，支持传入多个值，用空格分隔。可选值为：
+     * 下拉组件的触发方式，支持多个值，用空格分隔。可选值包括：
      *
-     * * `click`：点击时触发
+     * * `click`：点击触发
      * * `hover`：鼠标悬浮触发
-     * * `focus`：聚焦时触发
-     * * `contextmenu`：鼠标右键点击、或触摸长按时触发
-     * * `manual`：使用了该值时，只能使用编程方式打开和关闭 dropdown，且不能再指定其他触发方式
+     * * `focus`：聚焦触发
+     * * `contextmenu`：鼠标右键点击、或触摸长按触发
+     * * `manual`：仅能通过编程方式打开和关闭下拉组件，不能再指定其他触发方式
      */
-    trigger: /*点击时触发*/ 'click' | /*鼠标悬浮触发*/ 'hover' | /*聚焦时触发*/ 'focus' | /*鼠标右键点击、或触摸长按时触发*/ 'contextmenu' | /*使用了该值时，只能使用编程方式打开和关闭 dropdown，且不能再指定其他触发方式*/ 'manual' | string;
+    trigger: /*点击触发*/ 'click' | /*鼠标悬浮触发*/ 'hover' | /*聚焦触发*/ 'focus' | /*鼠标右键点击、或触摸长按触发*/ 'contextmenu' | /*仅能通过编程方式打开和关闭下拉组件，不能再指定其他触发方式*/ 'manual' | string;
     /**
-     * dropdown 内容的位置。可选值为：
+     * 下拉组件内容的位置。可选值包括：
      *
      * * `auto`：自动判断位置
-     * * `top-start`：位于上方，且左对齐
-     * * `top`：位于上方，且居中对齐
-     * * `top-end`：位于上方，且右对齐
-     * * `bottom-start`：位于下方，且左对齐
-     * * `bottom`：位于下方，且居中对齐
-     * * `bottom-end`：位于下方，且右对齐
-     * * `left-start`：位于左侧，且顶部对齐
-     * * `left`：位于左侧，且居中对齐
-     * * `left-end`：位于左侧，且底部对齐
-     * * `right-start`：位于右侧，且顶部对齐
-     * * `right`：位于右侧，且居中对齐
-     * * `right-end`：位于右侧，且底部对齐
+     * * `top-start`：上方左对齐
+     * * `top`：上方居中
+     * * `top-end`：上方右对齐
+     * * `bottom-start`：下方左对齐
+     * * `bottom`：下方居中
+     * * `bottom-end`：下方右对齐
+     * * `left-start`：左侧顶部对齐
+     * * `left`：左侧居中
+     * * `left-end`：左侧底部对齐
+     * * `right-start`：右侧顶部对齐
+     * * `right`：右侧居中
+     * * `right-end`：右侧底部对齐
      */
-    placement: /*自动判断位置*/ 'auto' | /*位于上方，且左对齐*/ 'top-start' | /*位于上方，且居中对齐*/ 'top' | /*位于上方，且右对齐*/ 'top-end' | /*位于下方，且左对齐*/ 'bottom-start' | /*位于下方，且居中对齐*/ 'bottom' | /*位于下方，且右对齐*/ 'bottom-end' | /*位于左侧，且顶部对齐*/ 'left-start' | /*位于左侧，且居中对齐*/ 'left' | /*位于左侧，且底部对齐*/ 'left-end' | /*位于右侧，且顶部对齐*/ 'right-start' | /*位于右侧，且居中对齐*/ 'right' | /*位于右侧，且底部对齐*/ 'right-end';
+    placement: /*自动判断位置*/ 'auto' | /*上方左对齐*/ 'top-start' | /*上方居中*/ 'top' | /*上方右对齐*/ 'top-end' | /*下方左对齐*/ 'bottom-start' | /*下方居中*/ 'bottom' | /*下方右对齐*/ 'bottom-end' | /*左侧顶部对齐*/ 'left-start' | /*左侧居中*/ 'left' | /*左侧底部对齐*/ 'left-end' | /*右侧顶部对齐*/ 'right-start' | /*右侧居中*/ 'right' | /*右侧底部对齐*/ 'right-end';
     /**
-     * 在点击 [`<mdui-menu-item>`](/docs/2/components/menu#menu-item-api) 元素后，是否仍保持 dropdown 为打开状态
+     * 点击 [`<mdui-menu-item>`](/docs/2/components/menu#menu-item-api) 后，下拉组件是否保持打开状态
      */
     stayOpenOnClick: boolean;
     /**
-     * 通过 hover 触发 dropdown 打开时的延时，单位为毫秒
+     * 鼠标悬浮触发下拉组件打开的延时，单位为毫秒
      */
     openDelay: number;
     /**
-     * 通过 hover 触发 dropdown 关闭时的延时，单位为毫秒
+     * 鼠标悬浮触发下拉组件关闭的延时，单位为毫秒
      */
     closeDelay: number;
     /**
-     * 是否在触发 dropdown 时的光标所在的位置打开 dropdown。通常用于在打开鼠标右键菜单时使用
+     * 是否在触发下拉组件的光标位置打开下拉组件，常用于打开鼠标右键菜单
      */
     openOnPointer: boolean;
     private readonly triggerElements;

package/components/dropdown/index.js

@@ -30,72 +30,72 @@ import { style } from './style.js';
  * </mdui-dropdown>
  * ```
  *
- * @event open - dropdown 开始打开时，事件被触发。可以通过调用 `event.preventDefault()` 阻止 dropdown 打开
- * @event opened - dropdown 打开动画完成时，事件被触发
- * @event close - dropdown 开始关闭时，事件被触发。可以通过调用 `event.preventDefault()` 阻止 dropdown 关闭
- * @event closed - dropdown 关闭动画完成时，事件被触发
+ * @event open - 下拉组件开始打开时，事件被触发。可以通过调用 `event.preventDefault()` 阻止下拉组件打开
+ * @event opened - 下拉组件打开动画完成时，事件被触发
+ * @event close - 下拉组件开始关闭时，事件被触发。可以通过调用 `event.preventDefault()` 阻止下拉组件关闭
+ * @event closed - 下拉组件关闭动画完成时，事件被触发
  *
- * @slot - dropdown 的内容
- * @slot trigger - 触发 dropdown 的元素，例如 [`<mdui-button>`](/docs/2/components/button) 元素
+ * @slot - 下拉组件的内容
+ * @slot trigger - 触发下拉组件的元素，例如 [`<mdui-button>`](/docs/2/components/button) 元素
  *
- * @csspart trigger - 触发 dropdown 的元素的容器，即 `trigger` slot 的容器
- * @csspart panel - dropdown 内容的容器
+ * @csspart trigger - 触发下拉组件的元素的容器，即 `trigger` slot 的容器
+ * @csspart panel - 下拉组件内容的容器
  *
- * @cssprop --z-index - 组件的 CSS 的 `z-index` 值
+ * @cssprop --z-index - 组件的 CSS `z-index` 值
  */
 let Dropdown = class Dropdown extends MduiElement {
     constructor() {
         super();
         /**
-         * dropdown 是否打开
+         * 是否打开下拉组件
          */
         this.open = false;
         /**
-         * 是否禁用 dropdown
+         * 是否禁用下拉组件
          */
         this.disabled = false;
         /**
-         * dropdown 的触发方式，支持传入多个值，用空格分隔。可选值为：
+         * 下拉组件的触发方式，支持多个值，用空格分隔。可选值包括：
          *
-         * * `click`：点击时触发
+         * * `click`：点击触发
          * * `hover`：鼠标悬浮触发
-         * * `focus`：聚焦时触发
-         * * `contextmenu`：鼠标右键点击、或触摸长按时触发
-         * * `manual`：使用了该值时，只能使用编程方式打开和关闭 dropdown，且不能再指定其他触发方式
+         * * `focus`：聚焦触发
+         * * `contextmenu`：鼠标右键点击、或触摸长按触发
+         * * `manual`：仅能通过编程方式打开和关闭下拉组件，不能再指定其他触发方式
          */
         this.trigger = 'click';
         /**
-         * dropdown 内容的位置。可选值为：
+         * 下拉组件内容的位置。可选值包括：
          *
          * * `auto`：自动判断位置
-         * * `top-start`：位于上方，且左对齐
-         * * `top`：位于上方，且居中对齐
-         * * `top-end`：位于上方，且右对齐
-         * * `bottom-start`：位于下方，且左对齐
-         * * `bottom`：位于下方，且居中对齐
-         * * `bottom-end`：位于下方，且右对齐
-         * * `left-start`：位于左侧，且顶部对齐
-         * * `left`：位于左侧，且居中对齐
-         * * `left-end`：位于左侧，且底部对齐
-         * * `right-start`：位于右侧，且顶部对齐
-         * * `right`：位于右侧，且居中对齐
-         * * `right-end`：位于右侧，且底部对齐
+         * * `top-start`：上方左对齐
+         * * `top`：上方居中
+         * * `top-end`：上方右对齐
+         * * `bottom-start`：下方左对齐
+         * * `bottom`：下方居中
+         * * `bottom-end`：下方右对齐
+         * * `left-start`：左侧顶部对齐
+         * * `left`：左侧居中
+         * * `left-end`：左侧底部对齐
+         * * `right-start`：右侧顶部对齐
+         * * `right`：右侧居中
+         * * `right-end`：右侧底部对齐
          */
         this.placement = 'auto';
         /**
-         * 在点击 [`<mdui-menu-item>`](/docs/2/components/menu#menu-item-api) 元素后，是否仍保持 dropdown 为打开状态
+         * 点击 [`<mdui-menu-item>`](/docs/2/components/menu#menu-item-api) 后，下拉组件是否保持打开状态
          */
         this.stayOpenOnClick = false;
         /**
-         * 通过 hover 触发 dropdown 打开时的延时，单位为毫秒
+         * 鼠标悬浮触发下拉组件打开的延时，单位为毫秒
          */
         this.openDelay = 150;
         /**
-         * 通过 hover 触发 dropdown 关闭时的延时，单位为毫秒
+         * 鼠标悬浮触发下拉组件关闭的延时，单位为毫秒
          */
         this.closeDelay = 150;
         /**
-         * 是否在触发 dropdown 时的光标所在的位置打开 dropdown。通常用于在打开鼠标右键菜单时使用
+         * 是否在触发下拉组件的光标位置打开下拉组件，常用于打开鼠标右键菜单
          */
         this.openOnPointer = false;
         this.panelRef = createRef();

package/components/fab/index.d.ts

@@ -16,19 +16,19 @@ import type { TemplateResult, CSSResultGroup } from 'lit';
  * @slot - 文本
  * @slot icon - 图标
  *
- * @csspart button - 内部的 `button` 或 `a` 元素
+ * @csspart button - 内部的 `<button>` 或 `<a>` 元素
  * @csspart label - 右侧的文本
  * @csspart icon - 左侧的图标
  * @csspart loading - 加载中状态的 `<mdui-circular-progress>` 元素
  *
- * @cssprop --shape-corner-small - `size="small"` 时，组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
- * @cssprop --shape-corner-normal - `size="normal"` 时，组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
- * @cssprop --shape-corner-large - `size="large"` 时，组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner-small - `size="small"` 时，组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner-normal - `size="normal"` 时，组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner-large - `size="large"` 时，组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
 export declare class Fab extends ButtonBase<FabEventMap> {
     static styles: CSSResultGroup;
     /**
-     * FAB 形状，此组件的不同形状之间只有颜色不一样。可选值为：
+     * FAB 的形状，此组件的不同形状之间只有颜色不一样。可选值包括：
      *
      * * `primary`：使用 Primary container 背景色
      * * `surface`：使用 Surface container high 背景色
@@ -37,7 +37,7 @@ export declare class Fab extends ButtonBase<FabEventMap> {
      */
     variant: /*使用 Primary container 背景色*/ 'primary' | /*使用 Surface container high 背景色*/ 'surface' | /*使用 Secondary container 背景色*/ 'secondary' | /*使用 Tertiary container 背景色*/ 'tertiary';
     /**
-     * FAB 大小。可选值为：
+     * FAB 的大小。可选值包括：
      * * `normal`：普通大小 FAB
      * * `small`：小型 FAB
      * * `large`：大型 FAB

package/components/fab/index.js

@@ -26,20 +26,20 @@ import { style } from './style.js';
  * @slot - 文本
  * @slot icon - 图标
  *
- * @csspart button - 内部的 `button` 或 `a` 元素
+ * @csspart button - 内部的 `<button>` 或 `<a>` 元素
  * @csspart label - 右侧的文本
  * @csspart icon - 左侧的图标
  * @csspart loading - 加载中状态的 `<mdui-circular-progress>` 元素
  *
- * @cssprop --shape-corner-small - `size="small"` 时，组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
- * @cssprop --shape-corner-normal - `size="normal"` 时，组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
- * @cssprop --shape-corner-large - `size="large"` 时，组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner-small - `size="small"` 时，组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner-normal - `size="normal"` 时，组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner-large - `size="large"` 时，组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
 let Fab = class Fab extends ButtonBase {
     constructor() {
         super(...arguments);
         /**
-         * FAB 形状，此组件的不同形状之间只有颜色不一样。可选值为：
+         * FAB 的形状，此组件的不同形状之间只有颜色不一样。可选值包括：
          *
          * * `primary`：使用 Primary container 背景色
          * * `surface`：使用 Surface container high 背景色
@@ -48,7 +48,7 @@ let Fab = class Fab extends ButtonBase {
          */
         this.variant = 'primary';
         /**
-         * FAB 大小。可选值为：
+         * FAB 的大小。可选值包括：
          * * `normal`：普通大小 FAB
          * * `small`：小型 FAB
          * * `large`：大型 FAB

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

@@ -12,19 +12,19 @@ import type { CSSResultGroup, TemplateResult } from 'lit';
  * </mdui-layout>
  * ```
  *
- * @slot - 可以是任意内容
+ * @slot - 可以包含任意内容
  */
 export declare class LayoutItem extends LayoutItemBase<LayoutItemEventMap> {
     static styles: CSSResultGroup;
     /**
-     * 该组件所处位置。可选值为：
+     * 组件的位置。可选值包括：
      *
-     * * `top`：位于上方
-     * * `bottom`：位于下方
-     * * `left`：位于左侧
-     * * `right`：位于右侧
+     * * `top`：上方
+     * * `bottom`：下方
+     * * `left`：左侧
+     * * `right`：右侧
      */
-    placement: /*位于上方*/ 'top' | /*位于下方*/ 'bottom' | /*位于左侧*/ 'left' | /*位于右侧*/ 'right';
+    placement: /*上方*/ 'top' | /*下方*/ 'bottom' | /*左侧*/ 'left' | /*右侧*/ 'right';
     protected get layoutPlacement(): LayoutPlacement;
     private onPlacementChange;
     protected render(): TemplateResult;

package/components/layout/layout-item.js

@@ -16,18 +16,18 @@ import { layoutItemStyle } from './layout-item-style.js';
  * </mdui-layout>
  * ```
  *
- * @slot - 可以是任意内容
+ * @slot - 可以包含任意内容
  */
 let LayoutItem = class LayoutItem extends LayoutItemBase {
     constructor() {
         super(...arguments);
         /**
-         * 该组件所处位置。可选值为：
+         * 组件的位置。可选值包括：
          *
-         * * `top`：位于上方
-         * * `bottom`：位于下方
-         * * `left`：位于左侧
-         * * `right`：位于右侧
+         * * `top`：上方
+         * * `bottom`：下方
+         * * `left`：左侧
+         * * `right`：右侧
          */
         this.placement = 'top';
     }

package/components/layout/layout-main.d.ts

@@ -1,7 +1,7 @@
 import { MduiElement } from '@mdui/shared/base/mdui-element.js';
 import type { CSSResultGroup, TemplateResult } from 'lit';
 /**
- * @summary 布局主内容组件
+ * @summary 布局主体内容组件
  *
  * ```html
  * <mdui-layout>
@@ -11,7 +11,7 @@ import type { CSSResultGroup, TemplateResult } from 'lit';
  * </mdui-layout>
  * ```
  *
- * @slot - 可以是任意内容
+ * @slot - 可以包含任意内容
  */
 export declare class LayoutMain extends MduiElement<LayoutMainEventMap> {
     static styles: CSSResultGroup;

package/components/layout/layout-main.js

@@ -7,7 +7,7 @@ import { componentStyle } from '@mdui/shared/lit-styles/component-style.js';
 import { getLayout } from './helper.js';
 import { layoutMainStyle } from './layout-main-style.js';
 /**
- * @summary 布局主内容组件
+ * @summary 布局主体内容组件
  *
  * ```html
  * <mdui-layout>
@@ -17,7 +17,7 @@ import { layoutMainStyle } from './layout-main-style.js';
  * </mdui-layout>
  * ```
  *
- * @slot - 可以是任意内容
+ * @slot - 可以包含任意内容
  */
 let LayoutMain = class LayoutMain extends MduiElement {
     connectedCallback() {

package/components/layout/layout.d.ts

@@ -11,12 +11,12 @@ import type { CSSResultGroup, TemplateResult } from 'lit';
  * </mdui-layout>
  * ```
  *
- * @slot - 可以是 [`<mdui-top-app-bar>`](/docs/2/components/top-app-bar)、[`<mdui-bottom-app-bar>`](/docs/2/components/bottom-app-bar)、[`<mdui-navigation-bar>`](/docs/2/components/navigation-bar)、[`<mdui-navigation-drawer>`](/docs/2/components/navigation-drawer)、[`<mdui-navigation-rail>`](/docs/2/components/navigation-rail)、`<mdui-layout-item>`、`<mdui-layout-main>` 元素
+ * @slot - 可以包含 [`<mdui-top-app-bar>`](/docs/2/components/top-app-bar)、[`<mdui-bottom-app-bar>`](/docs/2/components/bottom-app-bar)、[`<mdui-navigation-bar>`](/docs/2/components/navigation-bar)、[`<mdui-navigation-drawer>`](/docs/2/components/navigation-drawer)、[`<mdui-navigation-rail>`](/docs/2/components/navigation-rail)、`<mdui-layout-item>`、`<mdui-layout-main>` 元素
  */
 export declare class Layout extends MduiElement<LayoutEventMap> {
     static styles: CSSResultGroup;
     /**
-     * 把当前布局的高度设为 100%
+     * 设置当前布局的高度为 100%
      */
     fullHeight: boolean;
     protected render(): TemplateResult;

package/components/layout/layout.js

@@ -16,13 +16,13 @@ import { layoutStyle } from './layout-style.js';
  * </mdui-layout>
  * ```
  *
- * @slot - 可以是 [`<mdui-top-app-bar>`](/docs/2/components/top-app-bar)、[`<mdui-bottom-app-bar>`](/docs/2/components/bottom-app-bar)、[`<mdui-navigation-bar>`](/docs/2/components/navigation-bar)、[`<mdui-navigation-drawer>`](/docs/2/components/navigation-drawer)、[`<mdui-navigation-rail>`](/docs/2/components/navigation-rail)、`<mdui-layout-item>`、`<mdui-layout-main>` 元素
+ * @slot - 可以包含 [`<mdui-top-app-bar>`](/docs/2/components/top-app-bar)、[`<mdui-bottom-app-bar>`](/docs/2/components/bottom-app-bar)、[`<mdui-navigation-bar>`](/docs/2/components/navigation-bar)、[`<mdui-navigation-drawer>`](/docs/2/components/navigation-drawer)、[`<mdui-navigation-rail>`](/docs/2/components/navigation-rail)、`<mdui-layout-item>`、`<mdui-layout-main>` 元素
  */
 let Layout = class Layout extends MduiElement {
     constructor() {
         super(...arguments);
         /**
-         * 把当前布局的高度设为 100%
+         * 设置当前布局的高度为 100%
          */
         this.fullHeight = false;
     }

package/components/linear-progress/index.d.ts

@@ -7,18 +7,18 @@ import type { CSSResultGroup, TemplateResult } from 'lit';
  * <mdui-linear-progress></mdui-linear-progress>
  * ```
  *
- * @csspart indicator - 指示器
+ * @csspart indicator - 指示器部分
  *
- * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
 export declare class LinearProgress extends MduiElement<LinearProgressEventMap> {
     static styles: CSSResultGroup;
     /**
-     * 进度指示器的最大值，默认为 1
+     * 进度指示器的最大值。默认为 `1`
      */
     max: number;
     /**
-     * 进度指示器的当前值。若未指定该值，则为不确定状态
+     * 进度指示器的当前值。如果未指定该值，则处于不确定状态
      */
     value?: number;
     protected render(): TemplateResult;

package/components/linear-progress/index.js

@@ -13,15 +13,15 @@ import { style } from './style.js';
  * <mdui-linear-progress></mdui-linear-progress>
  * ```
  *
- * @csspart indicator - 指示器
+ * @csspart indicator - 指示器部分
  *
- * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
 let LinearProgress = class LinearProgress extends MduiElement {
     constructor() {
         super(...arguments);
         /**
-         * 进度指示器的最大值，默认为 1
+         * 进度指示器的最大值。默认为 `1`
          */
         this.max = 1;
     }