From 1a98193485ce8663b29e07baf15ec599faf52a10 Mon Sep 17 00:00:00 2001 From: royce-ls Date: Thu, 3 Jul 2025 15:45:25 +0800 Subject: [PATCH] =?UTF-8?q?picker/=E4=BF=A1=E6=81=AF=E5=B1=95=E7=A4=BA/?= =?UTF-8?q?=E5=9B=BE=E7=89=87=E7=B1=BB=E7=BB=84=E4=BB=B6=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E8=A7=84=E8=8C=83=E6=80=A7=E6=95=B4=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: royce-ls Change-Id: I45128ab93793c14329f89c14cbd884cc0403c2e9 --- .../ts-basic-components-calendarpicker.md | 10 +++---- .../arkui-ts/ts-basic-components-datapanel.md | 8 +++--- .../ts-basic-components-datepicker.md | 10 +++---- .../arkui-ts/ts-basic-components-image.md | 20 ++++++------- .../ts-basic-components-loadingprogress.md | 10 +++---- .../ts-basic-components-patternlock.md | 26 +++++++++-------- .../arkui-ts/ts-basic-components-progress.md | 28 +++++++++---------- .../ts-basic-components-timepicker.md | 24 ++++++++-------- 8 files changed, 69 insertions(+), 67 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 f186a030c47..61e0b47266d 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 @@ -185,11 +185,11 @@ onChange(callback: Optional\>) **系统能力:** SystemCapability.ArkUI.ArkUI.Full -| 名称 | 说明 | -| ------ | ------------------------ | -| START | 设置选择器与入口组件左对齐的对齐方式。 | -| CENTER | 设置选择器与入口组件居中对齐的对齐方式。 | -| END | 设置选择器与入口组件右对齐的对齐方式。 | +| 名称 | 值 | 说明 | +| ------ | - | ------------------------ | +| START | 0 | 设置选择器与入口组件左对齐的对齐方式。 | +| CENTER | 1 | 设置选择器与入口组件居中对齐的对齐方式。 | +| END | 2 | 设置选择器与入口组件右对齐的对齐方式。 | ## DateRange19+对象说明 diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-datapanel.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-datapanel.md index 3620fe11917..19d8d4620f5 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-datapanel.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-datapanel.md @@ -51,10 +51,10 @@ DataPanel(options: DataPanelOptions) **系统能力:** SystemCapability.ArkUI.ArkUI.Full -| 名称 | 说明 | -| -------| ------------ | -| Line | 线型数据面板。 | -| Circle | 环形数据面板。 | +| 名称 | 值 | 说明 | +| -------| - | ------------ | +| Line | 0 | 线型数据面板。 | +| Circle | 1 | 环形数据面板。 | ## 属性 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 94040bdd21a..5645db06958 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 @@ -59,11 +59,11 @@ DatePicker(options?: DatePickerOptions) **系统能力:** SystemCapability.ArkUI.ArkUI.Full -| 名称 | 说明 | -| -------- | -------- | -| DATE | 日期列显示年、月、日三列。| -| YEAR_AND_MONTH | 日期列显示年、月二列。| -| MONTH_AND_DAY | 日期列显示月、日二列。
此模式下,如果月份从12月变化到1月,年份不增加1年;如果月份从1月变化到12月,年份不减少1年;年份始终在当前设置的年份。| +| 名称 | 值 | 说明 | +| -------- | - |-------- | +| DATE | 0 | 日期列显示年、月、日三列。| +| YEAR_AND_MONTH | 1 | 日期列显示年、月二列。| +| MONTH_AND_DAY | 2 | 日期列显示月、日二列。
此模式下,如果月份从12月变化到1月,年份不增加1年;如果月份从1月变化到12月,年份不减少1年;年份始终在当前设置的年份。| **异常情形说明:** 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 6a4c8bdea72..301506d439a 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 @@ -590,12 +590,12 @@ svg类型图源不支持该属性。 **系统能力:** SystemCapability.ArkUI.ArkUI.Full -| 名称 | 说明 | -| ------ | -------------------------- | -| None | 最近邻插值。 | -| High | Cubic插值,插值质量最高,可能会影响图片渲染的速度。 | -| Medium | MipMap插值。 | -| Low | 双线性插值。 | +| 名称 | 值 | 说明 | +| ------ | - | -------------------------- | +| None | 0 | 最近邻插值。 | +| Low | 1 | 双线性插值。 | +| Medium | 2 | MipMap插值。 | +| High | 3 | Cubic插值,插值质量最高,可能会影响图片渲染的速度。 | ## ImageRenderMode @@ -605,10 +605,10 @@ svg类型图源不支持该属性。 **系统能力:** SystemCapability.ArkUI.ArkUI.Full -| 名称 | 说明 | -| -------- | -------------- | -| Original | 原色渲染模式。 | -| Template | 黑白渲染模式。 | +| 名称 | 值 | 说明 | +| -------- | - | -------------- | +| Original | 0 | 原色渲染模式。 | +| Template | 1 | 黑白渲染模式。 | ## ResizableOptions11+ diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-loadingprogress.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-loadingprogress.md index a69d55753b4..3a08bc186f0 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-loadingprogress.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-loadingprogress.md @@ -111,11 +111,11 @@ contentModifier(modifier: ContentModifier\) **系统能力:** SystemCapability.ArkUI.ArkUI.Full -| 名称 | 说明 | -| ---------------------- | ---------------------------------------- | -| Default | 默认加载样式。API version 8及以后不支持设置。 | -| Circular | 环形加载样式。API version 8及以后不支持设置。 | -| Orbital | 彗星形加载样式。API version 8及以后默认为彗星形样式。 | +| 名称 | 值 | 说明 | +| ---------------------- | - | ---------------------------------------- | +| Default | 0 | 默认加载样式。API version 8及以后不支持设置。 | +| Circular | 1 | 环形加载样式。API version 8及以后不支持设置。 | +| Orbital | 2 | 彗星形加载样式。API version 8及以后默认为彗星形样式。 | ## 示例 diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-patternlock.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-patternlock.md index 833fb145945..4a62d2fd163 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-patternlock.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-patternlock.md @@ -185,18 +185,6 @@ activateCircleStyle(options: Optional\) | ------ | ------- | ---- | ------------------------------------------------------------ | | options | Optional\<[CircleStyleOptions](#circlestyleoptions12对象说明)\> | 是 | 宫格圆点在“激活”状态的背景圆环样式。| -### CircleStyleOptions12+对象说明 - -**系统能力:** SystemCapability.ArkUI.ArkUI.Full - - -| 名称 | 类型 | 必填 | 说明 | -| ------------- | ------- | ---- | -------- | -| color | [ResourceColor](ts-types.md#resourcecolor) | 否 | 背景圆环颜色。
默认值:与pathColor值相同。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | -| radius | [LengthMetrics](../js-apis-arkui-graphics.md#lengthmetrics12) | 否 | 背景圆环的半径。
默认值:circleRadius的11/6。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | -| enableWaveEffect | boolean | 否 | 波浪效果开关。
默认值:true,表示波浪效果开关打开,显示波浪效果。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | -| enableForeground15+ | boolean | 否 | 背景圆环是否在前景显示。
默认值:false,背景圆环不在前景显示。
**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。 | - ### skipUnselectedPoint15+ skipUnselectedPoint(skipped: boolean) @@ -245,6 +233,20 @@ onDotConnect(callback: [Callback](../../apis-basic-services-kit/js-apis-base.md# **系统能力:** SystemCapability.ArkUI.ArkUI.Full +## CircleStyleOptions12+对象说明 + +圆环样式的参数说明。 + +**系统能力:** SystemCapability.ArkUI.ArkUI.Full + + +| 名称 | 类型 | 必填 | 说明 | +| ------------- | ------- | ---- | -------- | +| color | [ResourceColor](ts-types.md#resourcecolor) | 否 | 背景圆环颜色。
默认值:与pathColor值相同。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | +| radius | [LengthMetrics](../js-apis-arkui-graphics.md#lengthmetrics12) | 否 | 背景圆环的半径。
默认值:circleRadius的11/6。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | +| enableWaveEffect | boolean | 否 | 波浪效果开关。
默认值:true,表示波浪效果开关打开,显示波浪效果。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | +| enableForeground15+ | boolean | 否 | 背景圆环是否在前景显示。
默认值:false,背景圆环不在前景显示。
**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。 | + ## PatternLockController PatternLock组件的控制器,用于重置组件状态。 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 5e78c9c8e64..64f7e244cd4 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 @@ -50,13 +50,13 @@ Progress(options: ProgressOptions) **系统能力:** SystemCapability.ArkUI.ArkUI.Full -| 名称 | 说明 | -| ---------------------- | ---------------------------------------- | -| Linear | 线性样式。从API version 9开始,高度大于宽度时,自适应垂直显示。 | -| Ring | 环形无刻度样式,环形圆环逐渐显示至完全填充效果。 | -| Eclipse | 圆形样式,显示类似月圆月缺的进度展示效果,从月牙逐渐变化至满月。 | -| ScaleRing | 环形有刻度样式,显示类似时钟刻度形式的进度展示效果。从API version 9开始,刻度外圈出现重叠的时候自动转换为环形无刻度进度条。 | -| Capsule | 胶囊样式,头尾两端圆弧处的进度展示效果与Eclipse相同,中段处的进度展示效果与Linear相同。高度大于宽度时,自适应垂直显示。 | +| 名称 | 值 | 说明 | +| ---------------------- | - | ---------------------------------------- | +| Linear | 0 | 线性样式。从API version 9开始,当高度大于宽度时,自适应垂直显示。 | +| Ring | 1 | 环形无刻度样式,环形圆环逐渐显示直至完全填充。 | +| Eclipse | 2 | 圆形样式,显示类似月圆月缺的进度展示效果,从月牙逐渐变化至满月。 | +| ScaleRing | 3 | 环形有刻度样式,显示类似时钟刻度形式的进度展示效果。从API version 9开始,刻度外圈出现重叠时自动转换为环形无刻度进度条。 | +| Capsule | 4 | 胶囊样式,头尾两端圆弧处的进度展示效果与Eclipse相同,中段的进度展示效果与Linear相同。当高度大于宽度时,自适应垂直显示。 | ## ProgressStyle枚举说明 @@ -66,13 +66,13 @@ Progress(options: ProgressOptions) **系统能力:** SystemCapability.ArkUI.ArkUI.Full -| 名称 | 说明 | -| --------- | ---------------------------------------- | -| Linear | 线性样式。 | -| Ring8+ | 环形无刻度样式,环形圆环逐渐显示至完全填充效果。 | -| Eclipse | 圆形样式,显示类似月圆月缺的进度展示效果,从月牙逐渐变化至满月。 | -| ScaleRing8+ | 环形有刻度样式,显示类似时钟刻度形式的进度展示效果。 | -| Capsule8+ | 胶囊样式,头尾两端圆弧处的进度展示效果与Eclipse相同,中段处的进度展示效果与Linear相同。高度大于宽度时,自适应垂直显示。 | +| 名称 | 值 | 说明 | +| --------- | - | ---------------------------------------- | +| Linear | 0 | 线性样式。 | +| Ring8+ | 1 | 环形圆环逐渐显示直至完全填充。 | +| Eclipse | 2 | 圆形样式,显示类似月圆月缺的进度展示效果,从月牙逐渐变化至满月。 | +| ScaleRing8+ | 3 | 环形有刻度样式,显示类似时钟刻度形式的进度展示效果。 | +| Capsule8+ | 4 | 胶囊样式,头尾两端圆弧处的进度展示效果与Eclipse相同,中段的进度展示效果与Linear相同。当高度大于宽度时,自适应垂直显示。 | ## ProgressStyleMap对象说明 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 ef8259af6f0..c69cefd2702 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 @@ -78,10 +78,10 @@ TimePicker(options?: TimePickerOptions) **系统能力:** SystemCapability.ArkUI.ArkUI.Full -| 名称 | 说明 | -| ------------------ | ------------------------ | -| HOUR_MINUTE | 按照小时和分钟显示。 | -| HOUR_MINUTE_SECOND | 按照小时、分钟和秒显示。 | +| 名称 | 值 | 说明 | +| ------------------ | - | ------------------------ | +| HOUR_MINUTE | 0 | 按照小时和分钟进行显示。 | +| HOUR_MINUTE_SECOND | 1 | 按照小时、分钟和秒进行显示。 | **异常情形说明:** @@ -112,7 +112,7 @@ useMilitaryTime(value: boolean) | 参数名 | 类型 | 必填 | 说明 | | ------ | ------- | ---- | ------------------------------------------ | -| value | boolean | 是 | 展示时间是否为24小时制。
默认值:false,false表示展示时间为12小时制,true表示展示时间为24小时制。| +| value | boolean | 是 | 展示时间是否为24小时制。
默认值:false
false表示展示时间为12小时制,true表示展示时间为24小时制。| ### useMilitaryTime18+ @@ -128,7 +128,7 @@ useMilitaryTime(isMilitaryTime: Optional\) | 参数名 | 类型 | 必填 | 说明 | | ------ | ------- | ---- | ------------------------------------------ | -| isMilitaryTime | [Optional](ts-universal-attributes-custom-property.md#optional12)\ | 是 | 展示时间是否为24小时制。
当isMilitaryTime的值为undefined时,默认值:false,表示展示时间为12小时制。| +| isMilitaryTime | [Optional](ts-universal-attributes-custom-property.md#optional12)\ | 是 | 展示时间是否为24小时制。
默认值:false。当isMilitaryTime的值为undefined时,使用默认值。
false表示展示时间为12小时制,true表示展示时间为24小时制。| ### disappearTextStyle10+ @@ -248,7 +248,7 @@ loop(value: boolean) | 参数名 | 类型 | 必填 | 说明 | | ------ | ------- | ---- | ------------------------------------------------------------ | -| value | boolean | 是 | 是否启用循环模式。
默认值:true,表示启用循环模式。 | +| value | boolean | 是 | 是否启用循环模式。
默认值:true
true表示启用循环模式,false表示不启用循环模式。 | ### loop18+ @@ -264,7 +264,7 @@ loop(isLoop: Optional\) | 参数名 | 类型 | 必填 | 说明 | | ------ | ------- | ---- | ------------------------------------------------------------ | -| isLoop | [Optional](ts-universal-attributes-custom-property.md#optional12)\ | 是 | 是否启用循环模式。
当isLoop的值为undefined时,默认值:true,表示启用循环模式。 | +| isLoop | [Optional](ts-universal-attributes-custom-property.md#optional12)\ | 是 | 是否启用循环模式。
默认值:true。当isLoop的值为undefined时,使用默认值。
true表示启用循环模式,false表示不启用循环模式。 | ### dateTimeOptions12+ @@ -309,8 +309,8 @@ enableHapticFeedback(enable: boolean) **系统能力:** SystemCapability.ArkUI.ArkUI.Full | 参数名 | 类型 | 必填 | 说明 | -| ------ | --------------------------------------------- |-----|-------------------------------------------------------------------------------------| -| enable | boolean | 是 | 是否支持触控反馈。
默认值:true,表示开启触控反馈。
设置为true后,其是否生效取决于系统的硬件支持情况。 | +| ------ | --------------------------------------------- | ----- |-------------------------------------------------------------------------------------| +| enable | boolean | 是 | 是否支持触控反馈。
默认值:true
true表示开启触控反馈,false表示不开启触控反馈。
设置为true后,其生效情况取决于系统的硬件是否支持。 | ### enableHapticFeedback18+ @@ -324,7 +324,7 @@ enableHapticFeedback(enable: Optional\) | 参数名 | 类型 | 必填 | 说明 | | ------ | --------------------------------------------- |-----|-------------------------------------------------------------------------------------| -| enable | [Optional](ts-universal-attributes-custom-property.md#optional12)\ | 是 | 是否支持触控反馈。
当enable的值为undefined时,默认值:true,true表示开启触控反馈,false表示不开启触控反馈。
设置为true后是否生效,还取决于系统的硬件是否支持。 | +| enable | [Optional](ts-universal-attributes-custom-property.md#optional12)\ | 是 | 是否支持触控反馈。
默认值:true。当enable的值为undefined时,使用默认值。
true表示开启触控反馈,false表示不开启触控反馈。
设置为true后,其生效情况取决于系统的硬件是否支持。 | > **说明:** > @@ -349,7 +349,7 @@ enableCascade(enable: boolean) | 参数名 | 类型 | 必填 | 说明 | | ------ | --------------------------------------------- |-----|-------------------------------------------------------------------------------------| -| enable | boolean | 是 | 在12小时制时,设置上午和下午的标识是否会根据小时数自动切换。
默认值:false,表示不开启自动切换。
设置为true时,仅在loop参数同时为true时生效。
| +| enable | boolean | 是 | 在设置12小时制时,上午和下午的标识是否会根据小时数自动切换。
默认值:false
false表示不自动切换,true表示自动切换。
设置为true时,仅在loop参数同时为true时生效。| ### digitalCrownSensitivity18+ digitalCrownSensitivity(sensitivity: Optional\) -- Gitee