From c0e4d99a19dc6063d71dd51561af0199e787bed3 Mon Sep 17 00:00:00 2001 From: HelloCrease Date: Mon, 27 Mar 2023 20:05:25 +0800 Subject: [PATCH] update docs Signed-off-by: HelloCrease --- .../reference/arkui-ts/figures/coordinates.png | Bin 0 -> 6876 bytes .../ts-universal-attributes-transformation.md | 13 ++++++++----- 2 files changed, 8 insertions(+), 5 deletions(-) create mode 100644 zh-cn/application-dev/reference/arkui-ts/figures/coordinates.png diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/coordinates.png b/zh-cn/application-dev/reference/arkui-ts/figures/coordinates.png new file mode 100644 index 0000000000000000000000000000000000000000..ee66555b8a8f54183d008b62e3d73496ac679846 GIT binary patch literal 6876 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 XoE};w?LGTMio@)R1+2ozIp%)=cFzx?: number,
y?: number,
z?: number,
angle?: number \| string,
centerX?: number \| string,
centerY?: number \| string
} | (x, y, z)指定一个矢量，表示旋转轴，正角度为顺时针转动，负角度为逆时针转动，默认值为0，同时可以通过centerX和centerY设置旋转的中心点。
默认值:
{
x: 0,
y: 0,
z: 0,
angle: 0,
centerX: '50%',
centerY: '50%'
}
从API version 9开始，该接口支持在ArkTS卡片中使用。 | -| translate | {
x?: number \| string,
y?: number \| string,
z? : number \| string
} | 可以分别设置X轴、Y轴、Z轴的平移距离，距离的正负控制平移的方向。不支持百分比形式的输入。
默认值:
{
x: 0,
y: 0,
z: 0
}
从API version 9开始，该接口支持在ArkTS卡片中使用。 | +| 名称 | 参数类型 | 描述 | +| --------- | ---------------------------------------- | ---------------------------------------- | +| rotate | {
x?: number,
y?: number,
z?: number,
angle: number \| string,
centerX?: number \| string,
centerY?: number \| string
} | 可使组件在以组件左上角为坐标原点的坐标系中进行旋转（坐标系如下图所示）。其中，(x, y, z）指定一个矢量，作为旋转轴。
- angle：旋转角度。取值为正时相对于旋转轴方向顺时针转动，取值为负时相对于旋转轴方向逆时针转动。取值可为string类型，如'90deg'。
- centerX和centerY用于指定旋转的中心点。
旋转轴和旋转中心点都基于坐标系设定，组件发生位移时，坐标系不会随之移动。
默认值:
{
x: 0,
y: 0,
z: 0,
centerX: '50%',
centerY: '50%'
}
![coordinates](figures/coordinates.png)
从API version 9开始，该接口支持在ArkTS卡片中使用。 | +| translate | {
x?: number \| string,
y?: number \| string,
z? : number \| string
} | 可使组件在以组件左上角为坐标原点的坐标系中进行移动（坐标系如下图所示）。其中，x，y，z的值分别表示在对应轴移动的距离，值为正时表示向对应轴的正向移动，值为负时表示向对应轴的反向移动。移动距离支持数字和字符串（比如'10px'，‘10%’）两种类型。
默认值:
{
x: 0,
y: 0,
z: 0
}
![coordinates](figures/coordinates.png)
从API version 9开始，该接口支持在ArkTS卡片中使用。 | | scale | {
x?: number,
y?: number,
z?: number,
centerX?: number \| string,
centerY?: number \| string
} | 可以分别设置X轴、Y轴、Z轴的缩放比例，默认值为1，同时可以通过centerX和centerY设置缩放的中心点。
默认值:
{
x: 1,
y: 1,
z: 1,
centerX:'50%',
centerY:'50%'
}
从API version 9开始，该接口支持在ArkTS卡片中使用。 | -| transform | [Matrix4Transit](../apis/js-apis-matrix4.md) | 设置当前组件的变换矩阵。 | +| transform | [Matrix4Transit](../apis/js-apis-matrix4.md) | 设置当前组件的变换矩阵。 | +> **说明：** +> +> 当组件同时设置了rotate和scale属性时，centerX和centerY的取值会发生冲突，此时centerX和centerY的值以后设定属性的值为准。 ## 示例 -- GitLab