From c27b47c3d8b5a8e0aaf50b7352a9a7742090507a Mon Sep 17 00:00:00 2001 From: lilanqing Date: Fri, 4 Jul 2025 15:32:27 +0800 Subject: [PATCH] cherrypick API19 Signed-off-by: lilanqing --- .../arkui-ts/ts-drawing-components-line.md | 4 ++++ .../arkui-ts/ts-drawing-components-path.md | 10 +++++--- .../arkui-ts/ts-drawing-components-polygon.md | 8 +++++-- .../ts-drawing-components-polyline.md | 8 +++++-- .../arkui-ts/ts-drawing-components-rect.md | 24 ++++++++++++------- .../arkui-ts/ts-drawing-components-shape.md | 18 ++++++++------ .../arkui-ts/ts-media-components-video.md | 14 ++++++++++- 7 files changed, 63 insertions(+), 23 deletions(-) mode change 100644 => 100755 zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-polygon.md mode change 100644 => 100755 zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-rect.md mode change 100644 => 100755 zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-shape.md diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-line.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-line.md index a3ba951b209..db5ca4a45e9 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-line.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-line.md @@ -30,6 +30,10 @@ Line(options?: LineOptions) ## LineOptions18+对象说明 用于描述Line绘制区域。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 + **卡片能力：** 从API version 18开始，该接口支持在ArkTS卡片中使用。 **原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-path.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-path.md index e52ace54472..79c553ae945 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-path.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-path.md @@ -30,6 +30,10 @@ Path(options?: PathOptions) ## PathOptions18+对象说明 用于描述Path绘制区域。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 + **卡片能力：** 从API version 18开始，该接口支持在ArkTS卡片中使用。 **原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 @@ -38,9 +42,9 @@ Path(options?: PathOptions) | 名称 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| width | string \| number | 否 | 路径所在矩形的宽度。
值为异常值或缺省时按照自身内容需要的宽度处理。
默认单位：vp | -| height | string \| number | 否 | 路径所在矩形的高度。
值为异常值或缺省时按照自身内容需要的宽度处理。
默认单位：vp | -| [commands](ts-drawing-components-path.md#commands) | string | 否 | 路径绘制的命令字符串。
值为异常值或缺省时按照自身内容需要的宽度处理。默认值：空字符串
异常值按照默认值处理。 | +| width7+ | string \| number | 否 | 路径所在矩形的宽度。
值为异常值或缺省时按照自身内容需要的宽度处理。
默认单位：vp | +| height7+ | string \| number | 否 | 路径所在矩形的高度。
值为异常值或缺省时按照自身内容需要的宽度处理。
默认单位：vp | +| [commands7+](ts-drawing-components-path.md#commands) | string | 否 | 路径绘制的命令字符串。
值为异常值或缺省时按照自身内容需要的宽度处理。默认值：空字符串
异常值按照默认值处理。 | ## 属性 diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-polygon.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-polygon.md old mode 100644 new mode 100755 index c0ec2a15bbd..c92945d3b00 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-polygon.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-polygon.md @@ -31,6 +31,10 @@ Polygon(options?: PolygonOptions) ## PolygonOptions18+对象说明 用于描述Polygon绘制区域。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 + **卡片能力：** 从API version 18开始，该接口支持在ArkTS卡片中使用。 **原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 @@ -39,8 +43,8 @@ Polygon(options?: PolygonOptions) | 名称 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| width | string \| number | 否 | 宽度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | -| height | string \| number | 否 | 高度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | +| width7+ | string \| number | 否 | 宽度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | +| height7+ | string \| number | 否 | 高度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | ## 属性 diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-polyline.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-polyline.md index 467fefe29d3..1f49a6105c3 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-polyline.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-polyline.md @@ -29,6 +29,10 @@ Polyline(options?: PolylineOptions) ## PolylineOptions18+对象说明 用于描述Polyline绘制区域。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 + **卡片能力：** 从API version 18开始，该接口支持在ArkTS卡片中使用。 **原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 @@ -37,8 +41,8 @@ Polyline(options?: PolylineOptions) | 名称 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| width | string \| number | 否 | 宽度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | -| height | string \| number | 否 | 高度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | +| width7+ | string \| number | 否 | 宽度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | +| height7+ | string \| number | 否 | 高度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | ## 属性 diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-rect.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-rect.md old mode 100644 new mode 100755 index 9cf4531bc76..8313dc0c917 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-rect.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-rect.md @@ -31,6 +31,10 @@ Rect(options?: RectOptions | RoundedRectOptions) ## RectOptions18+对象说明 用于描述Rect绘制属性。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 + **卡片能力：** 从API version 18开始，该接口支持在ArkTS卡片中使用。 **原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 @@ -39,13 +43,17 @@ Rect(options?: RectOptions | RoundedRectOptions) | 名称 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| width | string \| number | 否 | 宽度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | -| height | string \| number | 否 | 高度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | -| radius | string \| number \| Array<string \| number> | 否 | 圆角半径，支持分别设置四个角的圆角度数，取值范围≥0。
该属性和radiusWidth/radiusHeight属性效果类似，在组合使用时优先于radiusWidth/radiusHeight生效。
默认值：0
默认单位：vp
异常值按照默认值处理。 | +| width7+ | string \| number | 否 | 宽度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | +| height7+ | string \| number | 否 | 高度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | +| radius7+ | string \| number \| Array<string \| number> | 否 | 圆角半径，支持分别设置四个角的圆角度数，取值范围≥0。
该属性和radiusWidth/radiusHeight属性效果类似，在组合使用时优先于radiusWidth/radiusHeight生效。
默认值：0
默认单位：vp
异常值按照默认值处理。 | ## RoundedRectOptions18+对象说明 用于描述Rect绘制属性。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 + **卡片能力：** 从API version 18开始，该接口支持在ArkTS卡片中使用。 **原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 @@ -54,10 +62,10 @@ Rect(options?: RectOptions | RoundedRectOptions) | 名称 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| width | string \| number | 否 | 宽度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | -| height | string \| number | 否 | 高度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | -| radiusWidth | string \| number | 否 | 圆角宽度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 |圆角宽度。
默认值：0
异常值按照默认值处理。 -| radiusHeight | string \| number | 否 | 圆角高度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 |圆角高度。
默认值：0
异常值按照默认值处理。 +| width7+ | string \| number | 否 | 宽度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | +| height7+ | string \| number | 否 | 高度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | +| radiusWidth7+ | string \| number | 否 | 圆角宽度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 |圆角宽度。
默认值：0
异常值按照默认值处理。 +| radiusHeight7+ | string \| number | 否 | 圆角高度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 |圆角高度。
默认值：0
异常值按照默认值处理。 ## 属性 @@ -139,7 +147,7 @@ fill(value: ResourceColor) fillOpacity(value: number | string | Resource) -设置填充区域透明度。取值范围是[0.0, 1.0]，若给定值小于0.0，则取值为0.0；若给定值大于1.0，则取值为1.0，其余异常值按1.0处理。 +设置填充区域透明度。取值范围是[0.0, 1.0]，若给定值小于0.0，则取值为0.0；若给定值大于1.0，则取值为1.0；其余异常值按1.0处理。 **卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。 diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-shape.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-shape.md old mode 100644 new mode 100755 index 8d1f7d2ee09..f35e51d9902 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-shape.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-drawing-components-shape.md @@ -13,7 +13,7 @@ ## 子组件 -包含[Rect](ts-drawing-components-rect.md)、[Path](ts-drawing-components-path.md)、[Circle](ts-drawing-components-circle.md)、[Ellipse](ts-drawing-components-ellipse.md)、[Polyline](ts-drawing-components-polyline.md)、[Polygon](ts-drawing-components-polygon.md)、[Image](ts-basic-components-image.md)、[Text](ts-basic-components-text.md)、[Column](ts-container-column.md)、[Row](ts-container-row.md)、Shape子组件。 +包含[Rect](ts-drawing-components-rect.md)、[Path](ts-drawing-components-path.md)、[Circle](ts-drawing-components-circle.md)、[Ellipse](ts-drawing-components-ellipse.md)、[Polyline](ts-drawing-components-polyline.md)、[Polygon](ts-drawing-components-polygon.md)、[Image](ts-basic-components-image.md)、[Text](ts-basic-components-text.md)、[Column](ts-container-column.md)、[Row](ts-container-row.md)和Shape子组件。 ## 接口 @@ -56,7 +56,11 @@ viewPort(value: ViewportRect) | value | [ViewportRect](ts-drawing-components-shape.md#viewportrect18对象说明) | 是 | Viewport绘制属性。 | ## ViewportRect18+对象说明 -用于描述Viewport绘制属性。 +用于描述Viewport的绘制属性。 + +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 **卡片能力：** 从API version 18开始，该接口支持在ArkTS卡片中使用。 @@ -66,10 +70,10 @@ viewPort(value: ViewportRect) | 名称 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| x | string \| number | 否 | 形状视口起始点的水平坐标。
默认值：0
默认单位：vp
异常值按照默认值处理。 | -| y | string \| number | 否 | 形状视口起始点的垂直坐标。
默认值：0
默认单位：vp
异常值按照默认值处理。 | -| width | string \| number | 否 | 形状视口的宽度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | -| height | string \| number | 否 | 形状视口的高度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | +| x7+ | string \| number | 否 | 形状视口起始点的水平坐标。
默认值：0
默认单位：vp
异常值按照默认值处理。 | +| y7+ | string \| number | 否 | 形状视口起始点的垂直坐标。
默认值：0
默认单位：vp
异常值按照默认值处理。 | +| width7+ | string \| number | 否 | 形状视口的宽度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | +| height7+ | string \| number | 否 | 形状视口的高度，取值范围≥0。
默认值：0
默认单位：vp
异常值按照默认值处理。 | ### fill @@ -287,7 +291,7 @@ mesh(value: Array<any>, column: number, row: number) | 参数名 | 类型 | 必填 | 说明 | | ------ | ------------------- | ---- | ------------------------------------------------------------ | -| value | Array<any> | 是 | 长度（column + 1）* （row + 1）* 2的数组，它记录了扭曲后的位图各个顶点位置。 | +| value | Array<any> | 是 | 长度（column + 1）* （row + 1）* 2的数组，记录扭曲后的位图各个顶点位置。 | | column | number | 是 | mesh矩阵列数。 | | row | number | 是 | mesh矩阵行数。 | diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-media-components-video.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-media-components-video.md index 7f607272bc9..5588422db88 100755 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-media-components-video.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-media-components-video.md @@ -123,7 +123,7 @@ controls(value: boolean) > **说明：** > -> Video组件自带的控制器无法自定义。若有其他需求，可隐藏自带控制器，自定义控制器的样式或功能。参考[视频播放](https://gitee.com/harmonyos_samples/video-play)。 +> Video组件自带的控制器无法自定义。若有其他需求，可隐藏自带控制器并自定义控制器的样式或功能。参考[视频播放](https://gitee.com/harmonyos_samples/video-play)。 ### objectFit @@ -366,6 +366,10 @@ onFullscreenChange(callback: Callback\) 用于描述当前视频是否进入全屏播放状态。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 + **原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full @@ -378,6 +382,10 @@ onFullscreenChange(callback: Callback\) 用于描述当前视频的时长。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 + **原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full @@ -390,6 +398,10 @@ onFullscreenChange(callback: Callback\) 用于描述当前视频播放的进度。 +> **说明：** +> +> 为规范匿名对象的定义，API 18版本修改了此处的元素定义。其中，保留了历史匿名对象的起始版本信息，会出现外层元素@since版本号高于内层元素版本号的情况，但这不影响接口的使用。 + **原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full -- Gitee