mdui 2.0.3 → 2.0.4

package/components/segmented-button/segmented-button-group.d.ts

@@ -4,7 +4,7 @@ import { MduiElement } from '@mdui/shared/base/mdui-element.js';
 import type { FormControl } from '@mdui/jq/shared/form.js';
 import type { CSSResultGroup, TemplateResult } from 'lit';
 /**
- * @summary 分段按钮组件。需与 `<mdui-segmented-button>` 组件配合使用
+ * @summary 分段按钮组件。需配合 `<mdui-segmented-button>` 组件使用
  *
  * ```html
  * <mdui-segmented-button-group>
@@ -19,7 +19,7 @@ import type { CSSResultGroup, TemplateResult } from 'lit';
  *
  * @slot - `<mdui-segmented-button>` 组件
  *
- * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
 export declare class SegmentedButtonGroup extends MduiElement<SegmentedButtonGroupEventMap> implements FormControl {
     static styles: CSSResultGroup;
@@ -28,12 +28,12 @@ export declare class SegmentedButtonGroup extends MduiElement<SegmentedButtonGro
      */
     fullWidth: boolean;
     /**
-     * 分段按钮的可选中状态。默认为不可选中。可选值为：
+     * 分段按钮的可选中状态，默认为不可选中。可选值包括：
      *
-     * * `single`：最多只能选中一个
-     * * `multiple`：可以选中多个
+     * * `single`：单选
+     * * `multiple`：多选
      */
-    selects?: /*最多只能选中一个*/ 'single' | /*可以选中多个*/ 'multiple';
+    selects?: /*单选*/ 'single' | /*多选*/ 'multiple';
     /**
      * 是否为禁用状态
      */
@@ -43,9 +43,9 @@ export declare class SegmentedButtonGroup extends MduiElement<SegmentedButtonGro
      */
     required: boolean;
     /**
-     * 关联的 `form` 元素。此属性值必须为同一页面中的一个 `<form>` 元素的 `id` 属性。
+     * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
      *
-     * 如果此属性未指定，则元素必须是 `form` 元素的后代。利用此属性，你可以将元素放置在页面中的任何位置，而不仅仅是作为 `form` 元素的后代。
+     * 如果未指定此属性，则该元素必须是 `<form>` 元素的子元素。通过此属性，你可以将元素放置在页面的任何位置，而不仅仅是 `<form>` 元素的子元素。
      */
     form?: string;
     /**
@@ -53,12 +53,9 @@ export declare class SegmentedButtonGroup extends MduiElement<SegmentedButtonGro
      */
     name: string;
     /**
-     * 当前选中的 `<mdui-segmented-button>` 的值
+     * 当前选中的 `<mdui-segmented-button>` 的值。
      *
-     * 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[];
     /**
@@ -75,11 +72,11 @@ export declare class SegmentedButtonGroup extends MduiElement<SegmentedButtonGro
     private readonly formController;
     private readonly definedController;
     /**
-     * 表单验证状态对象
+     * 表单验证状态对象，具体参见 [`ValidityState`](https://developer.mozilla.org/zh-CN/docs/Web/API/ValidityState)
      */
     get validity(): ValidityState;
     /**
-     * 表单验证的错误提示信息
+     * 如果表单验证未通过，此属性将包含提示信息。如果验证通过，此属性将为空字符串
      */
     get validationMessage(): string;
     private get items();
@@ -93,19 +90,19 @@ export declare class SegmentedButtonGroup extends MduiElement<SegmentedButtonGro
     private onInvalidChange;
     connectedCallback(): void;
     /**
-     * 检查表单字段是否验证通过。若未通过则返回 `false`，并触发 `invalid` 事件；若验证通过，则返回 `true`
+     * 检查表单字段是否通过验证。如果未通过，返回 `false` 并触发 `invalid` 事件；如果通过，返回 `true`
      */
     checkValidity(): boolean;
     /**
-     * 检查表单字段是否验证通过。若未通过则返回 `false`，并触发 `invalid` 事件；若验证通过，则返回 `true`。
+     * 检查表单字段是否通过验证。如果未通过，返回 `false` 并触发 `invalid` 事件；如果通过，返回 `true`。
      *
-     * 验证未通过时，还将在组件上显示未通过的提示。
+     * 如果验证未通过，还会在组件上显示验证失败的提示。
      */
     reportValidity(): boolean;
     /**
-     * 设置自定义的错误提示文本。只要文本不为空，则表示字段验证未通过
+     * 设置自定义的错误提示文本。只要这个文本不为空，就表示字段未通过验证
      *
-     * @param message 自定义的提示文本
+     * @param message 自定义的错误提示文本
      */
     setCustomValidity(message: string): void;
     protected render(): TemplateResult;

