鸿蒙5.0开发进阶:JS组件-通用事件

【鸿蒙(HarmonyOS)】UI开发的两种范式:ArkTS、JS(以登录界面开发为例进行对比) 对比较于Android:ArkUI将界面设计和具体操作放到的一个文件中(当然ArkUI有组件自定义,这个就另当别论),这个方式比较新颖。HTML、CSS、JS这一套技术,相信很多IT人都已经非常熟悉,这也是我能快速入手HarmonyOS的重要因素。根据官方介绍,ArkUI提供了UI语法、丰富的UI功能(组件、布局、动画以及交互事件),以及实时界面预览工具等,可以支持开发者进行可视化界面开发。ArkTS我也仅仅学习了四个月,相比较我在使用JS开发UI界面上而言,有所偏弱。功能的话,推荐使用ArkTS。 阅读详情

往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


通用事件

说明

从API version 4开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

事件说明

  • 事件绑定在组件上,当组件达到事件触发条件时,会执行JS中对应的事件回调函数,实现页面UI视图和页面JS逻辑层的交互;

  • 事件回调函数中通过参数可以携带额外的信息,如组件上的数据对象dataset,事件特有的回调参数。

相对于私有事件,大部分组件都可以绑定如下事件。

名称参数描述是否支持冒泡是否支持捕获
touchstartTouchEvent手指刚触摸屏幕时触发该事件。TouchEvent具体可参考表2 。是5+是5+
touchmoveTouchEvent手指触摸屏幕后移动时触发该事件。是5+是5+
touchcancelTouchEvent手指触摸屏幕中动作被打断时触发该事件。是5+是5+
touchendTouchEvent手指触摸结束离开屏幕时触发该事件。是5+是5+
clickBaseEvent点击动作触发该事件。是6+否
doubleclick7+BaseEvent双击动作触发该事件

否

从API Version 9 开始支持冒泡。

否
longpressBaseEvent长按动作触发该事件。

否

从API Version 9 开始支持冒泡。

否
swipe5+SwipeEvent组件上快速滑动后触发该事件。 SwipeEvent具体可参考表4 。

否

从API Version 9 开始支持冒泡。

否
attached6+-当前组件节点挂载在渲染树后触发。否否
detached6+-当前组件节点从渲染树中移除后触发。否否
pinchstart7+PinchEvent

手指开始执行捏合操作时触发该事件。

PinchEvent具体可参考表5。

否否
pinchupdate7+PinchEvent手指执行捏合操作过程中触发该事件。否否
pinchend7+PinchEvent手指捏合操作结束离开屏幕时触发该事件。否否
pinchcancel7+PinchEvent手指捏合操作被打断时触发该事件。否否
dragstart7+DragEvent

用户开始拖拽时触发该事件。

DragEvent具体可参考表6。

否否
drag7+DragEvent拖拽过程中触发该事件。否否
dragend7+DragEvent用户拖拽完成后触发。否否
dragenter7+DragEvent进入释放目标时触发该事件。否否
dragover7+DragEvent在释放目标内拖动时触发。否否
dragleave7+DragEvent离开释放目标区域时触发。否否
drop7+DragEvent在可释放目标区域内释放时触发。否否

说明

除上述事件外,其他事件均为非冒泡事件,如input的change事件,详见各个组件。

表1 BaseEvent对象属性列表

属性类型说明
typestring当前事件的类型,比如click、longpress等。
timestampnumber该事件触发时的时间戳。
deviceId6+number触发该事件的设备ID信息。
target6+Target触发该事件的目标对象。

表2 TouchEvent对象属性列表(继承BaseEvent)

属性类型说明
touchesArray<TouchInfo>触摸事件时的属性集合,包含屏幕触摸点的信息数组。
changedTouchesArray<TouchInfo>触摸事件时的属性集合,包括产生变化的屏幕触摸点的信息数组。数据格式和touches一样。该属性表示有变化的触摸点,如从无变有,位置变化,从有变无。例如用户手指刚接触屏幕时,touches数组中有数据,但changedTouches无数据。

