当前位置:首页 > 技术 > 正文内容

HarmonyOS 触控交互机制解析

访客 技术 2026年6月10日 1

触控交互机制涉及用户通过手指或手写笔在设备上进行的按下、滑动和释放操作,这些动作会触发相应的事件回调,包括单击、触摸和拖拽等类型。

1.1 单击操作

单击行为指用户完成按压与松开的完整动作,系统会通过特定回调函数传递坐标信息及事件源数据。

onTap(event: (event?: TapEvent) => void)

1.1.1 实现流程

实现触控响应需遵循以下步骤:

  1. 创建视图组件并设置唯一标识
  2. 绑定对应交互事件
  3. 实现事件处理接口
  4. 完成具体业务逻辑编写

1.1.2 事件绑定方式

(1)使用箭头函数直接绑定

Text('Tap Me')
  .onTap(() => {
    this.displayText = 'ArkUI';
  })

(2)通过bind绑定上下文的匿名函数

Text('Add Value')
  .onTap(function() {
    this.counter += 2;
  }.bind(this))

(3)引用类方法进行绑定

handleValueChange(): void {
  this.counter += 2;
}
Text('Add Value')
  .onTap(this.handleValueChange.bind(this))

(4)声明式函数绑定

updateCounter = () => {
  console.info(`Current: ${this.counter}`);
  this.counter++;
}
Text('Increment')
  .onTap(this.updateCounter)

1.1.3 示例代码

import { promptAction, router } from '@kit.ArkUI'
import { RouterParams } from '@zzsKit/zzsLib'
import { TitleBar } from '../../../components/common/TitleBar'

@Extend(Text)
function itemStyle() {
  .fontSize(17)
  .backgroundColor($r('app.color.primary_green'))
  .padding({ top: 8, bottom: 8, left: 70, right: 70 })
  .margin({ top: 15, bottom: 15 })
}

@Entry
@Component
struct TouchPage {
  @State title: string = "触控示例"
  @State displayText: string = '等待操作'

  aboutToAppear() {
    try {
      this.title = (router.getParams() as RouterParams).title
    } catch (e) {}
  }

  handleTap() {
    promptAction.showToast({ message: "触发操作" });
    this.displayText = "已点击";
  }

  handleDetailedTap(event: TapEvent) {
    promptAction.showToast({ message: "详细事件" });
    this.displayText = `坐标:${JSON.stringify(event)}`;
  }

  build() {
    Column() {
      TitleBar({ pageTitle: $title })
      Text('测试按钮')
        .itemStyle()
        .onTap((event: TapEvent) => {
          this.displayText = "按钮1";
          promptAction.showToast({ message: "按钮1" });
        })
      Text('按钮2')
        .itemStyle()
        .onTap(() => this.handleTap?.())
      Text('按钮3')
        .itemStyle()
        .onTap(() => this.handleTap())
      Text('按钮4')
        .itemStyle()
        .onTap((event: TapEvent) =>

相关文章

Linux crontab 详解

1) crontab 是什么cron 是 Linux 的定时任务守护进程;crontab 是用来编辑/查看“按时间周期执行命令”的表(cron table)。常见两类:用户 crontab:每个用户一份(crontab -e 编辑)系统级 crontab / cron.d:可指定执行用户(/etc/crontab、/etc/cron.d/*)2) crontab 时间...

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性(极少)class        (可选)id           (通常建议禁用)title️ 注意:id 容易被滥用做锚点注入,很多系统直接禁用class 允许的话最好只允许固定前缀(如 editor-*)二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一:通过官网安装包(最简单,适合初学者)如果你只是想快速安装并开始使用,这是最直接的方法。访问 Node.js 官网。页面会显示两个版本:LTS (Recommended For Most Users):长期支持版,最稳定。建议选这个。Current:最新特性版,包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二:使用 Homebrew 安装(...

Dom\HTML_NO_DEFAULT_NS 的副作用:自动加闭合标签

在使用Dom\HTMLDocument时,Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时,已知的一个副作用就是:自动加闭合标签例如 </img> 为什么会这样?当你使用:Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式,此时内部更接近 XML...

Laravel 事件和监听器创建

在 Laravel 中,使用 Artisan 命令创建 Events(事件) 和 Listeners(监听器) 是非常高效的。你可以通过以下几种方式来实现:1. 手动创建单个 Event如果你只想创建一个事件类,可以使用 make:event 命令:Bashphp artisan make:event UserRegistered执行后,文件将生成在 app/Even...

自定义域名解析神器 dnsmasq

什么是 dnsmasq?dnsmasq 是一个轻量级、功能强大的网络服务工具,专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么?功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器(ISP、Google DNS 等),并在本地缓存结果加快 DNS 查询速度,减少外部 DNS 流量本地 DNS解析本地网络设备的主机名,无需编辑&n...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。