From 62bbc0356d845be6e5d4d97c30f8089378bc2c23 Mon Sep 17 00:00:00 2001 From: yamila Date: Mon, 12 Jun 2023 19:01:33 +0800 Subject: [PATCH] update textpicker Signed-off-by: yamila --- .../reference/apis/js-apis-curve.md | 24 +-- .../reference/apis/js-apis-font.md | 2 + .../reference/apis/js-apis-matrix4.md | 163 +++++++++++------- .../reference/apis/js-apis-system-router.md | 4 +- .../reference/arkui-ts/ts-container-badge.md | 13 +- 5 files changed, 119 insertions(+), 87 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-curve.md b/zh-cn/application-dev/reference/apis/js-apis-curve.md index 95946c8f4d..b47d1db562 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-curve.md +++ b/zh-cn/application-dev/reference/apis/js-apis-curve.md @@ -16,7 +16,7 @@ import Curves from '@ohos.curves' ## Curves.initCurve9+ -initCurve(curve?: Curve)：ICurve +initCurve(curve?: Curve): ICurve 插值曲线的初始化函数，可以根据入参创建一个插值曲线对象。 @@ -25,9 +25,9 @@ initCurve(curve?: Curve)：ICurve **参数：** -| 参数名 | 类型 | 必填 | 默认值 | 说明 | -| ------ | ------------------------------------------------------------ | ---- | ------------ | ---------- | -| curve | [Curve](../arkui-ts/ts-appendix-enums.md#curve) | 否 | Curve.Linear | 曲线类型。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ----------------------------------------------- | ---- | ----------------------------------- | +| curve | [Curve](../arkui-ts/ts-appendix-enums.md#curve) | 否 | 曲线类型。
默认值：Curve.Linear | **返回值：** @@ -46,7 +46,7 @@ Curves.initCurve(Curve.EaseIn) // 创建一个默认先慢后快插值曲线 ##  Curves.stepsCurve9+ -stepsCurve(count: number, end: boolean)：ICurve +stepsCurve(count: number, end: boolean): ICurve 构造阶梯曲线对象。 @@ -77,7 +77,7 @@ Curves.stepsCurve(9, true) //创建一个阶梯曲线 ## Curves.cubicBezierCurve9+ -cubicBezierCurve(x1: number, y1: number, x2: number, y2: number)：ICurve +cubicBezierCurve(x1: number, y1: number, x2: number, y2: number): ICurve 构造三阶贝塞尔曲线对象，曲线的值必须处于0-1之间。 @@ -109,7 +109,7 @@ Curves.cubicBezierCurve(0.1, 0.0, 0.1, 1.0) // 创建一个三阶贝塞尔曲线 ##  Curves.springCurve9+ -springCurve(velocity: number, mass: number, stiffness: number, damping: number)：ICurve +springCurve(velocity: number, mass: number, stiffness: number, damping: number): ICurve 构造弹簧曲线对象。 @@ -159,7 +159,7 @@ springMotion(response?: number, dampingFraction?: number, overlapDuration?: numb | 类型 | 说明 | | ---------------------------------- | ---------------- | -| [ICurve](#icurve)| 曲线对象。
**说明:** 弹性动画曲线为物理曲线，[animation](../arkui-ts/ts-animatorproperty.md)、[animateTo](../arkui-ts/ts-explicit-animation.md)中的duration参数不生效，动画持续时间取决于springMotion动画曲线参数和之前的速度。时间不能归一，故不能通过该曲线的[interpolate](#interpolate)函数获得插值。 | +| [ICurve](#icurve)| 曲线对象。
**说明:** 弹性动画曲线为物理曲线，[animation](../arkui-ts/ts-animatorproperty.md)、[animateTo](../arkui-ts/ts-explicit-animation.md)中的duration参数不生效，动画持续时间取决于springMotion动画曲线参数和之前的速度。时间不能归一，故不能通过该曲线的[interpolate](#interpolate9)函数获得插值。 | **示例：** @@ -204,7 +204,7 @@ Curves.responsiveSpringMotion() // 创建一个默认弹性跟手动画曲线 ## ICurve -### interpolate +### interpolate9+ interpolate(fraction: number): number @@ -246,9 +246,9 @@ init(curve?: Curve): string **参数：** -| 参数名 | 类型 | 必填 | 默认值 | 说明 | -| ------ | ------------------------------------------------------------ | ---- | ------------ | ---------- | -| curve |[Curve](../arkui-ts/ts-appendix-enums.md#curve) | 否 | Curve.Linear | 曲线类型。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ----------------------------------------------- | ---- | ----------------------------------- | +| curve | [Curve](../arkui-ts/ts-appendix-enums.md#curve) | 否 | 曲线类型。
默认值：Curve.Linear | ## Curves.steps(deprecated) diff --git a/zh-cn/application-dev/reference/apis/js-apis-font.md b/zh-cn/application-dev/reference/apis/js-apis-font.md index f6ae982eb1..953916867d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-font.md +++ b/zh-cn/application-dev/reference/apis/js-apis-font.md @@ -5,6 +5,8 @@ > **说明** > > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> +> 本模块接口为系统接口。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-matrix4.md b/zh-cn/application-dev/reference/apis/js-apis-matrix4.md index 761096da02..5832fd6efc 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-matrix4.md +++ b/zh-cn/application-dev/reference/apis/js-apis-matrix4.md @@ -16,7 +16,7 @@ import matrix4 from '@ohos.matrix4' ## matrix4.init -init(array: Array<number>): Matrix4Transit +init(option: [number,number,number,number,number,number,number,number,number,number,number,number,number,number,number,number]): Matrix4Transit Matrix的构造函数，可以通过传入的参数创建一个四阶矩阵，矩阵为列优先。 @@ -25,17 +25,17 @@ Matrix的构造函数，可以通过传入的参数创建一个四阶矩阵， **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ------------------- | ---- | ------------------------------------------------------------ | -| array | Array<number> | 是 | 参数为长度为16（4\*4）的number数组, 详情见参数描述。
默认值：
[1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
0, 0, 0, 1] | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | +| option | [number,number,number,number,number,number,number,number,number,number,number,number,number,number,number,number] | 是 | 参数为长度为16（4\*4）的number数组, 详情见四阶矩阵说明。
默认值：
[1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
0, 0, 0, 1] | **返回值：** -| 类型 | 说明 | -| -------------- | ---------------------------- | -| Matrix4Transit | 根据入参创建的四阶矩阵对象。 | +| 类型 | 说明 | +| --------------------------------- | ---------------------------- | +| [Matrix4Transit](#matrix4transit) | 根据入参创建的四阶矩阵对象。 | -**array参数说明：** +**四阶矩阵说明：** | 参数名 | 类型 | 必填 | 说明 | | ---- | ------ | ---- | -------------------- | @@ -91,9 +91,9 @@ Matrix的初始化函数，可以返回一个单位矩阵对象。 **返回值：** -| 类型 | 说明 | -| -------------- | -------------- | -| Matrix4Transit | 单位矩阵对象。 | +| 类型 | 说明 | +| --------------------------------- | -------------- | +| [Matrix4Transit](#matrix4transit) | 单位矩阵对象。 | **示例：** @@ -136,9 +136,9 @@ Matrix的拷贝函数，可以拷贝一份当前的矩阵对象。 **返回值：** -| 类型 | 说明 | -| -------------- | -------------------- | -| Matrix4Transit | 当前矩阵的拷贝对象。 | +| 类型 | 说明 | +| --------------------------------- | -------------------- | +| [Matrix4Transit](#matrix4transit) | 当前矩阵的拷贝对象。 | **示例：** @@ -170,12 +170,12 @@ struct Test { ![zh-cn_image_0000001219744181](figures/zh-cn_image_0000001219744181.png) -## Matrix4 +## Matrix4Transit ### combine -combine(matrix: Matrix4): Matrix4Transit +combine(option: Matrix4Transit): Matrix4Transit Matrix的叠加函数，可以将两个矩阵的效果叠加起来生成一个新的矩阵对象。 @@ -184,15 +184,15 @@ Matrix的叠加函数，可以将两个矩阵的效果叠加起来生成一个 **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ------- | ---- | ------------------ | -| matrix | Matrix4 | 是 | 待叠加的矩阵对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | --------------------------------- | ---- | ------------------ | +| option | [Matrix4Transit](#matrix4transit) | 是 | 待叠加的矩阵对象。 | **返回值：** -| 类型 | 说明 | -| -------------- | ------------------ | -| Matrix4Transit | 矩阵叠加后的对象。 | +| 类型 | 说明 | +| --------------------------------- | ------------------ | +| [Matrix4Transit](#matrix4transit) | 矩阵叠加后的对象。 | **示例：** @@ -236,9 +236,9 @@ Matrix的逆函数，可以返回一个当前矩阵对象的逆矩阵，即效 **返回值：** -| 类型 | 说明 | -| -------------- | ---------------------- | -| Matrix4Transit | 当前矩阵的逆矩阵对象。 | +| 类型 | 说明 | +| --------------------------------- | ---------------------- | +| [Matrix4Transit](#matrix4transit) | 当前矩阵的逆矩阵对象。 | **示例：** @@ -270,25 +270,23 @@ struct Tests { ### translate -translate({x?: number, y?: number, z?: number}): Matrix4Transit +translate(option: TranslateOption): Matrix4Transit -Matrix的平移函数，可以为当前矩阵增加x轴/Y轴/Z轴平移效果。 +Matrix的平移函数，可以为当前矩阵增加x轴/y轴/z轴平移效果。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ------ | ---- | ------------------------------------------------------------ | -| x | number | 否 | x轴的平移距离。
默认值：0
单位px
取值范围 (-∞, +∞) | -| y | number | 否 | y轴的平移距离，单位px。
默认值：0
单位px
取值范围 (-∞, +∞) | -| z | number | 否 | z轴的平移距离，单位px。
默认值：0
单位px
取值范围 (-∞, +∞) | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ----------------------------------- | ---- | -------------- | +| option | [TranslateOption](#translateoption) | 是 | 设置平移参数。 | **返回值：** -| 类型 | 说明 | -| -------------- | ---------------------------- | -| Matrix4Transit | 增加好平移效果后的矩阵对象。 | +| 类型 | 说明 | +| --------------------------------- | ---------------------------- | +| [Matrix4Transit](#matrix4transit) | 增加好平移效果后的矩阵对象。 | **示例：** @@ -315,28 +313,30 @@ struct Test { ### scale -scale({x?: number, y?: number, z?: number, centerX?: number, centerY?: number}): Matrix4Transit +scale(option: ScaleOption): Matrix4Transit -Matrix的缩放函数，可以为当前矩阵增加x轴/Y轴/Z轴缩放效果。 +Matrix的缩放函数，可以为当前矩阵增加x轴/y轴/z轴缩放效果。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------- | ------ | ---- | ------------------------------------------------------------ | -| x | number | 否 | x轴的缩放倍数。x>1时以x轴方向放大，x<1时以x轴方向缩小。
默认值：1
取值范围 [0, +∞)
**说明：**
设置小于0的值时，按照默认值处理。 | -| y | number | 否 | y轴的缩放倍数。y>1时以y轴方向放大，y<1时以y轴方向缩小。
默认值：1
取值范围 [0, +∞)
**说明：**
设置小于0的值时，按照默认值处理。 | -| z | number | 否 | z轴的缩放倍数。z>1时以z轴方向放大，z<1时以z轴方向缩小。
默认值：1
取值范围 [0, +∞)
**说明：**
设置小于0的值时，按照默认值处理。 | -| centerX | number | 否 | 变换中心点x轴坐标。
默认值：0
取值范围 (-∞, +∞) | -| centerY | number | 否 | 变换中心点y轴坐标。
默认值：0
取值范围 (-∞, +∞) | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | --------------------------- | ---- | -------------- | +| option | [ScaleOption](#scaleoption) | 是 | 设置缩放参数。 | **返回值：** -| 类型 | 说明 | -| -------------- | ---------------------------- | -| Matrix4Transit | 增加好缩放效果后的矩阵对象。 | +| 类型 | 说明 | +| --------------------------------- | ---------------------------- | +| [Matrix4Transit](#matrix4transit) | 增加好平移效果后的矩阵对象。 | + +**返回值：** + +| 类型 | 说明 | +| --------------------------------- | ---------------------------- | +| [Matrix4Transit](#matrix4transit) | 增加好缩放效果后的矩阵对象。 | **示例：** @@ -363,29 +363,30 @@ struct Test { ### rotate -rotate({x?: number, y?: number, z?: number, angle?: number, centerX?: Length, centerY?: Length}): Matrix4Transit +rotate(option: RotateOption): Matrix4Transit -Matrix的旋转函数，可以为当前矩阵增加x轴/Y轴/Z轴旋转效果。 +Matrix的旋转函数，可以为当前矩阵增加x轴/y轴/z轴旋转效果。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------- | ------ | ---- | ----------------------------------------------------- | -| x | number | 否 | 旋转轴向量x坐标。
默认值：1
取值范围 (-∞, +∞) | -| y | number | 否 | 旋转轴向量y坐标。
默认值：1
取值范围 (-∞, +∞) | -| z | number | 否 | 旋转轴向量z坐标。
默认值：1
取值范围 (-∞, +∞) | -| angle | number | 否 | 旋转角度。
默认值：0 | -| centerX | number | 否 | 变换中心点x轴坐标。
默认值：0 | -| centerY | number | 否 | 变换中心点y轴坐标。
默认值：0 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ----------------------------- | ---- | -------------- | +| option | [RotateOption](#rotateoption) | 是 | 设置旋转参数。 | **返回值：** -| 类型 | 说明 | -| -------------- | ---------------------------- | -| Matrix4Transit | 增加好旋转效果后的矩阵对象。 | +| 类型 | 说明 | +| --------------------------------- | ---------------------------- | +| [Matrix4Transit](#matrix4transit) | 增加好平移效果后的矩阵对象。 | + +**返回值：** + +| 类型 | 说明 | +| --------------------------------- | ---------------------------- | +| [Matrix4Transit](#matrix4transit) | 增加好旋转效果后的矩阵对象。 | **示例：** @@ -412,7 +413,7 @@ struct Test { ### transformPoint -transformPoint(point: Point): Point +transformPoint(option: [number, number]): [number, number] Matrix的坐标点转换函数，可以将当前的变换效果作用到一个坐标点上。 @@ -421,15 +422,15 @@ Matrix的坐标点转换函数，可以将当前的变换效果作用到一个 **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ----- | ---- | ------------------ | -| point | Point | 是 | 需要转换的坐标点。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ---------------- | ---- | ------------------ | +| option | [number, number] | 是 | 需要转换的坐标点。 | **返回值：** -| 类型 | 说明 | -| ----- | ---------------- | -| Point | 返回矩阵变换后的Point对象。 | +| 类型 | 说明 | +| ---------------- | --------------------------- | +| [number, number] | 返回矩阵变换后的Point对象。 | **示例：** @@ -468,3 +469,31 @@ struct Test { ![zh-cn_image_0000001219864133](figures/zh-cn_image_0000001219864133.PNG) +## TranslateOption + +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ----------------------------------------------------------- | +| x | number | 否 | x轴的平移距离，单位px。
默认值：0
取值范围 (-∞, +∞) | +| y | number | 否 | y轴的平移距离，单位px。
默认值：0
取值范围 (-∞, +∞) | +| z | number | 否 | z轴的平移距离，单位px。
默认值：0
取值范围 (-∞, +∞) | + +## ScaleOption + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ------------------------------------------------------------ | +| x | number | 否 | x轴的缩放倍数。x>1时以x轴方向放大，x<1时以x轴方向缩小。
默认值：1
取值范围 [0, +∞)
**说明：**
设置小于0的值时，按照默认值处理。 | +| y | number | 否 | y轴的缩放倍数。y>1时以y轴方向放大，y<1时以y轴方向缩小。
默认值：1
取值范围 [0, +∞)
**说明：**
设置小于0的值时，按照默认值处理。 | +| z | number | 否 | z轴的缩放倍数。z>1时以z轴方向放大，z<1时以z轴方向缩小。
默认值：1
取值范围 [0, +∞)
**说明：**
设置小于0的值时，按照默认值处理。 | +| centerX | number | 否 | 变换中心点x轴坐标。
默认值：0。
取值范围 (-∞, +∞) | +| centerY | number | 否 | 变换中心点y轴坐标。
默认值：0。
取值范围 (-∞, +∞) | + +## RotateOption + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ------------------------------------------------------- | +| x | number | 否 | 旋转轴向量x坐标。
默认值：1。
取值范围 (-∞, +∞) | +| y | number | 否 | 旋转轴向量y坐标。
默认值：1。
取值范围 (-∞, +∞) | +| z | number | 否 | 旋转轴向量z坐标。
默认值：1。
取值范围 (-∞, +∞) | +| angle | number | 否 | 旋转角度。
默认值：0 | +| centerX | number | 否 | 变换中心点x轴坐标。
默认值：0 | +| centerY | number | 否 | 变换中心点y轴坐标。
默认值：0 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-router.md b/zh-cn/application-dev/reference/apis/js-apis-system-router.md index 4d22c6d63c..2a1e365ed8 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-router.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-router.md @@ -341,8 +341,8 @@ export default { | 名称 | 类型 | 必填 | 说明 | | ------ | -------- | ---- | ------------------------------------------------------------ | -| uri7+ | string | 是 | 目标页面的uri，可以是以下的两种格式：
1. 页面的绝对路径，由config.json文件中的页面列表提供。例如：
- pages/index/index
-pages/detail/detail
2. 特定路径。如果URI为斜杠（/），则显示主页。 | -| params7+ | object | 否 | 表示路由跳转时要同时传递到目标页面的数据。跳转到目标页面后，使用router.getParams()获取传递的参数，此外，在类web范式中，参数也可以在页面中直接使用，如this.keyValue(keyValue为跳转时params参数中的key值)，如果目标页面中已有该字段，则其值会被传入的字段值覆盖。 | +| uri | string | 是 | 目标页面的uri，可以是以下的两种格式：
1. 页面的绝对路径，由config.json文件中的页面列表提供。例如：
- pages/index/index
-pages/detail/detail
2. 特定路径。如果URI为斜杠（/），则显示主页。 | +| params | object | 否 | 表示路由跳转时要同时传递到目标页面的数据。跳转到目标页面后，使用router.getParams()获取传递的参数，此外，在类web范式中，参数也可以在页面中直接使用，如this.keyValue(keyValue为跳转时params参数中的key值)，如果目标页面中已有该字段，则其值会被传入的字段值覆盖。 | ## BackRouterOptions diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-badge.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-badge.md index 57cd9d2c35..66ccadc2c6 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-badge.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-badge.md @@ -25,12 +25,13 @@ 从API version 9开始，该接口支持在ArkTS卡片中使用。 **参数：** -| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | -| -------- | -------- | -------- | -------- | -------- | -| count | number | 是 | - | 设置提醒消息数。
**说明：**
小于等于0时不显示信息标记。
取值范围：[-2147483648,2147483647]，非整数时会舍去小数部分取整数部分，如5.5取5。 | -| position | [BadgePosition](#badgeposition枚举说明) | 否 | BadgePosition.RightTop | 设置提示点显示位置。
默认值：BadgePosition.RightTop | -| maxCount | number | 否 | 99 | 最大消息数，超过最大消息时仅显示maxCount+。 | -| style | [BadgeStyle](#badgestyle对象说明) | 是 | - | Badge组件可设置样式，支持设置文本颜色、尺寸、圆点颜色和尺寸。 | + +| 参数名 | 参数类型 | 必填 | 参数描述 | +| -------- | -------- | -------- | -------- | +| count | number | 是 | 设置提醒消息数。
**说明：**
小于等于0时不显示信息标记。
取值范围：[-2147483648,2147483647]，非整数时会舍去小数部分取整数部分，如5.5取5。 | +| position | [BadgePosition](#badgeposition枚举说明) | 否 | 设置提示点显示位置。
默认值：BadgePosition.RightTop | +| maxCount | number | 否 | 最大消息数，超过最大消息时仅显示maxCount+。
默认值：99
取值范围：[-2147483648,2147483647]，非整数时会舍去小数部分取整数部分，如5.5取5。 | +| style | [BadgeStyle](#badgestyle对象说明) | 是 | Badge组件可设置样式，支持设置文本颜色、尺寸、圆点颜色和尺寸。 | **方法2：** Badge(value: {value: string, position?: BadgePosition, style: BadgeStyle}) -- GitLab