表3 TouchInfo

属性类型说明
globalXnumber距离屏幕左上角(不包括状态栏)横向距离。屏幕的左上角为原点。
globalYnumber距离屏幕左上角(不包括状态栏)纵向距离。屏幕的左上角为原点。
localXnumber距离被触摸组件左上角横向距离。组件的左上角为原点。
localYnumber距离被触摸组件左上角纵向距离。组件的左上角为原点。
sizenumber触摸接触面积。
force6+number接触力信息。

表4 SwipeEvent 基础事件对象属性列表(继承BaseEvent)

属性类型说明
directionstring

滑动方向,可能值有:

- left:向左滑动;

- right:向右滑动;

- up:向上滑动;

- down:向下滑动。

distance6+number在滑动方向上的滑动距离。

表5 PinchEvent 对象属性列表7+

属性类型说明
scalenumber缩放比例
pinchCenterXnumber捏合中心点X轴坐标,单位px
pinchCenterYnumber捏合中心点Y轴坐标,单位px

表6 DragEvent对象属性列表(继承BaseEvent)7+

属性类型说明
typestring事件名称。
globalXnumber距离屏幕左上角坐标原点横向距离。
globalYnumber距离屏幕左上角坐标原点纵向距离。
timestampnumber时间戳。
dataTransfer9+DataTransfer用于传输数据。

Target对象6+

当组件触发事件后,事件回调函数默认会收到一个事件对象,通过该事件对象可以获取相应的信息。

属性类型说明
dataSet6+Object组件上通过通用属性设置的data-*的自定义属性组成的集合。

示例:

<!-- xxx.hml -->
<div>
  <div data-a="dataA" data-b="dataB" 
    style="width: 100%; height: 50%; background-color: saddlebrown;"@touchstart='touchstartfunc'></div>
</div>
// xxx.js
export default {
  touchstartfunc(msg) {
    console.info(`on touch start, point is: ${msg.touches[0].globalX}`);
    console.info(`on touch start, data is: ${msg.target.dataSet.a}`);
  }
}

DataTransfer对象9+

在拖拽操作的过程中,可以通过dataTransfer对象来传输数据,以便在拖拽操作结束的时候对数据进行其他操作。

setData9+

setData(key: string, value: object): boolean

设置给定key关联的数据。如果没有与该key关联的数据,则将其添加到末尾。如果该key关联的数据已经存在,则在相同位置替换现有数据。

参数:

参数名参数类型必填描述
keystring是数据键值。
valueobject是要存储的数据。

返回值:

类型说明
boolean执行结果,true表示成功,false表示失败。

示例:

// setData的value参数,可以是基本数据类型。
dragStart(e) {
    var isSetOk = e.dataTransfer.setData('name', 1);
},
// setData的value参数,也可以是对象类型。
dragStart(e) {
    var person = new Object();
    person.name = "tom";
    person.age = 21;
    var isSetOk = e.dataTransfer.setData('person', person);
}

getData9+

getData(key: string): object

获取给定key关联的数据,如果没有与该key关联的数据,则返回空字符串。

参数:

参数名参数类型必填描述
keystring是数据键值。

返回值:

类型说明
object获取的数据。

示例:

dragStart(e) {
    var person = new Object();
    person.name = "tom";
    person.age = 21;
    e.dataTransfer.setData('person', person);
},
dragEnd(e){
    var person = e.dataTransfer.getData('person');
},

clearData9+

clearData(key?: string): boolean

删除给定key关联的数据。如果没有与该key关联的数据,则该方法不会产生任何效果。

如果key为空,则删除所有数据。

参数:

参数名参数类型必填描述
keystring否数据键值。

返回值:

类型说明
boolean执行结果,true表示成功,false表示失败。

示例:

dragEnd(e) {
    var isSuccess = e.dataTransfer.clearData('name');
}

setDragImage9+

