diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-longpressgesture.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-longpressgesture.md index 634e49c72c9b3e9fa1dec5c393e943168126fb63..8174f0054595ed1ced2a694967e9e193f3909932 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-longpressgesture.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-longpressgesture.md @@ -24,8 +24,8 @@ LongPressGesture(value?: { fingers?: number, repeat?: boolean, duration?: number | 名称 | 功能描述 | | -------- | -------- | -| onAction(event:(event?: [GestureEvent](ts-gesture-settings.md)) => void) | LongPress手势识别成功回调。 | -| onActionEnd(event:(event?: [GestureEvent](ts-gesture-settings.md)) => void) | LongPress手势识别成功，手指抬起后触发回调。 | +| onAction(event:(event?: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | LongPress手势识别成功回调。 | +| onActionEnd(event:(event?: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | LongPress手势识别成功，手指抬起后触发回调。 | | onActionCancel(event: () => void) | LongPress手势识别成功，接收到触摸取消事件触发回调。 | diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md index e7cdbf89ea19c575332a11adfcebca62d1b3be55..c4c190c8e0387d503cf437c6314c1aace48bf393 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md @@ -60,9 +60,9 @@ PanGestureOptions(value?: { fingers?: number; direction?: PanDirection; distance | 名称 | 功能描述 | | -------- | -------- | -| onActionStart(event: (event?: [GestureEvent](ts-gesture-settings.md)) => void) | Pan手势识别成功回调。 | -| onActionUpdate(event: (event?: [GestureEvent](ts-gesture-settings.md)) => void) | Pan手势移动过程中回调。 | -| onActionEnd(event: (event?: [GestureEvent](ts-gesture-settings.md)) => void) | Pan手势识别成功，手指抬起后触发回调。 | +| onActionStart(event: (event?: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | Pan手势识别成功回调。 | +| onActionUpdate(event: (event?: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | Pan手势移动过程中回调。 | +| onActionEnd(event: (event?: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | Pan手势识别成功，手指抬起后触发回调。 | | onActionCancel(event: () => void) | Pan手势识别成功，接收到触摸取消事件触发回调。 | diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pinchgesture.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pinchgesture.md index e292fb68ce1481903e2ab603e81e3ab09d72c14e..8bb8682de96453474155f028b745cdc0878eda93 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pinchgesture.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pinchgesture.md @@ -23,9 +23,9 @@ PinchGesture(value?: { fingers?: number, distance?: number }) | 名称 | 功能描述 | | -------- | -------- | -| onActionStart(event:(event?: [GestureEvent](ts-gesture-settings.md)) => void) | Pinch手势识别成功回调。 | -| onActionUpdate(event:(event?: [GestureEvent](ts-gesture-settings.md)) => void) | Pinch手势移动过程中回调。 | -| onActionEnd(event:(event?: [GestureEvent](ts-gesture-settings.md)) => void) | Pinch手势识别成功，手指抬起后触发回调。 | +| onActionStart(event:(event?: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | Pinch手势识别成功回调。 | +| onActionUpdate(event:(event?: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | Pinch手势移动过程中回调。 | +| onActionEnd(event:(event?: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | Pinch手势识别成功，手指抬起后触发回调。 | | onActionCancel(event: () => void) | Pinch手势识别成功，接收到触摸取消事件触发回调。 | @@ -40,7 +40,7 @@ struct PinchGestureExample { build() { Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.SpaceBetween }) { - Text('PinchGesture scale:' + this.scale) + Text('PinchGesture scale:' + this.scaleValue) } .height(100).width(200).padding(20).border({ width: 1 }).margin(80) .scale({ x: this.scaleValue, y: this.scaleValue, z: this.scaleValue }) diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-rotationgesture.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-rotationgesture.md index 47420c92cbbfdffdec358305a1d4ec32a28e4d0d..9dd8ca8ff89bc90dc0eec4e7e31d96ba77fe6295 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-rotationgesture.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-rotationgesture.md @@ -23,9 +23,9 @@ RotationGesture(value?: { fingers?: number, angle?: number }) | 名称 | 功能描述 | | -------- | -------- | -| onActionStart(event:(event?: [GestureEvent](ts-gesture-settings.md)) => void) | Rotation手势识别成功回调。 | -| onActionUpdate(event:(event?: [GestureEvent](ts-gesture-settings.md)) => void) | Rotation手势移动过程中回调。 | -| onActionEnd(event:(event?: [GestureEvent](ts-gesture-settings.md)) => void) | Rotation手势识别成功，手指抬起后触发回调。 | +| onActionStart(event:(event?: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | Rotation手势识别成功回调。 | +| onActionUpdate(event:(event?: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | Rotation手势移动过程中回调。 | +| onActionEnd(event:(event?: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | Rotation手势识别成功，手指抬起后触发回调。 | | onActionCancel(event: () => void) | Rotation手势识别成功，接收到触摸取消事件触发回调。 | diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-swipegesture.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-swipegesture.md index b7973dadb17bf877a79aea035335e15660b9aa05..52a4901dd3ccac0070eaebb0cb993e9a501bcf6e 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-swipegesture.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-swipegesture.md @@ -33,7 +33,7 @@ SwipeGesture(value?: { fingers?: number; direction?: SwipeDirection; speed?: num | 名称 | 功能描述 | | -------- | -------- | -| onAction(event:(event?: [GestureEvent](ts-gesture-settings.md)) => void) | 滑动手势识别成功回调。 | +| onAction(event:(event?: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | 滑动手势识别成功回调。 | ![zh-cn_image_0000001231374559](figures/zh-cn_image_0000001231374661.png) ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-tapgesture.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-tapgesture.md index 68b27342c2b9fcc3cd267988c9b9fb6f601c05cf..6c27f6bbcf09bedabada2e7e57fc936842c54365 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-tapgesture.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-tapgesture.md @@ -23,7 +23,7 @@ TapGesture(value?: { count?: number, fingers?: number }) | 名称 | 功能描述 | | -------- | -------- | -| onAction(event: (event?: [GestureEvent](ts-gesture-settings.md)) => void) | Tap手势识别成功回调。 | +| onAction(event: (event?: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | Tap手势识别成功回调。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-combined-gestures.md b/zh-cn/application-dev/reference/arkui-ts/ts-combined-gestures.md index b702af0af1c0573fb956353f282a4704dd47c084..4b4886280dbfb229d401128e40151488ca57ed2b 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-combined-gestures.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-combined-gestures.md @@ -6,11 +6,6 @@ > 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -## 权限列表 - -无 - - ## 接口 GestureGroup(mode: GestureMode, ...gesture: GestureType[]) @@ -18,10 +13,10 @@ GestureGroup(mode: GestureMode, ...gesture: GestureType[]) - 参数 | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | | -------- | -------- | -------- | -------- | -------- | - | mode | GestureMode | 是 | - | 设置组合手势识别模式。 | + | mode | [GestureMode](#gesturemode枚举说明) | 是 | - | 设置组合手势识别模式。 | | gesture | [TapGesture](ts-basic-gestures-tapgesture.md)
\| [LongPressGesture](ts-basic-gestures-longpressgesture.md)
\| [PanGesture](ts-basic-gestures-pangesture.md)
\| [PinchGesture](ts-basic-gestures-pinchgesture.md)
\| [RotationGesture](ts-basic-gestures-rotationgesture.md) | 是 | - | 可变长参数，1个或者多个基础手势类型，这些手势会被组合识别。 | -- GestureMode枚举说明 +## GestureMode枚举说明 | 名称 | 描述 | | -------- | -------- | | Sequence | 顺序识别，按照手势的注册顺序识别手势，直到所有手势识别成功。当有一个手势识别失败时，所有手势识别失败。 | diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-listitemgroup.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-listitemgroup.md index ac061332cf27aed7964539e0544f8570f5464535..6e444434ff1950e67bdf3ca2ab95498d672e3c8f 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-listitemgroup.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-listitemgroup.md @@ -8,7 +8,7 @@ ## 使用说明 当ListItemGroup的父组件List的listDirection属性为Axis.Vertical时，不允许设置ListItemGroup组件的height属性。ListItemGroup的高度为header高度、footer高度和所有ListItem布局后总高度之和。当父组件List的listDirection属性为Axis.Horizontal时，不允许设置ListItemGroup组件的width属性。ListItemGroup的宽度为header宽度、footer宽度和所有ListItem布局后总宽度之和。 -当前ListItemGroup内部的ListItem不支持编辑、框选、拖拽功能，即ListItemGroup内部的ListItem组件editable、selectable属性不生效。 +当前ListItemGroup内部的ListItem组件不支持编辑、框选、拖拽功能，即ListItem组件的editable、selectable属性不生效。 ## 子组件 @@ -96,7 +96,7 @@ struct ListItemGroupExample { }, item => item) } .borderRadius(20) - .divider({ strokeWidth: 1, color: 0xDCDCDC }) // 每行之间的分界线 + .divider({ strokeWidth: 1, color: Color.Blue) // 每行之间的分界线 }) } .width('90%') diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md b/zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md index 31571927efafe26c33abdd83139da9c3eb7db932..b5f9d553232b155d94c76e8ad0e2c218cff0d45d 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md @@ -6,11 +6,6 @@ > 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -## 权限列表 - -无 - - ## 绑定手势识别 @@ -19,63 +14,63 @@ | 名称 | 参数类型 | 默认值 | 描述 | | -------- | -------- | -------- | -------- | -| gesture | gesture: GestureType,
mask?: GestureMask | gesture: -，
mask: GestureMask.Normal | 绑定手势识别。
- gesture: 绑定的手势类型， 
- mask: 事件响应设置。 | -| priorityGesture | gesture: GestureType,
mask?: GestureMask | gesture: -，
mask: GestureMask.Normal | 绑定优先识别手势。
- gesture: 绑定的手势类型， 
- mask: 事件响应设置。
默认情况下，子组件优先于父组件识别手势，当父组件配置priorityGesture时，父组件优先于子组件进行识别。 | -| parallelGesture | gesture: GestureType,
mask?: GestureMask | gesture: -，
mask: GestureMask.Normal | 绑定可与子组件手势同时触发的手势。
- gesture: 绑定的手势类型。 
- mask: 事件响应设置。
手势事件为非冒泡事件。父组件设置parallelGesture时，父子组件相同的手势事件都可以触发，实现类似冒泡效果。 | +| gesture | gesture: [GestureType](#gesturetype),
mask?: [GestureMask](#gesturemask枚举说明) | gesture: -，
mask: GestureMask.Normal | 绑定手势。
- gesture: 绑定的手势类型， 
- mask: 事件响应设置。 | +| priorityGesture | gesture: [GestureType](#gesturetype),
mask?: [GestureMask](#gesturemask枚举说明) | gesture: -，
mask: GestureMask.Normal | 绑定优先识别手势。
- gesture: 绑定的手势类型， 
- mask: 事件响应设置。
默认情况下，子组件优先识别通过gesture绑定的手势，当父组件配置priorityGesture时，子组件优先识别priorityGesture绑定的手势。 | +| parallelGesture | gesture: [GestureType](#gesturetype),
mask?: [GestureMask](#gesturemask枚举说明) | gesture: -，
mask: GestureMask.Normal | 绑定可与子组件手势同时触发的手势。
- gesture: 绑定的手势类型。 
- mask: 事件响应设置。
手势事件为非冒泡事件。父组件设置parallelGesture时，父子组件相同的手势事件都可以触发，实现类似冒泡效果。 | -- GestureMask枚举说明 - | 名称 | 描述 | +## GestureType +| 名称 | 描述 | | -------- | -------- | - | Normal | 不屏蔽子组件的手势，按照默认手势识别顺序进行识别。 | - | IgnoreInternal | 屏蔽子组件的手势，仅当前容器的手势进行识别。
子组件上系统内置的手势不会被屏蔽，如子组件为List组件时，内置的滑动手势仍然会触发。 | +| [TapGesture](ts-basic-gestures-tapgesture.md) | 点击手势，支持单次点击、多次点击识别。 | +| [LongPressGesture](ts-basic-gestures-longpressgesture.md) | 长按手势。 | +| [PanGesture](ts-basic-gestures-pangesture.md) | 平移手势，滑动最小距离为5vp时识别成功。 | +| [PinchGesture](ts-basic-gestures-pinchgesture.md) | 捏合手势。 | +| [RotationGesture](ts-basic-gestures-rotationgesture.md) | 旋转手势。 | +| [SwipeGesture](ts-basic-gestures-swipegesture.md) | 滑动手势，滑动最小速度为100vp/s时识别成功。 | +| [GestureGroup](ts-combined-gestures.md) | 手势识别组，多种手势组合为复合手势，支持连续识别、并行识别和互斥识别。 | -- GestureType +## GestureMask枚举说明 | 名称 | 描述 | | -------- | -------- | - | TapGesture | 点击手势，支持单次点击、多次点击识别。 | - | LongPressGesture | 长按手势。 | - | PanGesture | 平移手势，滑动最小距离为5vp时识别成功。 | - | PinchGesture | 捏合手势。 | - | RotationGesture | 旋转手势。 | - | SwipeGesture | 滑动手势，滑动最小速度为100vp/s时识别成功。 | - | GestureGroup | 手势识别组，多种手势组合为复合手势，支持连续识别、并行识别和互斥识别。 | + | Normal | 不屏蔽子组件的手势，按照默认手势识别顺序进行识别。 | + | IgnoreInternal | 屏蔽子组件的手势，仅当前容器的手势进行识别。
子组件上系统内置的手势不会被屏蔽，如子组件为List组件时，内置的滑动手势仍然会触发。 | ## 响应手势事件 -组件通过gesture方法绑定手势对象，可以通过手势对象提供的事件相应响应手势操作。例如通过TapGesture对象的onAction事件响应点击事件。其余手势的事件定义见各个手势对象章节。 +组件通过手势事件绑定不同GestureType的手势对象，各手势对象提供的事件响应手势操作，提供手势相关信息。下面通过TapGesture对象的onAction事件响应点击事件，获取事件相关信息。其余手势对象的事件定义见各个手势对象章节。 - TapGesture事件说明 | 名称 | 功能描述 | | -------- | -------- | | onAction((event?:GestureEvent) => void) | Tap手势识别成功回调。 | -- GestureEvent对象说明 +## GestureEvent对象说明 | 名称 | 类型 | 描述 | | -------- | -------- | -------- | | timestamp8+ | number | 事件时间戳。 | - | target8+ | [EventTarget](ts-universal-events-click.md) | 触发手势事件的元素对象显示区域。 | - | source8+ | SourceType | 事件输入设备。 | + | target8+ | [EventTarget](ts-universal-events-click.md#eventtarget8对象说明) | 触发手势事件的元素对象显示区域。 | + | source8+ | [SourceType](#sourcetype枚举说明) | 事件输入设备。 | | repeat | boolean | 是否为重复触发事件，用于LongPressGesture手势触发场景。 | - | fingerList8+ | FingerInfo[] | 触发事件的所有手指信息，用于LongPressGesture与TapGesture手势触发场景。 | - | offsetX | number | 手势事件x轴偏移量，单位为vp，用于PanGesture手势触发场景。 | - | offsetY | number | 手势事件y轴偏移量，单位为vp，用于PanGesture手势触发场景。 | + | fingerList8+ | [FingerInfo](#fingerinfo对象说明)[] | 触发事件的所有手指信息，用于LongPressGesture与TapGesture手势触发场景。 | + | offsetX | number | 手势事件x轴相对偏移量，单位为vp，用于PanGesture手势触发场景，从左向右滑动offsetX为正，反之为负。 | + | offsetY | number | 手势事件y轴相对偏移量，单位为vp，用于PanGesture手势触发场景，从上向下滑动offsetY为正，反之为负。 | | angle | number | 用于RotationGesture手势触发场景时，表示旋转角度；用于SwipeGesture手势触发场景时，表示滑动手势的角度，即两根手指间的线段与水平方向的夹角变化的度数。
>  **说明：**
> 角度计算方式：滑动手势被识别到后，连接两根手指之间的线被识别为起始线条，随着手指的滑动，手指之间的线条会发生旋转，根据起始线条两端点和当前线条两端点的坐标，使用反正切函数分别计算其相对于水平方向的夹角，最后arctan2(cy2-cy1,cx2-cx1)-arctan2(y2-y1,x2-x1)为旋转的角度。以起始线条为坐标系，顺时针旋转为0到180度，逆时针旋转为-180到0度。 | | speed8+ | number | 滑动手势速度，即所有手指滑动的平均速度，单位为vp/秒，用于SwipeGesture手势触发场景。 | | scale | number | 缩放比例，用于PinchGesture手势触发场景。 | - | pinchCenterX | number | 捏合手势中心点x轴坐标，单位为vp，用于PinchGesture手势触发场景。 | - | pinchCenterY | number | 捏合手势中心点y轴坐标，单位为vp，用于PinchGesture手势触发场景。 | + | pinchCenterX | number | 捏合手势中心点相对于当前组件元素左上角x轴坐标，单位为vp，用于PinchGesture手势触发场景。 | + | pinchCenterY | number | 捏合手势中心点相对于当前组件元素左上角y轴坐标，单位为vp，用于PinchGesture手势触发场景。 | -- SourceType +## SourceType枚举说明 | 名称 | 描述 | | -------- | -------- | | Unknown | 未知设备。 | | Mouse | 鼠标。 | | TouchScreen | 触摸屏。 | -- FingerInfo对象说明 +## FingerInfo对象说明 | 名称 | 类型 | 描述 | | -------- | -------- | -------- | | id | number | 手指的索引编号。 | diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-types.md b/zh-cn/application-dev/reference/arkui-ts/ts-types.md index e42576a16b71702d95444884446e59cd43ee7c6c..7909514b3e300b9aac38e4b370ebccf9519df4ae 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-types.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-types.md @@ -26,7 +26,7 @@ | -------- | -------------------------------------- | | string | 需要显式指定像素单位，如'10px'，也可设置百分比字符串，如'100%'。 | | number | 默认单位vp。 | -| [Resource](#resource) | 使用引入资源的方式，引入系统资源或者应用资源中的尺寸。 | +| [Resource](#resource) | 资源引用类型，引入系统资源或者应用资源中的尺寸。 | ## ResourceStr @@ -35,7 +35,7 @@ | 类型 | 说明 | | -------- | ---------------------------- | | string | 字符串类型。 | -| [Resource](#resource) | 使用引入资源的方式，引入系统资源或者应用资源中的字符串。 | +| [Resource](#resource) | 资源引用类型，引入系统资源或者应用资源中的字符串。 | ## Padding @@ -43,10 +43,10 @@ | 名称 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | --------------- | -| top | [Length](#length) | 否 | 组件内元素距组件顶部的尺寸。 | -| right | [Length](#length) | 否 | 组件内元素距组件右边界的尺寸。 | -| bottom | [Length](#length) | 否 | 组件内元素距组件底部的尺寸。 | -| left | [Length](#length) | 否 | 组件内元素距组件左边界的尺寸。 | +| top | [Length](#length) | 否 | 上内边距，组件内元素距组件顶部的尺寸。 | +| right | [Length](#length) | 否 | 右内边距，组件内元素距组件右边界的尺寸。 | +| bottom | [Length](#length) | 否 | 下内边距，组件内元素距组件底部的尺寸。 | +| left | [Length](#length) | 否 | 左内边距，组件内元素距组件左边界的尺寸。 | ## Margin @@ -54,10 +54,10 @@ | 名称 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | --------------- | -| top | [Length](#length) | 否 | 组件外元素距组件顶部的尺寸。 | -| right | [Length](#length) | 否 | 组件外元素距组件右边界的尺寸。 | -| bottom | [Length](#length) | 否 | 组件外元素距组件底部的尺寸。 | -| left | [Length](#length) | 否 | 组件外元素距组件左边界的尺寸。 | +| top | [Length](#length) | 否 | 上外边距，组件顶部距组件外元素的尺寸。 | +| right | [Length](#length) | 否 | 右外边距，组件右边界距组件外元素的尺寸。 | +| bottom | [Length](#length) | 否 | 下外边距，组件底部距组件外元素的尺寸。 | +| left | [Length](#length) | 否 | 坐外边距，组件左边界距组件外元素的尺寸。 | ## EdgeWidths9+ diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-component-area-change-event.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-component-area-change-event.md index 315aa13fb970b2e9cdd43fd7864820b995da29e1..fb78261211c4b65798427d16c61372b017f0c043 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-component-area-change-event.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-component-area-change-event.md @@ -11,7 +11,7 @@ | 名称 | 支持冒泡 | 功能描述 | | ---------------------------------------- | ---- | ---------------------------------------- | -| onAreaChange(event: (oldValue: Area, newValue: Area) => void) | 否 | 组件区域变化时触发该回调，Area类型描述见[Area](ts-types.md#area8)。 | +| onAreaChange(event: (oldValue: [Area](ts-types.md#area8), newValue: [Area](ts-types.md#area8)) => void) | 否 | 组件区域变化时触发该回调。 | ## 示例 @@ -22,7 +22,7 @@ @Component struct AreaExample { @State value: string = 'Text' - @State size1: string = '' + @State sizeValue: string = '' build() { Column() { @@ -33,9 +33,9 @@ struct AreaExample { }) .onAreaChange((oldValue: Area, newValue: Area) => { console.info(`Ace: on area change, oldValue is ${JSON.stringify(oldValue)} value is ${JSON.stringify(newValue)}`) - this.size1 = JSON.stringify(newValue) + this.sizeValue = JSON.stringify(newValue) }) - Text('new area is: \n' + this.size).margin({ right: 30, left: 30 }) + Text('new area is: \n' + this.sizeValue).margin({ right: 30, left: 30 }) } .width('100%').height('100%').margin({ top: 30 }) } diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-component-visible-area-change-event.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-component-visible-area-change-event.md index 79082fc267134cf0fcc252fd881812dd10879c38..c61fbf86b163080febedb7228e8bc40c68db5984 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-component-visible-area-change-event.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-component-visible-area-change-event.md @@ -1,6 +1,6 @@ # 组件可见区域变化事件 -组件可见区域变化事件指组件在屏幕中显示的面积变化，提供了判断组件是否完全或部分显示在屏幕中的能力，通常适用于像广告曝光埋点之类的场景。 +组件可见区域变化事件是组件在屏幕中的显示区域面积变化时触发的事件，提供了判断组件是否完全或部分显示在屏幕中的能力，适用于广告曝光埋点之类的场景。 > **说明：** > diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md index 725e0516b54a675d2d528f68ba4cf727f7df9d09..ecbbb9c7c8539d76e8d893b7ef71f1de96af1a94 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md @@ -1,12 +1,13 @@ # 按键事件 -按键事件指组件与键盘、遥控器等按键设备交互时触发的事件。 +按键事件指组件与键盘、遥控器等按键设备交互时触发的事件，适用于所有可交互组件（默认可获焦），例如Button。对于Text，Image等不可获焦组件，可以设置focasable属性为true后使用按键事件。 > **说明：** > > 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 + ## 事件 | 名称 | 支持冒泡 | 功能描述 | diff --git a/zh-cn/application-dev/ui/arkui-overview.md b/zh-cn/application-dev/ui/arkui-overview.md index 52410dd81e71b4ff9ee6a24aab982feec0f43500..b3244601362b918dda4d9666016607459dab4003 100644 --- a/zh-cn/application-dev/ui/arkui-overview.md +++ b/zh-cn/application-dev/ui/arkui-overview.md @@ -39,4 +39,4 @@ ![zh-cn_image_0000001183709904](figures/zh-cn_image_0000001183709904.png) -从上图可以看出，类Web开发范式与声明式开发范式的UI后端引擎和语言运行时是共用的，其中，UI后端引擎实现了方舟开发框架的六种基本能力。声明式开发范式无需JS Framework进行页面DOM管理，渲染更新链路更为精简，占用内存更少，因此更推荐开发者选用声明式开发范式来搭建应用UI界面。 +从上图可以看出，类Web开发范式与声明式开发范式的UI后端引擎和语言运行时是共用的，其中，UI后端引擎实现了方舟开发框架的六种基本能力。声明式开发范式无需JS Framework进行页面DOM管理，渲染更新链路更为精简，占用内存更少，因此更推荐开发者选用声明式开发范式来搭建应用UI界面。 \ No newline at end of file diff --git a/zh-cn/application-dev/ui/ts-framework-directory.md b/zh-cn/application-dev/ui/ts-framework-directory.md index b4a7b831db8239dede96749a1bd7a19a0419cc23..b13a985ef43221a48e4aea44e23600dd5b311db1 100644 --- a/zh-cn/application-dev/ui/ts-framework-directory.md +++ b/zh-cn/application-dev/ui/ts-framework-directory.md @@ -1,7 +1,6 @@ # 目录结构 - FA应用的eTS模块(entry/src/main)的典型开发目录结构如下： @@ -16,10 +15,9 @@ FA应用的eTS模块(entry/src/main)的典型开发目录结构如下： **各个文件夹和文件的作用：** - - **app.ets**文件用于全局应用逻辑和应用生命周期管理。 -- **pages**目录用于存放所有组件页面。 +- **pages**目录用于存放所有页面。 - **common**目录用于存放公共代码文件，比如：自定义组件和公共方法。 diff --git a/zh-cn/application-dev/ui/ts-framework-file-access-rules.md b/zh-cn/application-dev/ui/ts-framework-file-access-rules.md index f792bb37ff8e84fc1f2723139b65ffac1dec17c9..1ba9df06983dcadbe59fd6d710fa74376b7468af 100644 --- a/zh-cn/application-dev/ui/ts-framework-file-access-rules.md +++ b/zh-cn/application-dev/ui/ts-framework-file-access-rules.md @@ -1,17 +1,24 @@ -# 应用代码文件访问规则 +# 文件访问规则 +应用代码中文件访问方法主要有下面两种： -应用代码文件可通过如下方式访问： +- **相对路径**：使用相对路径引用代码文件，以"../"访问上一级目录，以"./"访问当前目录，也可以省略不写。 +- **绝对路径**：使用当前模块根路径引用代码文件，比如：common/utils/utils。 -- 使用相对路径引用代码文件，比如：上一级目录：../common/utils/utils，当前目录：./common/utils/utils。 -- 使用当前模块根路径引用代码文件，比如：common/utils/utils。 - -- 公共代码文件推荐放在**common**目录下。 ## 示例 - +``` +MainAbility +├─ app.ets +├─ common +│ └─ utils +│ └─ utils.ets +└─ pages + └─ index.ets +``` +如上所示，将utils放在common中,示例中index.ets访问utils.ets文件 ```ts // xxx.ets import { FoodData, FoodList } from "../common/utils/utils"; @@ -32,11 +39,10 @@ struct FoodCategoryList { } ``` -导入文件示例： +被导入文件utils.ets： ```ts //common/utils/utils.ets - export class FoodData { name: string; constructor(name: string) { diff --git a/zh-cn/application-dev/ui/ts-pixel-units.md b/zh-cn/application-dev/ui/ts-pixel-units.md index eda7b03168d427675641436eeeef4cf75fed7de2..519a4322eea0ae221078144e959e0036420bc948 100644 --- a/zh-cn/application-dev/ui/ts-pixel-units.md +++ b/zh-cn/application-dev/ui/ts-pixel-units.md @@ -6,9 +6,9 @@ | 名称 | 描述 | | ---- | ---------------------------------------- | | px | 屏幕物理像素单位。 | -| vp | 屏幕密度相关像素，根据屏幕像素密度转换为屏幕物理像素。 | +| vp | 屏幕密度相关像素，根据屏幕像素密度转换为屏幕物理像素，当数值不带单位时，默认单位vp。 | | fp | 字体像素，与vp类似适用屏幕密度变化，随系统字体大小设置变化。 | -| lpx | 视窗逻辑像素单位，lpx单位为实际屏幕宽度与逻辑宽度（通过[designWidth](../ui/ts-framework-js-tag.md)配置）的比值。如配置designWidth为720时，在实际宽度为1440物理像素的屏幕上，1lpx为2px大小。 | +| lpx | 视窗逻辑像素单位，lpx单位为实际屏幕宽度与逻辑宽度（通过[designWidth](../ui/ts-framework-js-tag.md)配置）的比值，designWidth默认值为720。当designWidth为720时，在实际宽度为1440物理像素的屏幕上，1lpx为2px大小。 | ## 像素单位转换 diff --git a/zh-cn/application-dev/ui/ts-resource-access.md b/zh-cn/application-dev/ui/ts-resource-access.md index 225e42f56334ccd5f4cbb9cf94e752cda0f155e5..5ab95b5eba3fbf1a325dea0b9f6fdd7a10ba6193 100644 --- a/zh-cn/application-dev/ui/ts-resource-access.md +++ b/zh-cn/application-dev/ui/ts-resource-access.md @@ -8,7 +8,7 @@ 引用rawfile下资源时使用```"$rawfile('filename')"```的形式，filename需要表示为rawfile目录下的文件相对路径，文件名需要包含后缀，路径开头不可以以"/"开头。 > **说明：** -> +> > 资源描述符不能拼接使用，仅支持普通字符串如`'app.type.name'`。 > > `$r`返回值为Resource对象，可通过[getString](../reference/apis/js-apis-resource-manager.md#getstring) 方法获取对应的字符串。 diff --git a/zh-cn/application-dev/ui/ui-ts-basic-resource-file-categories.md b/zh-cn/application-dev/ui/ui-ts-basic-resource-file-categories.md index a162017315d13a063d7d5e7cb5fa0f7369af8d5f..ce7f75e31dfafb476db3bb186859ac1351f44348 100644 --- a/zh-cn/application-dev/ui/ui-ts-basic-resource-file-categories.md +++ b/zh-cn/application-dev/ui/ui-ts-basic-resource-file-categories.md @@ -25,7 +25,7 @@ resources **表1** resources目录分类 -| 分类 | base目录与限定词目录 | 限定词目录 | rawfile目录 | +| 分类 | base目录 | 限定词目录 | rawfile目录 | | ---- | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- | | 组织形式 | base目录是默认存在的目录。当应用的resources目录中没有与设备状态匹配的限定词目录时，会自动引用该目录中的资源文件。
base目录的二级子目录为**资源组目录**，用于存放字符串、颜色、布尔值等基础元素，以及媒体、动画、布局等资源文件，具体要求参见[资源组目录](#资源组目录)。 | 限定词目录需要开发者自行创建。目录名称由一个或多个表征应用场景或设备特征的限定词组合而成，具体要求参见[限定词目录](#限定词目录)。
限定词目录的二级子目录为**资源组目录**，用于存放字符串、颜色、布尔值等基础元素，以及媒体、动画、布局等资源文件，具体要求参见[资源组目录](#资源组目录)。 | 支持创建多层子目录，目录名称可以自定义，文件夹内可以自由放置各类资源文件。
rawfile目录的文件不会根据设备状态去匹配不同的资源。 | | 编译方式 | 目录中的资源文件会被编译成二进制文件，并赋予资源文件ID。 | 目录中的资源文件会被编译成二进制文件，并赋予资源文件ID。 | 目录中的资源文件会被直接打包进应用，不经过编译，也不会被赋予资源文件ID。 |