diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-button.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-button.md index e607430bb8a874b2e0baeb0e1a32fc07efc1695d..62df4e8525c59dfeede695969429ae110624faa5 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-button.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-button.md @@ -73,11 +73,11 @@ Button() | 名称 | 类型 | 必填 | 说明 | | ------------------------- | --------------------------------------------- | ---- | ------------------------------------------------------------ | -| type | [ButtonType](#buttontype枚举说明) | 否 | 描述按钮显示样式。
默认值：ButtonType.ROUNDED_RECTANGLE。从API version 18及之后，ButtonType的默认值修改为ButtonType.ROUNDED_RECTANGLE。API version 18之前的版本，ButtonType的默认值为ButtonType.Capsule。
**卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| type | [ButtonType](#buttontype枚举说明) | 否 | 按钮显示样式。
默认值：ButtonType.ROUNDED_RECTANGLE
从API version 18及之后，ButtonType的默认值修改为ButtonType.ROUNDED_RECTANGLE。API version 18之前的版本，ButtonType的默认值为ButtonType.Capsule。
**卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | | stateEffect | boolean | 否 | 按钮按下时是否开启按压态显示效果，当设置为false时，按压效果关闭。设置为true时，开启按压效果。
默认值：true
**说明：**
当开启按压态显示效果，开发者设置状态样式时，会基于状态样式设置完成后的背景色再进行颜色叠加。
**卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -| buttonStyle11+ | [ButtonStyleMode](#buttonstylemode11枚举说明) | 否 | 描述按钮的样式和重要程度。
默认值：ButtonStyleMode.EMPHASIZED
**说明：**
按钮重要程度：强调按钮>普通按钮>文字按钮。
**卡片能力：** 从API version 11开始，该接口支持在ArkTS卡片中使用。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | -| controlSize11+ | [ControlSize](#controlsize11枚举说明) | 否 | 描述按钮的尺寸。
默认值：ControlSize.NORMAL
**卡片能力：** 从API version 11开始，该接口支持在ArkTS卡片中使用。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | -| role12+ | [ButtonRole](#buttonrole12枚举说明) | 否 | 描述按钮的角色。
默认值：ButtonRole.NORMAL
**卡片能力：** 从API version 12开始，该接口支持在ArkTS卡片中使用。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | +| buttonStyle11+ | [ButtonStyleMode](#buttonstylemode11枚举说明) | 否 | 按钮的样式和重要程度。
默认值：ButtonStyleMode.EMPHASIZED
**说明：**
按钮重要程度：强调按钮>普通按钮>文字按钮。
**卡片能力：** 从API version 11开始，该接口支持在ArkTS卡片中使用。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | +| controlSize11+ | [ControlSize](#controlsize11枚举说明) | 否 | 按钮的尺寸。
默认值：ControlSize.NORMAL
**卡片能力：** 从API version 11开始，该接口支持在ArkTS卡片中使用。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | +| role12+ | [ButtonRole](#buttonrole12枚举说明) | 否 | 按钮的角色。
默认值：ButtonRole.NORMAL
**卡片能力：** 从API version 12开始，该接口支持在ArkTS卡片中使用。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | ## 属性 @@ -171,7 +171,7 @@ fontStyle(value: FontStyle) | 参数名 | 类型 | 必填 | 说明 | | ------ | ------------------------------------------- | ---- | ----------------------------------------------- | -| value | [FontStyle](ts-appendix-enums.md#fontstyle) | 是 | 文本的字体样式。
默认值：FontStyle.Normal。 | +| value | [FontStyle](ts-appendix-enums.md#fontstyle) | 是 | 文本的字体样式。
默认值：FontStyle.Normal | ### stateEffect @@ -219,7 +219,7 @@ labelStyle(value: LabelStyle) 设置Button组件label文本和字体的样式。 -**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用 +**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full @@ -356,7 +356,7 @@ maxFontScale(scale: number | Resource) 按钮中文本的显示样式。 -**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用 +**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full @@ -366,7 +366,7 @@ maxFontScale(scale: number | Resource) | maxLines | number | 否 | 设置label文本的最大行数。如果指定此参数，则文本最多不会超过指定的行。如果有多余的文本，可以通过overflow来指定截断方式。
默认值：1 | | minFontSize | number \| [ResourceStr](ts-types.md#resourcestr) | 否 | 设置label文本最小显示字号。需配合maxFontSize以及maxLines或布局大小限制使用。
**说明：**
minFontSize小于或等于0时，自适应字号不生效。 | | maxFontSize | number \| [ResourceStr](ts-types.md#resourcestr) | 否 | 设置label文本最大显示字号。需配合minFontSize以及maxLines或布局大小限制使用。 | -| heightAdaptivePolicy | [TextHeightAdaptivePolicy](ts-appendix-enums.md#textheightadaptivepolicy10) | 否 | 设置label文本自适应高度的方式。
默认值：TextHeightAdaptivePolicy.MAX_LINES_FIRST。 | +| heightAdaptivePolicy | [TextHeightAdaptivePolicy](ts-appendix-enums.md#textheightadaptivepolicy10) | 否 | 设置label文本自适应高度的方式。
默认值：TextHeightAdaptivePolicy.MAX_LINES_FIRST | | font | [Font](ts-types.md#font) | 否 | 设置label文本字体样式。
默认值：默认值参考[Font](ts-types.md#font)。 | ## ButtonStyleMode11+枚举说明 @@ -753,7 +753,6 @@ struct ButtonExample { .type(ButtonType.ROUNDED_RECTANGLE) .backgroundColor(0x317aff) .width(180) - //.buttonStyle(ButtonStyleMode.NORMAL) .labelStyle({overflow:TextOverflow.Ellipsis, maxLines:3, minFontSize: 0}) } }.height(400).padding({ left: 35, right: 35, top: 35 }) diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-checkbox.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-checkbox.md index 34d9d1340deb6f683da48f3922c5a53858f22eb1..9c6092e6980078cffb2364b55864a5c471a494b6 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-checkbox.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-checkbox.md @@ -104,7 +104,7 @@ selectedColor(value: ResourceColor) | 参数名 | 类型 | 必填 | 说明 | | ------ | ------------------------------------------ | ---- | ------------------------------------------------------------ | -| value | [ResourceColor](ts-types.md#resourcecolor) | 是 | 多选框选中状态颜色。
默认值：$r('sys.color.ohos_id_color_text_primary_activated')。
异常值按照默认值处理。 | +| value | [ResourceColor](ts-types.md#resourcecolor) | 是 | 多选框选中状态颜色。
默认值：$r('sys.color.ohos_id_color_text_primary_activated')
异常值按照默认值处理。 | ### selectedColor18+ @@ -122,7 +122,7 @@ selectedColor(resColor: Optional\) | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | -| resColor | [Optional](ts-universal-attributes-custom-property.md#optional12)\<[ResourceColor](ts-types.md#resourcecolor)> | 是 | 多选框选中状态颜色。
当resColor的值为undefined时，默认值：$r('sys.color.ohos_id_color_text_primary_activated')。
异常值按照默认值处理。 | +| resColor | [Optional](ts-universal-attributes-custom-property.md#optional12)\<[ResourceColor](ts-types.md#resourcecolor)> | 是 | 多选框选中状态颜色。
当resColor的值为undefined时取默认值$r('sys.color.ohos_id_color_text_primary_activated')。
异常值按照默认值处理。 | ### unselectedColor10+ @@ -154,7 +154,7 @@ unselectedColor(resColor: Optional\) | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | -| resColor | [Optional](ts-universal-attributes-custom-property.md#optional12)\<[ResourceColor](ts-types.md#resourcecolor)> | 是 | 多选框非选中状态边框颜色。
当resColor的值为undefined时，默认值：$r('sys.color.ohos_id_color_switch_outline_off')| +| resColor | [Optional](ts-universal-attributes-custom-property.md#optional12)\<[ResourceColor](ts-types.md#resourcecolor)> | 是 | 多选框非选中状态边框颜色。
当resColor的值为undefined时取默认值$r('sys.color.ohos_id_color_switch_outline_off')| ### mark10+ diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-menu.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-menu.md index 239b424431f80c3f4cf866fa68b640dd28a3191f..4f9fe6943a8bf24e65d7fed50480aff9616eb085 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-menu.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-menu.md @@ -1,12 +1,12 @@ # 菜单控制 -为组件绑定弹出式菜单，菜单项以垂直列表形式显示，支持长按、点击或鼠标右键触发。 +为组件绑定弹出式菜单，支持长按、点击或鼠标右键来触发菜单的弹出，菜单项以垂直列表形式显示。 > **说明：** > > - 从API version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 > -> - CustomBuilder不支持使用bindMenu和bindContextMenu弹出菜单。多级菜单可使用[Menu组件](ts-basic-components-menu.md)。 +> - CustomBuilder不支持使用bindMenu和bindContextMenu弹出菜单。可以使用[Menu组件](ts-basic-components-menu.md)来实现多级菜单。 > > - 弹出菜单的文本内容不支持长按选中。 > @@ -28,7 +28,7 @@ bindMenu(content: Array10+ | [ResourceStr](ts-types.md#resourcestr) | 否 | 菜单项图标。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | | enabled11+ | boolean | 否 | 菜单条目是否可进行交互。
默认值：true，菜单条目可以进行交互。
值为false时，菜单条目不可以进行交互。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | | action | () => void | 是 | 点击菜单项的事件回调。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -| symbolIcon12+ | [SymbolGlyphModifier](ts-universal-attributes-attribute-modifier.md) | 否 | 设置菜单项图标。通过Modifier配置菜单项图标，配置该项时，原icon图标不显示。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | +| symbolIcon12+ | [SymbolGlyphModifier](ts-universal-attributes-attribute-modifier.md) | 否 | 设置菜单项图标。通过Modifier配置菜单项图标，若同时配置symbolIcon和icon的情况下，icon图标不显示。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | ## MenuOptions10+