setDragImage(pixelmap: PixelMap, offsetX: number,offsetY: number): boolean

用于设置自定义的拖动图像。

参数:

参数名参数类型必填描述
pixelmapPixelMap是前端传入的图片资源。
offsetXnumber是相对于图片的横向偏移量。
offsetYnumber是相对于图片的纵向偏移量。

返回值:

类型说明
boolean执行结果,true表示成功,false表示失败。

示例:

import image from '@ohos.multimedia.image';

export default {
    createPixelMap() {
        let color = new ArrayBuffer(4 * 96 * 96);
        var buffer = new Uint8Array(color);
        for (var i = 0; i < buffer.length; i++) {
            buffer[i] = (i + 1) % 255;
        }
        let opts = {
            alphaType: 0,
            editable: true,
            pixelFormat: 4,
            scaleMode: 1,
            size: {
                height: 96, width: 96
            }
        }
        const promise = image.createPixelMap(color, opts);
        promise.then((data) => {
            console.error('-create pixmap has info message:' + JSON.stringify(data));
            this.pixelMap = data;
            this.pixelMapReader = data;
        })
    },

    onInit() {
        this.createPixelMap
    },

    dragStart(e) {
        e.dataTransfer.setDragImage(this.pixelMapReader, 50, 50);
    }
}

鸿蒙HarmonyOS实战:JS组件通用事件规范总结 事件回调函数中通过参数可以携带额外的信息,如组件上的数据对象dataset,事件特有的回调参数。 阅读详情

相关推荐

鸿蒙5.0版开发:UI框架JS组件-通用事件

通用事件.......

m0_69424697的博客 1217

HarmonyOS 鸿蒙应用开发(十一、面向鸿蒙开发的JavaScript基础)

网络上介绍鸿蒙应用TypeScript语言学习的文章已经很多了,但唯独对JavaScript基础介绍偏少。这里补充介绍一下,觉得有帮助的小伙伴可以点击收藏。 ArkTS 是 TypeScript 的一种扩展版本,而 TypeScript 本身就是 JavaScript 的超集。这意味着 ArkTS 保留了大部分 JavaScript 的语法和编程范式。因此JavaScript 不仅是前端开发的核心,还在鸿蒙应用中扮演着重要角色。

猫哥 的沉淀、积累、总结。天天学习,好好向上...c/c++,嵌入式 linux,Android,HarmonyOS,AIOT) 4411

鸿蒙5.0版开发:UI框架JS组件-通用方法

当组件通过id属性标识后,可以使用该id获取组件对象并调用相关组件方法。

m0_69424697的博客 1112

JSBridge 之 Web 端与 App 交互 - 鸿蒙 HarmonyOS Next

JSBridge 之 Web 端与 App 交互 - 鸿蒙 HarmonyOS Next

survivorsfyh的博客 2025

鸿蒙5.0版开发:UI框架JS组件-容器组件(swiper)

滑动容器,提供切换子组件显示的能力。

m0_69424697的博客 1060

鸿蒙5.0版开发:UI框架JS组件-通用样式

组件普遍支持的可以在style或css中设置组件外观样式。

m0_69424697的博客 899

鸿蒙5.0开发进阶:JS服务卡片UI组件通用信息-通用事件

相对于私有事件,大部分组件都可以绑定如下事件。

Androidbye的博客 265

HarmonyOS鸿蒙开发指南:兼容JS的类Web开发范式 JS语法参考

JS文件用来定义HML页面的业务逻辑,支持ECMA规范的JavaScript语言。基于JavaScript语言的动态化能力,可以使应用更加富有表现力,具备更加灵活的设计能力。下面讲述JS文件的编译和运行的支持情况。

斌擎科技 1401

【华为鸿蒙系统学习】- HarmonyOS4.0开发|自学篇

本篇博客主要介绍了华为的鸿蒙系统(HarmonyOS4.0)的发布,三大特征,技术架构,技术特性

“路漫漫其修远兮,吾将上下求索。” 2万+

