阅读(1031)
赞(0)
鸿蒙OS 组件通用事件
2020-09-17 14:57:23 更新
相对于私有事件，大部分组件都可以绑定如下事件。
| 名称 | 参数 | 描述 |
|---|---|---|
| touchstart | TouchEvent | 手指刚触摸屏幕时触发该事件。 |
| touchmove | TouchEvent | 手指触摸屏幕后移动时触发该事件。 |
| touchcancel | TouchEvent | 手指触摸屏幕中动作被打断时触发该事件。 |
| touchend | TouchEvent | 手指触摸结束离开屏幕时触发该事件。 |
| click | - | 点击动作触发该事件。 |
| longpress | - | 长按动作触发该事件。 |
| focus | - | 获得焦点时触发该事件，span组件无法获取焦点。 |
| blur | - | 失去焦点时触发该事件，span组件无法失去焦点。 |
| key | KeyEvent | 智慧屏特有的按键事件，当用户操作遥控器按键时触发。返回true表示页面自己处理按键事件。返回false表示使用默认的按键事件逻辑。不返回值作为false处理。 |
| 属性 | 类型 | 说明 |
|---|---|---|
| type | string | 当前事件的类型，比如click、longpress等。 |
| timestamp | number | 该事件触发时的时间戳。 |
| 属性 | 类型 | 说明 |
|---|---|---|
| touches | Array<Object> | 触摸事件时的属性集合，包含屏幕触摸点的信息数组。 |
| changedTouches | Array<Object> | 触摸事件时的属性集合，包括产生变化的屏幕触摸点的信息数组。数据数据格式和touches一样。该属性表示有变化的触摸点，如从无变有，位置变化，从有变无。例如用户手指刚接触屏幕时，touches数组中有数据，但changedTouches无数据。 |
| 属性 | 类型 | 说明 |
|---|---|---|
| globalX | number | 距离屏幕左上角（不包括状态栏）横向距离。屏幕的左上角为原点。 |
| globalY | number | 距离屏幕左上角（不包括状态栏）纵向距离。屏幕的左上角为原点。 |
| localX | number | 距离被触摸组件左上角横向距离。组件的左上角为原点。 |
| localY | number | 距离被触摸组件左上角纵向距离。组件的左上角为原点。 |
| size | number | 触摸接触面积。 |
| 属性 | 类型 | 说明 |
|---|---|---|
| code | number | 智慧屏遥控器的按键值。常用按键值详见表5。 |
| action | number | 按键事件的按键类型：0：down1：up2：multiple用户点击一个遥控器按键，通常会触发两次key事件，先触发down事件，再触发up事件。当用户按下按键不放手时，action为2，此时repeatCount将返回次数。 |
| repeatCount | number | 按键重复次数。 |
| timestampStart | number | 按键按下时的时间戳。 |
| 数值 | 行为 | 物理按键 |
|---|---|---|
| 19 | 上 | 向上方向键 |
| 20 | 下 | 向下方向键 |
| 21 | 左 | 向左方向键 |
| 22 | 右 | 向右方向键 |
| 23 | 确定 | 智慧屏遥控器的确认键 |
| 66 | 确定 | 键盘的回车键 |
| 160 | 确定 | 键盘的小键盘回车键 |