package/components/segmented-button/segmented-button-group.js

@@ -19,7 +19,7 @@ import { booleanConverter } from '@mdui/shared/helpers/decorator.js';
 import { componentStyle } from '@mdui/shared/lit-styles/component-style.js';
 import { segmentedButtonGroupStyle } from './segmented-button-group-style.js';
 /**
- * @summary 分段按钮组件。需与 `<mdui-segmented-button>` 组件配合使用
+ * @summary 分段按钮组件。需配合 `<mdui-segmented-button>` 组件使用
  *
  * ```html
  * <mdui-segmented-button-group>
@@ -34,7 +34,7 @@ import { segmentedButtonGroupStyle } from './segmented-button-group-style.js';
  *
  * @slot - `<mdui-segmented-button>` 组件
  *
- * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
 let SegmentedButtonGroup = class SegmentedButtonGroup extends MduiElement {
     constructor() {
@@ -56,12 +56,9 @@ let SegmentedButtonGroup = class SegmentedButtonGroup extends MduiElement {
          */
         this.name = '';
         /**
-         * 当前选中的 `<mdui-segmented-button>` 的值
+         * 当前选中的 `<mdui-segmented-button>` 的值。
          *
-         * 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 属性值实现。
          */
         this.value = '';
         /**
@@ -83,13 +80,13 @@ let SegmentedButtonGroup = class SegmentedButtonGroup extends MduiElement {
         });
     }
     /**
-     * 表单验证状态对象
+     * 表单验证状态对象，具体参见 [`ValidityState`](https://developer.mozilla.org/zh-CN/docs/Web/API/ValidityState)
      */
     get validity() {
         return this.inputRef.value.validity;
     }
     /**
-     * 表单验证的错误提示信息
+     * 如果表单验证未通过，此属性将包含提示信息。如果验证通过，此属性将为空字符串
      */
     get validationMessage() {
         return this.inputRef.value.validationMessage;
@@ -195,7 +192,7 @@ let SegmentedButtonGroup = class SegmentedButtonGroup extends MduiElement {
         this.defaultValue = this.selects === 'multiple' ? [] : '';
     }
     /**
-     * 检查表单字段是否验证通过。若未通过则返回 `false`，并触发 `invalid` 事件；若验证通过，则返回 `true`
+     * 检查表单字段是否通过验证。如果未通过，返回 `false` 并触发 `invalid` 事件；如果通过，返回 `true`
      */
     checkValidity() {
         const valid = this.inputRef.value.checkValidity();
@@ -209,9 +206,9 @@ let SegmentedButtonGroup = class SegmentedButtonGroup extends MduiElement {
         return valid;
     }
     /**
-     * 检查表单字段是否验证通过。若未通过则返回 `false`，并触发 `invalid` 事件；若验证通过，则返回 `true`。
+     * 检查表单字段是否通过验证。如果未通过，返回 `false` 并触发 `invalid` 事件；如果通过，返回 `true`。
      *
-     * 验证未通过时，还将在组件上显示未通过的提示。
+     * 如果验证未通过，还会在组件上显示验证失败的提示。
      */
     reportValidity() {
         this.invalid = !this.inputRef.value.reportValidity();
@@ -230,9 +227,9 @@ let SegmentedButtonGroup = class SegmentedButtonGroup extends MduiElement {
         return !this.invalid;
     }
     /**
-     * 设置自定义的错误提示文本。只要文本不为空，则表示字段验证未通过
+     * 设置自定义的错误提示文本。只要这个文本不为空，就表示字段未通过验证
      *
-     * @param message 自定义的提示文本
+     * @param message 自定义的错误提示文本
      */
     setCustomValidity(message) {
         this.inputRef.value.setCustomValidity(message);

package/components/segmented-button/segmented-button.d.ts

@@ -4,7 +4,7 @@ import '../icon.js';
 import type { Ripple } from '../ripple/index.js';
 import type { CSSResultGroup, TemplateResult } from 'lit';
 /**
- * @summary 分段按钮项组件。需与 `<mdui-segmented-button-group>` 组件配合使用
+ * @summary 分段按钮项组件。需配合 `<mdui-segmented-button-group>` 组件使用
  *
  * ```html
  * <mdui-segmented-button-group>
@@ -18,12 +18,12 @@ import type { CSSResultGroup, TemplateResult } from 'lit';
  * @event blur - 失去焦点时触发
  * @event invalid - 表单字段验证未通过时触发
  *
- * @slot - 分段按钮项的文本
+ * @slot - 分段按钮项的文本内容
  * @slot icon - 分段按钮项的左侧图标
  * @slot selected-icon - 选中状态的左侧图标
  * @slot end-icon - 分段按钮项的右侧图标
  *
- * @csspart button - 内部的 button 或 a 元素
+ * @csspart button - 内部的 `<button>` 或 `<a>` 元素
  * @csspart icon - 左侧的图标
  * @csspart selected-icon - 选中状态的左侧图标
  * @csspart end-icon - 右侧的图标

package/components/segmented-button/segmented-button.js

@@ -12,7 +12,7 @@ import { ButtonBase } from '../button/button-base.js';
 import '../icon.js';
 import { segmentedButtonStyle } from './segmented-button-style.js';
 /**
- * @summary 分段按钮项组件。需与 `<mdui-segmented-button-group>` 组件配合使用
+ * @summary 分段按钮项组件。需配合 `<mdui-segmented-button-group>` 组件使用
  *
  * ```html
  * <mdui-segmented-button-group>
@@ -26,12 +26,12 @@ import { segmentedButtonStyle } from './segmented-button-style.js';
  * @event blur - 失去焦点时触发
  * @event invalid - 表单字段验证未通过时触发
  *
- * @slot - 分段按钮项的文本
+ * @slot - 分段按钮项的文本内容
  * @slot icon - 分段按钮项的左侧图标
  * @slot selected-icon - 选中状态的左侧图标
  * @slot end-icon - 分段按钮项的右侧图标
  *
- * @csspart button - 内部的 button 或 a 元素
+ * @csspart button - 内部的 `<button>` 或 `<a>` 元素
  * @csspart icon - 左侧的图标
  * @csspart selected-icon - 选中状态的左侧图标
  * @csspart end-icon - 右侧的图标

package/components/select/index.d.ts

@@ -8,7 +8,7 @@ import type { FormControl } from '@mdui/jq/shared/form.js';
 import type { CSSResultGroup, TemplateResult } from 'lit';
 declare const Select_base: import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/focusable.js").FocusableMixinInterface> & typeof MduiElement;
 /**
- * @summary 选择框组件。需与 `<mdui-menu-item>` 组件配合使用
+ * @summary 选择框组件。需配合 `<mdui-menu-item>` 组件使用
  *
  * ```html
  * <mdui-select>
@@ -21,7 +21,7 @@ declare const Select_base: import("@open-wc/dedupe-mixin").Constructor<import("@
  * @event blur - 失去焦点时触发
  * @event change - 选中的值变更时触发
  * @event invalid - 表单字段验证未通过时触发
- * @event clear - 在点击由 `clearable` 属性生成的清空按钮时触发。可以通过调用 `event.preventDefault()` 阻止清空下拉框
+ * @event clear - 在点击由 `clearable` 属性生成的清空按钮时触发。可以通过调用 `event.preventDefault()` 阻止清空选择框
  *
  * @slot - `<mdui-menu-item>` 元素
  * @slot icon - 左侧图标
@@ -39,25 +39,24 @@ declare const Select_base: import("@open-wc/dedupe-mixin").Constructor<import("@
 export declare class Select extends Select_base<SelectEventMap> implements FormControl {
     static styles: CSSResultGroup;
     /**
-     * 下拉框形状。可选值为：
+     * 选择框的样式。可选值包括：
      *
-     * * `filled`：带背景色的下拉框，视觉效果较强
-     * * `outlined`：带边框的下拉框，视觉效果较弱
+     * * `filled`：带背景色的选择框，视觉效果较强
+     * * `outlined`：带边框的选择框，视觉效果较弱
      */
-    variant: /*带背景色的下拉框，视觉效果较强*/ 'filled' | /*带边框的下拉框，视觉效果较弱*/ 'outlined';
+    variant: /*带背景色的选择框，视觉效果较强*/ 'filled' | /*带边框的选择框，视觉效果较弱*/ 'outlined';
     /**
      * 是否支持多选
      */
     multiple: boolean;
     /**
-     * 下拉框名称，将与表单数据一起提交
+     * 选择框的名称，将与表单数据一起提交
      */
     name: string;
     /**
-     * 下拉框的值，将与表单数据一起提交。
+     * 选择框的值，将与表单数据一起提交。
      *
-     * 若未指定 `multiple` 属性，则该值为字符串；否则，该值为字符串数组。
-     * HTML 属性只能设置字符串值；如果需要设置数组值，请通过 JavaScript 设置
+     * 如果未指定 `multiple` 属性，该值为字符串；如果指定了 `multiple` 属性，该值为字符串数组。HTML 属性只能设置字符串值；如果需要设置数组值，请通过 JavaScript 属性设置。
      */
     value: string | string[];
     /**
@@ -69,61 +68,61 @@ export declare class Select extends Select_base<SelectEventMap> implements FormC
      */
     label?: string;
     /**
-     * 提示文本
+     * 占位符文本
      */
     placeholder?: string;
     /**
-     * 下拉框底部的帮助文本。也可以通过 `slot="helper"` 设置
+     * 选择框底部的帮助文本。也可以通过 `slot="helper"` 设置
      */
     helper?: string;
     /**
-     * 是否可清空下拉框
+     * 是否可以清空选择框
      */
     clearable: boolean;
     /**
-     * 可清空下拉框时，显示在下拉框右侧的清空按钮的 Material Icons 图标名。也可以通过 `slot="clear-icon"` 设置
+     * 当选择框可清空时，显示在选择框右侧的清空按钮的 Material Icons 图标名。也可以通过 `slot="clear-icon"` 设置
      */
     clearIcon?: string;
     /**
-     * 下拉框的方位。可选值为：
+     * 选择框的位置。可选值包括：
      *
-     * * `auto`：自动判断方位
+     * * `auto`：自动判断位置
      * * `bottom`：位于下方
      * * `top`：位于上方
      */
-    placement: /*自动判断方位*/ 'auto' | /*位于下方*/ 'bottom' | /*位于上方*/ 'top';
+    placement: /*自动判断位置*/ 'auto' | /*位于下方*/ 'bottom' | /*位于上方*/ 'top';
     /**
      * 文本是否右对齐
      */
     endAligned: boolean;
     /**
-     * 下拉框的前缀文本。仅在聚焦状态，或下拉框有值时才会显示。也可以通过 `slot="prefix"` 设置
+     * 选择框的前缀文本。仅在聚焦状态，或选择框有值时才会显示。也可以通过 `slot="prefix"` 设置
      */
     prefix: string;
     /**
-     * 下拉框的后缀文本。仅在聚焦状态，或下拉框有值时才会显示。也可以通过 `slot="suffix"` 设置
+     * 选择框的后缀文本。仅在聚焦状态，或选择框有值时才会显示。也可以通过 `slot="suffix"` 设置
      */
     suffix?: string;
     /**
-     * 下拉框的前缀图标的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
+     * 选择框的前缀图标的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
      */
     icon?: string;
     /**
-     * 下拉框的后缀图标的 Material Icons 图标名。也可以通过 `slot="end-icon"` 设置
+     * 选择框的后缀图标的 Material Icons 图标名。也可以通过 `slot="end-icon"` 设置
      */
     endIcon?: string;
     /**
-     * 表单字段验证失败时，显示在下拉框右侧的 Material Icons 图标名。也可以通过 `slot="error-icon"` 设置
+     * 表单字段验证失败时，显示在选择框右侧的 Material Icons 图标名。也可以通过 `slot="error-icon"` 设置
      */
     errorIcon?: string;
     /**
-     * 关联的 `form` 元素。此属性值必须为同一页面中的一个 `<form>` 元素的 `id` 属性。
+     * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
      *
-     * 如果此属性未指定，则元素必须是 `form` 元素的后代。利用此属性，你可以将元素放置在页面中的任何位置，而不仅仅是作为 `form` 元素的后代。
+     * 如果未指定此属性，则该元素必须是 `<form>` 元素的子元素。通过此属性，你可以将元素放置在页面的任何位置，而不仅仅是 `<form>` 元素的子元素。
      */
     form?: string;
     /**
-     * 是否为只读
+     * 是否为只读状态
      */
     readonly: boolean;
     /**
@@ -149,11 +148,11 @@ export declare class Select extends Select_base<SelectEventMap> implements FormC
     private readonly hasSlotController;
     private readonly definedController;
     /**
-     * 表单验证状态对象
+     * 表单验证状态对象，具体参见 [`ValidityState`](https://developer.mozilla.org/zh-CN/docs/Web/API/ValidityState)
      */
     get validity(): ValidityState;
     /**
-     * 表单验证的错误提示信息
+     * 如果表单验证未通过，此属性将包含提示信息。如果验证通过，此属性将为空字符串
      */
     get validationMessage(): string;
     protected get focusElement(): HTMLElement;
@@ -161,19 +160,19 @@ export declare class Select extends Select_base<SelectEventMap> implements FormC
     connectedCallback(): void;
     disconnectedCallback(): void;
     /**
-     * 检查表单字段是否验证通过。若未通过则返回 `false`，并触发 `invalid` 事件；若验证通过，则返回 `true`
+     * 检查表单字段是否通过验证。如果未通过，返回 `false` 并触发 `invalid` 事件；如果通过，返回 `true`
      */
     checkValidity(): boolean;
     /**
-     * 检查表单字段是否验证通过。若未通过则返回 `false`，并触发 `invalid` 事件；若验证通过，则返回 `true`。
+     * 检查表单字段是否通过验证。如果未通过，返回 `false` 并触发 `invalid` 事件；如果通过，返回 `true`。
      *
-     * 验证未通过时，还将在组件上显示未通过的提示。
+     * 如果验证未通过，还会在组件上显示验证失败的提示。
      */
     reportValidity(): boolean;
     /**
-     * 设置自定义的错误提示文本。只要文本不为空，则表示字段验证未通过
+     * 设置自定义的错误提示文本。只要这个文本不为空，就表示字段未通过验证
      *
-     * @param message 自定义的提示文本
+     * @param message 自定义的错误提示文本
      */
     setCustomValidity(message: string): void;
     protected firstUpdated(changedProperties: PropertyValues): void;

package/components/select/index.js

@@ -21,7 +21,7 @@ import '../menu.js';
 import '../text-field.js';
 import { style } from './style.js';
 /**
- * @summary 选择框组件。需与 `<mdui-menu-item>` 组件配合使用
+ * @summary 选择框组件。需配合 `<mdui-menu-item>` 组件使用
  *
  * ```html
  * <mdui-select>
@@ -34,7 +34,7 @@ import { style } from './style.js';
  * @event blur - 失去焦点时触发
  * @event change - 选中的值变更时触发
  * @event invalid - 表单字段验证未通过时触发
- * @event clear - 在点击由 `clearable` 属性生成的清空按钮时触发。可以通过调用 `event.preventDefault()` 阻止清空下拉框
+ * @event clear - 在点击由 `clearable` 属性生成的清空按钮时触发。可以通过调用 `event.preventDefault()` 阻止清空选择框
  *
  * @slot - `<mdui-menu-item>` 元素
  * @slot icon - 左侧图标
@@ -53,10 +53,10 @@ let Select = class Select extends FocusableMixin(MduiElement) {
     constructor() {
         super(...arguments);
         /**
-         * 下拉框形状。可选值为：
+         * 选择框的样式。可选值包括：
          *
-         * * `filled`：带背景色的下拉框，视觉效果较强
-         * * `outlined`：带边框的下拉框，视觉效果较弱
+         * * `filled`：带背景色的选择框，视觉效果较强
+         * * `outlined`：带边框的选择框，视觉效果较弱
          */
         this.variant = 'filled';
         /**
@@ -64,14 +64,13 @@ let Select = class Select extends FocusableMixin(MduiElement) {
          */
         this.multiple = false;
         /**
-         * 下拉框名称，将与表单数据一起提交
+         * 选择框的名称，将与表单数据一起提交
          */
         this.name = '';
         /**
-         * 下拉框的值，将与表单数据一起提交。
+         * 选择框的值，将与表单数据一起提交。
          *
-         * 若未指定 `multiple` 属性，则该值为字符串；否则，该值为字符串数组。
-         * HTML 属性只能设置字符串值；如果需要设置数组值，请通过 JavaScript 设置
+         * 如果未指定 `multiple` 属性，该值为字符串；如果指定了 `multiple` 属性，该值为字符串数组。HTML 属性只能设置字符串值；如果需要设置数组值，请通过 JavaScript 属性设置。
          */
         this.value = '';
         /**
@@ -79,13 +78,13 @@ let Select = class Select extends FocusableMixin(MduiElement) {
          */
         this.defaultValue = '';
         /**
-         * 是否可清空下拉框
+         * 是否可以清空选择框
          */
         this.clearable = false;
         /**
-         * 下拉框的方位。可选值为：
+         * 选择框的位置。可选值包括：
          *
-         * * `auto`：自动判断方位
+         * * `auto`：自动判断位置
          * * `bottom`：位于下方
          * * `top`：位于上方
          */
@@ -95,7 +94,7 @@ let Select = class Select extends FocusableMixin(MduiElement) {
          */
         this.endAligned = false;
         /**
-         * 是否为只读
+         * 是否为只读状态
          */
         this.readonly = false;
         /**
@@ -122,13 +121,13 @@ let Select = class Select extends FocusableMixin(MduiElement) {
         });
     }
     /**
-     * 表单验证状态对象
+     * 表单验证状态对象，具体参见 [`ValidityState`](https://developer.mozilla.org/zh-CN/docs/Web/API/ValidityState)
      */
     get validity() {
         return this.hiddenInputRef.value.validity;
     }
     /**
-     * 表单验证的错误提示信息
+     * 如果表单验证未通过，此属性将包含提示信息。如果验证通过，此属性将为空字符串
      */
     get validationMessage() {
         return this.hiddenInputRef.value.validationMessage;
@@ -159,7 +158,7 @@ let Select = class Select extends FocusableMixin(MduiElement) {
         this.observeResize?.unobserve();
     }
     /**
-     * 检查表单字段是否验证通过。若未通过则返回 `false`，并触发 `invalid` 事件；若验证通过，则返回 `true`
+     * 检查表单字段是否通过验证。如果未通过，返回 `false` 并触发 `invalid` 事件；如果通过，返回 `true`
      */
     checkValidity() {
         const valid = this.hiddenInputRef.value.checkValidity();
@@ -173,9 +172,9 @@ let Select = class Select extends FocusableMixin(MduiElement) {
         return valid;
     }
     /**
-     * 检查表单字段是否验证通过。若未通过则返回 `false`，并触发 `invalid` 事件；若验证通过，则返回 `true`。
+     * 检查表单字段是否通过验证。如果未通过，返回 `false` 并触发 `invalid` 事件；如果通过，返回 `true`。
      *
-     * 验证未通过时，还将在组件上显示未通过的提示。
+     * 如果验证未通过，还会在组件上显示验证失败的提示。
      */
     reportValidity() {
         this.invalid = !this.hiddenInputRef.value.reportValidity();
@@ -190,9 +189,9 @@ let Select = class Select extends FocusableMixin(MduiElement) {
         return !this.invalid;
     }
     /**
-     * 设置自定义的错误提示文本。只要文本不为空，则表示字段验证未通过
+     * 设置自定义的错误提示文本。只要这个文本不为空，就表示字段未通过验证
      *
-     * @param message 自定义的提示文本
+     * @param message 自定义的错误提示文本
      */
     setCustomValidity(message) {
         this.hiddenInputRef.value.setCustomValidity(message);

package/components/slider/index.d.ts

@@ -11,7 +11,7 @@ import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
  *
  * @event focus - 获得焦点时触发
  * @event blur - 失去焦点时触发
- * @event change - 在值发生了变更，且失去了焦点时，将触发该事件
+ * @event change - 在值发生变更，且失去焦点时，将触发该事件
  * @event input - 值变更时触发
  * @event invalid - 表单字段验证未通过时触发
  *

package/components/slider/index.js

@@ -21,7 +21,7 @@ import { style } from './style.js';
  *
  * @event focus - 获得焦点时触发
  * @event blur - 失去焦点时触发
- * @event change - 在值发生了变更，且失去了焦点时，将触发该事件
+ * @event change - 在值发生变更，且失去焦点时，将触发该事件
  * @event input - 值变更时触发
  * @event invalid - 表单字段验证未通过时触发
  *

package/components/slider/slider-base.d.ts

@@ -5,11 +5,11 @@ declare const SliderBase_base: import("@open-wc/dedupe-mixin").Constructor<impor
 export declare class SliderBase<E> extends SliderBase_base<E> {
     static styles: CSSResultGroup;
     /**
-     * 最小允许值，默认为 `0`
+     * 滑块的最小值，默认为 `0`
      */
     min: number;
     /**
-     * 最大允许值，默认为 `100`
+     * 滑块的最大值，默认为 `100`
      */
     max: number;
     /**
@@ -21,21 +21,21 @@ export declare class SliderBase<E> extends SliderBase_base<E> {
      */
     tickmarks: boolean;
     /**
-     * 是否不显示文本提示
+     * 是否隐藏文本提示
      */
     nolabel: boolean;
     /**
-     * 是否禁用
+     * 是否被禁用
      */
     disabled: boolean;
     /**
-     * 关联的 `form` 元素。此属性值必须为同一页面中的一个 `<form>` 元素的 `id` 属性。
+     * 关联的 `<form>` 元素。此属性值应为同一页面中的一个 `<form>` 元素的 `id`。
      *
-     * 如果此属性未指定，则元素必须是 `form` 元素的后代。利用此属性，你可以将元素放置在页面中的任何位置，而不仅仅是作为 `form` 元素的后代。
+     * 如果未指定此属性，则该元素必须是 `<form>` 元素的子元素。通过此属性，你可以将元素放置在页面的任何位置，而不仅仅是 `<form>` 元素的子元素。
      */
     form?: string;
     /**
-     * 滑块名称，将与表单数据一起提交
+     * 滑块的名称，该名称将与表单数据一起提交
      */
     name: string;
     /**
@@ -48,35 +48,35 @@ export declare class SliderBase<E> extends SliderBase_base<E> {
     protected readonly inputRef: Ref<HTMLInputElement>;
     protected readonly trackActiveRef: Ref<HTMLElement>;
     /**
-     * 表单验证状态对象
+     * 表单验证状态对象，具体参见 [`ValidityState`](https://developer.mozilla.org/zh-CN/docs/Web/API/ValidityState)
      */
     get validity(): ValidityState;
     /**
-     * 表单验证的错误提示信息
+     * 如果表单验证未通过，此属性将包含提示信息。如果验证通过，此属性将为空字符串
      */
     get validationMessage(): string;
     protected get rippleDisabled(): boolean;
     protected get focusElement(): HTMLElement;
     protected get focusDisabled(): boolean;
     /**
-     * 用于自定义标签的显示格式
+     * 用于自定义标签的显示格式的函数。函数参数为滑块的当前值，返回值为期望显示的文本。
      */
     labelFormatter: (value: number) => string;
     private onDisabledChange;
     /**
-     * 检查表单字段是否验证通过。若未通过则返回 `false`，并触发 `invalid` 事件；若验证通过，则返回 `true`
+     * 检查表单字段是否通过验证。如果未通过，返回 `false` 并触发 `invalid` 事件；如果通过，返回 `true`
      */
     checkValidity(): boolean;
     /**
-     * 检查表单字段是否验证通过。若未通过则返回 `false`，并触发 `invalid` 事件；若验证通过，则返回 `true`。
+     * 检查表单字段是否通过验证。如果未通过，返回 `false` 并触发 `invalid` 事件；如果通过，返回 `true`。
      *
-     * 验证未通过时，还将在组件上显示未通过的提示。
+     * 如果验证未通过，还会在组件上显示验证失败的提示。
      */
     reportValidity(): boolean;
     /**
-     * 设置自定义的错误提示文本。只要文本不为空，则表示字段验证未通过
+     * 设置自定义的错误提示文本。只要这个文本不为空，就表示字段未通过验证
      *
-     * @param message 自定义的提示文本
+     * @param message 自定义的错误提示文本
      */
     setCustomValidity(message: string): void;
     /**