《HarmonyOS实战——前端开发华为鸿蒙系统应用 OpenHarmony JS》

导读:一款“面向未来”、面向全场景(移动办公、运动健康、社交通信、媒体娱乐等)的分布式操作系统 。现已开源,名为 OpenHarmony。2019 年 8 月 9 日,华为在 HDC 开发...

孙叫兽的博客 1万+

电赛2024年H题智能小车基于MSPM0G3507主控MCU(利用8路灰度加上MPU6050的解决方式)

最后我觉得这个项目最重要的部分还是陀螺仪的精准度,如果一个陀螺仪的精准度高,这个项目就十分简单了,像mpu6050这种陀螺仪精准度就稍微差了一点,他有个最严重的问题就是温漂,偏航角会随着温度变化为变化,这一点在跑发挥项一的时候十分关键的,因为这个只差基督就会导致车子跑偏,导致无法完成 整个项目。如果条件足够的话建议可以换一个好一点的陀螺仪,然后就是灰度如果没有条件同样也可以换成红外。以上就是本次项目的一些小建议。

weixin_60991529的博客 6244

(HarmonyOS5.0) 华为鸿蒙开发学习实战教程

《HarmonyOS5.0实战学习指南》摘要 本文介绍了基于HarmonyOS5.0开发"个人健康助手"应用的完整教程。首先详细讲解了开发环境搭建和SDK配置,强调版本兼容性。核心内容包括:基础功能开发(数据展示、目标管理)、HarmonyOS5.0新特性集成(状态管理增强、分布式能力、元服务卡片)以及项目优化测试(性能、兼容性、自动化测试)。教程采用项目驱动方式,通过健康数据同步、多设备协同等场景展示5.0特性应用,并提供了性能优化方案和测试策略。最后总结了开发经验,提出了功能扩展建议

2501_93207838的博客 1580

STM32 AFIO时钟开启时机与复用功能解析

在嵌入式系统开发中,GPIO复用是微控制器外设配置的核心技术之一。通过复用功能,单个物理引脚可以动态切换不同功能模式,如USART通信或普通IO。其实现原理依赖于芯片内部的时钟树架构和寄存器配置机制。AFIO(Alternate Function I/O)模块作为STM32的特色设计,专门处理引脚重映射、外部中断配置等高级功能。正确理解复用功能与AFIO时钟的关系,能显著提升嵌入式开发效率,避免资源浪费。本文以STM32为例,结合引脚重映射和USART配置等典型场景,详解AFIO时钟的实际应用规范与优化实践

weixin_42389113的博客 579

鸿蒙5.0开发进阶:JS组件-通用属性

常规属性是指组件普遍支持的用来设置组件基本标识和外观显示特征的属性。

Androidbye的博客 992

【网络协议】TCP的拥塞控制机制

前言 计算机网络中的带宽、交换节点中的缓存和处理机等,都是网络的资源,在某段时间内,若对网络中某一资源的需求超过了该资源所能提供的可用部分,网络的性能就要变坏,这种情况就叫做拥塞。 所谓拥塞控制,就是防止过多的数据注入到网络中,从而使网络中的路由器或链路不致过载。要注意用拥塞控制与流量控制的区别,拥塞控制是一个全局性的过程,涉及到所有的额主机、路由器,以及与降低网 拥塞控制的算法有:慢开始、拥塞避免、快重传、快恢复四种。 慢开始和拥塞避免 发送方维持一个拥塞窗口的状态变量,其大小取决于网络的拥塞程度

兰亭风雨的专栏 1万+

【MDC开发者实战】多传感器融合算法在自动驾驶中的配置与优化

本文详细介绍了华为MDC平台在自动驾驶中多传感器融合算法的配置与优化实践。通过前融合与后融合技术,结合摄像头、激光雷达和毫米波雷达的数据,提升感知精度与可靠性。文章还分享了ARXML配置、标定技巧、算法调优及性能优化等实战经验,帮助开发者高效实现自动驾驶系统的传感器融合。

