From d9760f26a9078ccdccc2ca948fee521f2d6cb033 Mon Sep 17 00:00:00 2001 From: zhoulianhai Date: Sat, 21 Jun 2025 18:55:04 +0800 Subject: [PATCH] vod fix Signed-off-by: zhoulianhai --- .../arkui-ts/ts-basic-components-calendarpicker.md | 4 ++-- .../apis-arkui/arkui-ts/ts-basic-components-datepicker.md | 4 ++-- .../apis-arkui/arkui-ts/ts-basic-components-image.md | 2 +- .../arkui-ts/ts-basic-components-imageanimator.md | 2 +- .../apis-arkui/arkui-ts/ts-basic-components-progress.md | 4 ++-- .../apis-arkui/arkui-ts/ts-basic-components-textpicker.md | 6 ++++-- .../apis-arkui/arkui-ts/ts-basic-components-timepicker.md | 6 ++++-- .../reference/apis-arkui/arkui-ts/ts-container-badge.md | 2 +- 8 files changed, 17 insertions(+), 13 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-calendarpicker.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-calendarpicker.md index 98dd953c1cf..3a804aa29b8 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-calendarpicker.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-calendarpicker.md @@ -122,7 +122,7 @@ markToday(enabled: boolean) onChange(callback: Callback\) -选择日期时触发该事件。 +选择日期时触发该事件。不能通过双向绑定的状态变量触发。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 @@ -138,7 +138,7 @@ onChange(callback: Callback\) onChange(callback: Optional\>) -选择日期时触发该事件。与[onChange](#onchange)相比，callback参数新增了对undefined类型的支持。 +选择日期时触发该事件。不能通过双向绑定的状态变量触发。与[onChange](#onchange)相比，callback参数新增了对undefined类型的支持。 **原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-datepicker.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-datepicker.md index 6cc62cccd6b..5e0c30d3202 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-datepicker.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-datepicker.md @@ -292,7 +292,7 @@ canLoop(isLoop: Optional\) onChange(callback: (value: DatePickerResult) => void) -选择日期时触发该事件。 +选择日期时触发该事件。不能通过双向绑定的状态变量触发。 从API version 8 开始支持，从 API version 10 开始废弃，建议使用[onDateChange](#ondatechange10)。 @@ -308,7 +308,7 @@ onChange(callback: (value: DatePickerResult) => void) onDateChange(callback: (value: Date) => void) -选择日期时触发该事件。 +选择日期时触发该事件。不能通过双向绑定的状态变量触发。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-image.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-image.md index 8425449891c..3bfd9e5f5dd 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-image.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-image.md @@ -939,7 +939,7 @@ struct ImageExample1 { ### 示例2（下载与显示网络图片） -加载网络图片时，默认网络超时是5分钟，建议使用alt配置加载时的占位图。使用[HTTP](../../../network/http-request.md)工具包发送网络请求，接着将返回的数据解码为Image组件中的`PixelMap`，图片开发可参考[图片处理](../../../media/image/image-overview.md)。 +加载网络图片时，默认网络超时是5分钟，建议使用alt配置加载时的占位图。使用[HTTP](../../../network/http-request.md)工具包发送网络请求，接着将返回的数据解码为Image组件中的`PixelMap`，加载gif到`PixelMap`时，gif显示为静态图。图片开发可参考[图片处理](../../../media/image/image-overview.md)。 使用网络图片时，需要申请权限ohos.permission.INTERNET。具体申请方式请参考[声明权限](../../../security/AccessToken/declare-permissions.md)。 diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-imageanimator.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-imageanimator.md index 133c5145679..c7240190edd 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-imageanimator.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-imageanimator.md @@ -115,7 +115,7 @@ fixedSize(value: boolean) | 参数名 | 类型 | 必填 | 说明 | | ------ | ------- | ---- | ------------------------------------------------------------ | -| value | boolean | 是 | 设置图片大小是否固定为组件大小。 true表示图片大小与组件大小一致，此时设置图片的width 、height 、top 和left属性无效。false表示每一张图片的width 、height 、top和left属性都要单独设置。
默认值：true | +| value | boolean | 是 | 设置图片大小是否固定为组件大小。 true表示图片大小与组件大小一致，此时设置图片的width 、height 、top 和left属性无效。false表示每一张图片的width 、height 、top和left属性都要单独设置。图片宽高与组件宽高不一致时，图片不会被拉伸。
默认值：true | ### preDecode(deprecated) diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-progress.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-progress.md index 77adf5664d0..7e05744d5fb 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-progress.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-progress.md @@ -72,7 +72,7 @@ Progress(options: ProgressOptions) | Ring8+ | 环形无刻度样式，环形圆环逐渐显示至完全填充效果。 | | Eclipse | 圆形样式，显示类似月圆月缺的进度展示效果，从月牙逐渐变化至满月。 | | ScaleRing8+ | 环形有刻度样式，显示类似时钟刻度形式的进度展示效果。 | -| Capsule8+ | 胶囊样式，头尾两端圆弧处的进度展示效果与Eclipse相同；中段处的进度展示效果与Linear相同。高度大于宽度的时候自适应垂直显示。 | +| Capsule8+ | 胶囊样式，头尾两端圆弧处的进度展示效果与Eclipse相同；中段处的进度展示效果与Linear相同。高度大于宽度时，自适应垂直显示。 | ## ProgressStyleMap对象说明 @@ -283,7 +283,7 @@ privacySensitive(isPrivacySensitiveMode: Optional\) | 名称 | 类型 | 必填 | 说明 | | ------------ | ---------------------------- | ---- | ------------------------------------------------------------------------------------------ | | strokeWidth | [Length](ts-types.md#length) | 否 | 设置进度条宽度（不支持百分比设置）。
默认值：4.0vp | -| scaleCount | number | 否 | 设置环形进度条总刻度数。
默认值：120
取值范围：[2, min(width, height)/scaleWidth/2/π]，超出取值范围时，样式显示为环形无刻度进度条。 | +| scaleCount | number | 否 | 设置环形进度条总刻度数。
默认值：120
取值范围：[2, min(width, height)/scaleWidth/2/π]，超出取值范围时，样式显示为环形无刻度进度条。默认情况下宽高最小为77vp。 | | scaleWidth | [Length](ts-types.md#length) | 否 | 设置环形进度条刻度粗细（不支持百分比设置）。刻度粗细大于进度条宽度时，为系统默认粗细。
默认值：2.0vp | ## EclipseStyleOptions10+ diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-textpicker.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-textpicker.md index f22acddf264..5e57c813089 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-textpicker.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-textpicker.md @@ -435,7 +435,9 @@ selectedBackgroundStyle(style: Optional\) onChange(callback: (value: string \| string[], index: number \| number[]) => void) -滑动TextPicker文本内容后，选项归位至选中项位置时，触发该回调。当显示文本或图片加文本列表时，value值为选中项中的文本值，当显示图片列表时，value值为空。 +滑动TextPicker文本内容后，选项归位至选中项位置时，触发该回调。不能通过双向绑定的状态变量触发。当显示文本或图片加文本列表时，value值为选中项中的文本值，当显示图片列表时，value值为空。 + +回调会在滑动动画结束后触发，如果需要快速获取索引值变化，建议使用[onEnterSelectedArea](#onenterselectedarea18)接口。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 @@ -452,7 +454,7 @@ onChange(callback: (value: string \| string[], index:&n onChange(callback: Optional\) -滑动TextPicker文本内容后，选项归位至选中项位置时，触发该回调。与[onChange](#onchange)相比，callback参数新增了对undefined类型的支持。 +滑动TextPicker文本内容后，选项归位至选中项位置时，触发该回调。不能通过双向绑定的状态变量触发。与[onChange](#onchange)相比，callback参数新增了对undefined类型的支持。 回调会在滑动动画结束后触发，如果需要快速获取索引值变化，建议使用[onEnterSelectedArea](#onenterselectedarea18)接口。 diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-timepicker.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-timepicker.md index bdaf9deab37..4db1cf79ba0 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-timepicker.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-timepicker.md @@ -364,7 +364,9 @@ digitalCrownSensitivity(sensitivity: Optional\) onChange(callback: (value: TimePickerResult ) => void) -滑动TimePicker后，时间选项归位至选中项位置时，触发该回调。 +滑动TimePicker后，时间选项归位至选中项位置时，触发该回调。不能通过双向绑定的状态变量触发。 + +回调会在滑动动画结束后触发，如果需要快速获取索引值变化，建议使用[onEnterSelectedArea](#onenterselectedarea18)接口。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 @@ -380,7 +382,7 @@ onChange(callback: (value: TimePickerResult ) => void) onChange(callback: Optional\) -滑动TimePicker后，时间选项归位至选中项位置时，触发该回调。与[onChange](#onchange)相比，callback参数新增了对undefined类型的支持。 +滑动TimePicker后，时间选项归位至选中项位置时，触发该回调。不能通过双向绑定的状态变量触发。与[onChange](#onchange)相比，callback参数新增了对undefined类型的支持。 回调会在滑动动画结束后触发，如果需要快速获取索引值变化，建议使用[onEnterSelectedArea](#onenterselectedarea18)接口。 diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-badge.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-badge.md index d865ec93845..f56a158b11e 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-badge.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-badge.md @@ -128,7 +128,7 @@ BadgeParamWithString继承自[BadgeParam](#badgeparam对象说明)，具有Badge | fontSize | number \| [ResourceStr](ts-types.md#resourcestr) | 否 | 文本大小。string类型仅支持number类型取值的字符串形式，可以附带单位，例如"10"、"10fp"。
默认值：10
单位：fp
取值范围：大于0；取值为0时不显示文本，取值小于0时取默认值。
**说明：**
不支持设置百分比，当设置为百分比时，按照默认值处理。从API version 20开始，支持ResourceStr类型。
**卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。 | | badgeSize | number \| [ResourceStr](ts-types.md#resourcestr) | 否 | Badge的大小。string类型支持number类型取值的字符串形式，可以附带单位，例如"16"、"16vp"。
默认值：16
单位：vp
取值范围：大于0；取值为0时不显示Badge，取值小于0时取默认值。
**说明：**
不支持设置百分比，当设置为百分比时，按照默认值处理。从API version 20开始，支持ResourceStr类型。
**卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。 | | badgeColor | [ResourceColor](ts-types.md#resourcecolor) | 否 | Badge的颜色。
默认值：Color.Red
**卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。 | -| fontWeight10+ | number \|[FontWeight](ts-appendix-enums.md#fontweight) \| [ResourceStr](ts-types.md#resourcestr) | 否 | 设置文本的字体粗细。number类型取值范围：[100, 900]，取值间隔为100。默认值为400，取值越大，字体越粗。string类型仅支持number类型取值的字符串形式，例如"400"，以及"bold"、"bolder"、"lighter"、"regular"、"medium"，分别对应FontWeight中相应的枚举值。
默认值：FontWeight.Normal
**说明：**
不支持设置百分比，当设置为百分比时，按照默认值处理。从API version 20开始，支持ResourceStr类型。 | +| fontWeight10+ | number \|[FontWeight](ts-appendix-enums.md#fontweight) \| [ResourceStr](ts-types.md#resourcestr) | 否 | 设置文本的字体粗细。number类型取值范围：[100, 900]，取值间隔为100。取值越大，字体越粗。number类型取值范围外的默认值为400。string类型仅支持number类型取值的字符串形式，例如"400"，以及"bold"、"bolder"、"lighter"、"regular"、"medium"，分别对应FontWeight中相应的枚举值。
默认值：FontWeight.Normal
**说明：**
不支持设置百分比，当设置为百分比时，按照默认值处理。从API version 20开始，支持ResourceStr类型。 | | borderColor10+ | [ResourceColor](ts-types.md#resourcecolor) | 否 | 底板描边颜色。
默认值：Color.Red | | borderWidth10+ | [Length](ts-types.md#length) | 否 | 底板描边粗细。
默认值：1
单位：vp
**说明：**
不支持设置百分比，当设置为百分比时，按照默认值处理。 | -- Gitee