From 59c602db7bbee84f66f30825ac7ca478ba4d927d Mon Sep 17 00:00:00 2001 From: liuyanzhi Date: Fri, 27 Jun 2025 08:41:38 +0800 Subject: [PATCH] fix Signed-off-by: liuyanzhi --- .../arkui-ts/ts-container-alphabet-indexer.md | 4 ++ .../arkui-ts/ts-container-sidebarcontainer.md | 4 ++ .../arkui-ts/ts-container-tabcontent.md | 4 ++ .../arkui-ts/ts-particle-animation.md | 64 ++++++++++++------- 4 files changed, 53 insertions(+), 23 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-alphabet-indexer.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-alphabet-indexer.md index fd755f3d787..abb5fa0bb13 100755 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-alphabet-indexer.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-alphabet-indexer.md @@ -32,6 +32,10 @@ AlphabetIndexer(options: AlphabetIndexerOptions) 用于设置索引条参数。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 + **原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-sidebarcontainer.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-sidebarcontainer.md index 9c1a6a6e2aa..eebd4269cec 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-sidebarcontainer.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-sidebarcontainer.md @@ -309,6 +309,10 @@ minContentWidth优先于侧边栏的maxSideBarWidth与sideBarWidth属性，minCo 设置侧边栏控制按钮的图标。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 + **原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-tabcontent.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-tabcontent.md index c3c2f9e5b36..41b46ab317f 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-tabcontent.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-tabcontent.md @@ -99,6 +99,10 @@ tabBar(content: ComponentContent | SubTabBarStyle | BottomTabBarStyle | string | 设置页签内的图片和文字内容。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 + **原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-particle-animation.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-particle-animation.md index 688917ae760..0579e658a3a 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-particle-animation.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-particle-animation.md @@ -459,13 +459,15 @@ interface Particles< 粒子动画的集合。 -**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full | 名称 | 类型 | 必填 | 说明 | | ------ | ------------------------------ | ---- | ----------------------------------------------------------------------------------------------------------------------- | -| particles | Array<
  ParticleOptions<
    PARTICLE,
    COLOR_UPDATER,
    OPACITY_UPDATER,
    SCALE_UPDATER,
    ACC_SPEED_UPDATER,
    ACC_ANGLE_UPDATER,
    SPIN_UPDATER
  >
> | 是 | 粒子动画的集合。每一个的粒子动画（[ParticleOptions](#particleoptions)）包含粒子发射，同时可配置粒子的颜色、透明度、大小、速度、加速度与旋转速度，旋转速度，详见[ParticleOptions](#particleoptions)属性说明。 | +| particles10+ | Array<
  ParticleOptions<
    PARTICLE,
    COLOR_UPDATER,
    OPACITY_UPDATER,
    SCALE_UPDATER,
    ACC_SPEED_UPDATER,
    ACC_ANGLE_UPDATER,
    SPIN_UPDATER
  >
> | 是 | 粒子动画的集合。每一个的粒子动画（[ParticleOptions](#particleoptions)）包含粒子发射，同时可配置粒子的颜色、透明度、大小、速度、加速度与旋转速度，旋转速度，详见[ParticleOptions](#particleoptions)属性说明。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| ## VelocityOptions18+ @@ -478,14 +480,16 @@ declare interface VelocityOptions { 粒子速度配置。 -**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full | 名称 | 类型 | 必填 | 说明 | | ------ | ------------------------------ | ---- | ----------------------------------------------------------------------------------------------------------------------- | -| speed | [ParticleTuple](#particletuple18) | 是 | 表示速度大小。
默认值：{range:[0.0,0.0]} | -| angle | [ParticleTuple](#particletuple18) | 是 | 表示速度的方向（单位为角度）。以元素几何中心为坐标原点，水平方向为X轴，正数表示顺时针方向旋转角度。
默认值：{range:[0.0,0.0]} | +| speed10+ | [ParticleTuple](#particletuple18) | 是 | 表示速度大小。
默认值：{range:[0.0,0.0]}
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| angle10+ | [ParticleTuple](#particletuple18) | 是 | 表示速度的方向（单位为角度）。以元素几何中心为坐标原点，水平方向为X轴，正数表示顺时针方向旋转角度。
默认值：{range:[0.0,0.0]}
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| ## AccelerationOptions18+ @@ -501,14 +505,16 @@ declare interface AccelerationOptions< 粒子加速度配置。 -**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full | 名称 | 类型 | 必填 | 说明 | | ------ | --------------------------------------------------- | ---- | --------------------------------------------------------- | -| speed | [ParticlePropertyOptions](#particlepropertyoptions) | 否 | 表示加速度大小。
默认值：{range:[0.0,0.0]} | -| angle | [ParticlePropertyOptions](#particlepropertyoptions) | 否 | 表示加速度方向（单位为角度）。
默认值：{range:[0.0,0.0]} | +| speed10+ | [ParticlePropertyOptions](#particlepropertyoptions) | 否 | 表示加速度大小。
默认值：{range:[0.0,0.0]}
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| angle10+ | [ParticlePropertyOptions](#particlepropertyoptions) | 否 | 表示加速度方向（单位为角度）。
默认值：{range:[0.0,0.0]}
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| ## EmitterParticleOptions18+ @@ -524,17 +530,19 @@ interface EmitterParticleOptions { 粒子配置。 -**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full | 名称 | 类型 | 必填 | 说明 | | ------ | --------------------------------------------------- | ---- | --------------------------------------------------------- | -| type | [PARTICLE](#particletype) | 是 | 表示粒子类型，可以选择图片或者是点。 | -| config | [ParticleConfigs](#particleconfigs)[PARTICLE] | 是 | 表示对应类型的配置。
config类型和type值有关联：
1、如果type为ParticleType.POINT，则config类型为[PointParticleParameters](#pointparticleparameters) 。
2、如果type为ParticleType.IMAGE，则config类型为[ImageParticleParameters](#imageparticleparameters) 。 | -| count | number | 是 | 表示发射的粒子总数，count取值>=-1,当count为-1表示粒子总数无限大。 | -| lifetime | number | 否 | 表示单个粒子的生命周期，默认值1000（即1000ms，1s），lifetime>=-1。当lifetime为-1表示粒子生命周期无限大。当lifetime<-1，取默认值。
**说明：** 如果不需要动画一直播放，建议不要将生命周期设置为-1，可能对性能造成较大影响。 | -| lifetimeRange | number | 否 | 表示粒子生命周期取值范围，设置lifetimeRange后粒子的生命周期为 [lifetime-lifetimeRange,lifeTime+lifetimeRange]中间的一个随机整数。lifetimeRange 默认值为0，取值范围为0到正无穷。设置为负值时取默认值。 | +| type10+ | [PARTICLE](#particletype) | 是 | 表示粒子类型，可以选择图片或者是点。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| config10+ | [ParticleConfigs](#particleconfigs)[PARTICLE] | 是 | 表示对应类型的配置。
config类型和type值有关联：
1、如果type为ParticleType.POINT，则config类型为[PointParticleParameters](#pointparticleparameters) 。
2、如果type为ParticleType.IMAGE，则config类型为[ImageParticleParameters](#imageparticleparameters) 。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| count10+ | number | 是 | 表示发射的粒子总数，count取值>=-1,当count为-1表示粒子总数无限大。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| lifetime10+ | number | 否 | 表示单个粒子的生命周期，默认值1000（即1000ms，1s），lifetime>=-1。当lifetime为-1表示粒子生命周期无限大。当lifetime<-1，取默认值。
**说明：** 如果不需要动画一直播放，建议不要将生命周期设置为-1，可能对性能造成较大影响。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| lifetimeRange12+ | number | 否 | 表示粒子生命周期取值范围，设置lifetimeRange后粒子的生命周期为 [lifetime-lifetimeRange,lifeTime+lifetimeRange]中间的一个随机整数。lifetimeRange 默认值为0，取值范围为0到正无穷。设置为负值时取默认值。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。| ## ParticleUpdaterOptions18+ @@ -547,12 +555,16 @@ interface ParticleUpdaterOptions { 颜色属性变化配置。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 + **系统能力：** SystemCapability.ArkUI.ArkUI.Full | 名称 | 类型 | 必填 | 说明 | | ------ | --------------------------------------------------- | ---- | --------------------------------------------------------- | -| type | [UPDATER](#particleupdater) | 是 | 表示颜色属性变化类型。
默认值：type默认为ParticleUpdater.NONE。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -| config | [ParticlePropertyUpdaterConfigs](#particlepropertyupdaterconfigs)<[TYPE](#particleupdater)[[UPDATER](#particleupdater)] | 是 | 属性变化配置。属性变化类型type有三类：
1、当type为ParticleUpdater.NONE，表示无变化，则config类型为[ParticlePropertyUpdaterConfigs](#particlepropertyupdaterconfigs)[ParticleUpdater.NONE]。
2、当type为ParticleUpdater.RANDOM，表示变化类型为随机变化，则config类型为[ParticlePropertyUpdaterConfigs](#particlepropertyupdaterconfigs)[ParticleUpdater.RANDOM]。
3、当type为ParticleUpdater.CURVE，表示变化类型为曲线变化，则config类型为[ParticlePropertyUpdaterConfigs](#particlepropertyupdaterconfigs)[ParticleUpdater.CURVE]。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| type10+ | [UPDATER](#particleupdater) | 是 | 表示颜色属性变化类型。
默认值：type默认为ParticleUpdater.NONE。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| config10+ | [ParticlePropertyUpdaterConfigs](#particlepropertyupdaterconfigs)<[TYPE](#particleupdater)[[UPDATER](#particleupdater)] | 是 | 属性变化配置。属性变化类型type有三类：
1、当type为ParticleUpdater.NONE，表示无变化，则config类型为[ParticlePropertyUpdaterConfigs](#particlepropertyupdaterconfigs)[ParticleUpdater.NONE]。
2、当type为ParticleUpdater.RANDOM，表示变化类型为随机变化，则config类型为[ParticlePropertyUpdaterConfigs](#particlepropertyupdaterconfigs)[ParticleUpdater.RANDOM]。
3、当type为ParticleUpdater.CURVE，表示变化类型为曲线变化，则config类型为[ParticlePropertyUpdaterConfigs](#particlepropertyupdaterconfigs)[ParticleUpdater.CURVE]。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | ## ParticleColorUpdaterOptions18+ @@ -565,14 +577,16 @@ interface ParticleColorUpdaterOptions { 颜色属性变化配置。 -**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full | 名称 | 类型 | 必填 | 说明 | | ------ | --------------------------------------------------- | ---- | --------------------------------------------------------- | -| type | [UPDATER](#particleupdater) | 是 | 表示颜色属性变化类型。
默认值：type默认为 ParticleUpdater.NONE。 | -| config | [ParticleColorPropertyUpdaterConfigs](#particlecolorpropertyupdaterconfigs)[[UPDATER](#particleupdater)] | 是 | 颜色属性变化类型type有三类：
1、当type为ParticleUpdater.NONE，表示无变化，则config类型为[ParticleColorPropertyUpdaterConfigs](#particlecolorpropertyupdaterconfigs)[ParticleUpdater.NONE]。
2、type为ParticleUpdater.RANDOM，表示随机变化，则config类型为[ParticleColorPropertyUpdaterConfigs](#particlecolorpropertyupdaterconfigs)[ParticleUpdater.RANDOM]。
3、type为ParticleUpdater.CURVE,表示按动画曲线变化，则config类型为[ParticleColorPropertyUpdaterConfigs](#particlecolorpropertyupdaterconfigs)[ParticleUpdater.CURVE]。
**说明**：
当type为ParticleUpdater.RANDOM或者ParticleUpdater.CURVE时，updater中颜色配置的优先级高于range中的颜色配置。在updater配置的动画时间周期内，以updater中的颜色配置来变化；在updater配置的动画时间周期前，以range中的颜色配置来变化。 | +| type10+ | [UPDATER](#particleupdater) | 是 | 表示颜色属性变化类型。
默认值：type默认为 ParticleUpdater.NONE。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| config10+ | [ParticleColorPropertyUpdaterConfigs](#particlecolorpropertyupdaterconfigs)[[UPDATER](#particleupdater)] | 是 | 颜色属性变化类型type有三类：
1、当type为ParticleUpdater.NONE，表示无变化，则config类型为[ParticleColorPropertyUpdaterConfigs](#particlecolorpropertyupdaterconfigs)[ParticleUpdater.NONE]。
2、type为ParticleUpdater.RANDOM，表示随机变化，则config类型为[ParticleColorPropertyUpdaterConfigs](#particlecolorpropertyupdaterconfigs)[ParticleUpdater.RANDOM]。
3、type为ParticleUpdater.CURVE,表示按动画曲线变化，则config类型为[ParticleColorPropertyUpdaterConfigs](#particlecolorpropertyupdaterconfigs)[ParticleUpdater.CURVE]。
**说明**：
当type为ParticleUpdater.RANDOM或者ParticleUpdater.CURVE时，updater中颜色配置的优先级高于range中的颜色配置。在updater配置的动画时间周期内，以updater中的颜色配置来变化；在updater配置的动画时间周期前，以range中的颜色配置来变化。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | ## ParticleColorOptions18+ @@ -587,14 +601,18 @@ interface ParticleColorOptions { 颜色变化方式为均匀变化的时候，在区间内随机生成一个差值。r、g、b、a四个颜色通道每秒分别使用差值叠加当前颜色值，生成目标颜色值。实现颜色随机变化的效果。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 + **系统能力：** SystemCapability.ArkUI.ArkUI.Full | 名称 | 类型 | 必填 | 说明 | | ---- | ------------------------------ | ---- | --------------------------- | -| r | [ParticleTuple](#particletuple18) | 是 | r颜色通道的差值。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -| g | [ParticleTuple](#particletuple18) | 是 | g颜色通道的差值。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -| b | [ParticleTuple](#particletuple18) | 是 | b颜色通道的差值。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -| a | [ParticleTuple](#particletuple18) | 是 | a颜色通道的差值。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| r10+ | [ParticleTuple](#particletuple18) | 是 | r颜色通道的差值。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| g10+ | [ParticleTuple](#particletuple18) | 是 | g颜色通道的差值。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| b10+ | [ParticleTuple](#particletuple18) | 是 | b颜色通道的差值。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| a10+ | [ParticleTuple](#particletuple18) | 是 | a颜色通道的差值。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | ## ParticleAnnulusRegion20+ -- Gitee