weixin_29214199的博客 517

鸿蒙5.0开发进阶:JS组件-通用样式

组件普遍支持的可以在style或css中设置组件外观样式。

Androidbye的博客 806

IEC 62061 总结与适用范围

IEC 62061 是国际电工委员会(IEC)制定的。

cactusDaYe的博客 1084

鸿蒙5.0开发进阶:JS组件-swiper

滑动容器,提供切换子组件显示的能力。

Androidbye的博客 1069

Windows 11 WSL2环境下OpenClaw部署的兼容性问题分析与解决方案研究

本文研究了OpenClaw在Windows 11 WSL2环境下的部署方案。WSL2通过无缝集成Linux与Windows系统,为OpenClaw提供了良好的运行环境,支持GPU加速和跨平台开发。文章详细分析了硬件配置要求(推荐8核CPU/16GB内存/NVMe SSD)、系统选择(Windows 11 Pro+Ubuntu 22.04)以及部署步骤,包括WSL2启用、Linux发行版安装、Python/Node.js/Redis等依赖配置。通过优化.wslconfig文件参数(如内存分

博客 2284

scratch经典游戏主题源码分享,包含了20多款经典游戏

经典游戏案例:1、360度角度射击游戏 2、捕鱼达人 3、超级马里奥 4、超级玛丽 5、吃豆人相关 6、穿着喷气背包的海龟 7、大鱼吃小鱼 8、俄罗斯方块 9、飞机大战 10、愤怒的小鸟 11、黄金矿工 12、节奏大师 13、连连看 14、迷宫游戏 15、跑酷游戏 16、扫雷 17、水果忍者 18、坦克大战 19、推箱子 20、消除泡泡 21、保卫萝卜 22、植物大战僵尸

IT_Scratch的博客 1万+

鸿蒙5.0开发进阶:JS组件-通用方法

当组件通过id属性标识后,可以使用该id获取组件对象并调用相关组件方法。

Androidbye的博客 696

深入浅出讲解外部服务提供者 OAuth 2.0 帐户客户端创建与 ABAP 系统集成

本文详细介绍了在SAP ABAP平台配置OAuth 2.0客户端以安全调用外部Web服务的完整流程。主要内容包括:首先需要在外部服务提供者平台注册OAuth客户端,获取client ID和client secret;其次需特别注意重定向URI必须是公开可访问的地址;然后在ABAP系统中通过事务码OA2C_CONFIG配置OAuth客户端信息;最后阐述了常见的错误排查方法。文章强调了OAuth 2.0作为SAP系统与外部服务安全集成的标准协议,正确配置客户端是确保后续API调用安全可靠的关键前提。

2007 年 ~ 2025 年,深耕 SAP 技术 18 年 1735

【鸿蒙next开发】JS组件:组件通用信息(通用方法)

本文全面介绍鸿蒙5.0动画开发核心API,重点解析animate方法实现组件动画效果。

m0_73088370的博客 1065

android 蓝牙通讯demo

android 下蓝牙通讯demo,实现了发现蓝牙,使能蓝牙,通过蓝牙发送消息。

C# WinForm 基于DirectShow.dll编写的程序,可边预览边保存视频,音频和图片

基于微软的DirectShow.dll的二次开发1.自动识别连接的摄像头跟麦克风且可以对其进行选择(默认选中第一个)2.可录制wmv和avi两种格式的视频并且都带有音频,avi可以录制的分辨率和帧数进行选择,wmv默认进行了淸晰度优化如不喜欢可去除代码中有相关提示3.可在预览点开之后进行拍照,也可边录制视频边拍照4.添加了视频和音频的压缩功能(酌情使用)这次二次开发发现C#对DirectShow的相关信息太少,这次做完也不敢藏私共享出来,还望大家指正

上一篇: 鸿蒙5.0开发进阶:JS组件-通用样式
下一篇: 鸿蒙5.0开发进阶:JS组件-通用方法
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值