0

0

如何在 JavaScript 中准确获取 TouchEvent 的触摸坐标

碧海醫心

碧海醫心

发布时间:2026-02-27 21:39:24

|

236人浏览过

|

来源于php中文网

原创

如何在 JavaScript 中准确获取 TouchEvent 的触摸坐标

本文详解如何在触控设备上正确获取 touchstart 等触摸事件的屏幕坐标,解决 e.x/e.y 在 TouchEvent 中不可用的问题,并提供兼容 Canvas 交互的健壮实现方案。

本文详解如何在触控设备上正确获取 `touchstart` 等触摸事件的屏幕坐标,解决 `e.x`/`e.y` 在 touchevent 中不可用的问题,并提供兼容 canvas 交互的健壮实现方案。

在 Web 游戏或 Canvas 应用中实现触控支持时,开发者常误以为 TouchEvent 与 MouseEvent 具有相同的坐标属性(如 e.x 和 e.y)。实际上,TouchEvent 并不原生提供 x/y 属性——这是浏览器对鼠标事件的专有扩展,而触摸事件需通过 touches、targetTouches 或 changedTouches 列表显式提取坐标。

✅ 正确获取触摸坐标的推荐方式

每个 TouchEvent 对象包含三个只读的 TouchList 属性:

  • e.touches:当前所有处于活动状态的触摸点(跨多指);
  • e.targetTouches:当前目标元素上的所有触摸点;
  • e.changedTouches:本次事件中状态发生改变的触摸点(如刚按下或刚抬起)。

对于单点触控游戏(如点击精灵),最常用且安全的方式是取 e.touches[0](首个触摸点),并使用其标准 CSS 坐标属性:

window.addEventListener('touchstart', (e) => {
  // 阻止默认行为(可选,避免滚动/缩放干扰游戏逻辑)
  e.preventDefault();

  if (e.touches.length === 0) return;

  const touch = e.touches[0];
  const x = touch.clientX;   // 相对于视口左上角的 X 坐标
  const y = touch.clientY;   // 相对于视口左上角的 Y 坐标

  console.log(`Touch at: (${x}, ${y})`);
});

⚠️ 注意:clientX/clientY 是标准化、跨浏览器兼容的属性,不应使用 pageX/pageY(受页面滚动影响)或 screenX/screenY(设备屏幕绝对坐标,不适用于 Canvas 定位)

立即学习Java免费学习笔记(深入)”;

Tago AI
Tago AI

AI生成带货视频,专为电商卖货而生

下载

? 适配 Canvas 坐标系(关键步骤)

由于 Canvas 绘制基于自身坐标系(通常以 左上角为原点),直接使用 clientX/clientY 会因 Canvas 的 CSS 缩放、边距或滚动偏移导致定位偏差。务必进行归一化转换:

const canvas = document.getElementById('gameCanvas');
const rect = canvas.getBoundingClientRect();

window.addEventListener('touchstart', (e) => {
  e.preventDefault();
  if (!e.touches.length) return;

  const touch = e.touches[0];
  // 转换为 Canvas 内部坐标(考虑缩放、border、padding)
  const x = touch.clientX - rect.left;
  const y = touch.clientY - rect.top;

  // ✅ 现在 x/y 可直接用于 ctx.fillRect(x, y, 10, 10) 或碰撞检测
  console.log(`Canvas-local touch: (${x.toFixed(1)}, ${y.toFixed(1)})`);
});

? 同时兼容鼠标与触摸(推荐实践)

为简化维护,建议封装统一的坐标提取函数,并监听 pointerdown(现代推荐方案,自动聚合鼠标/触摸/笔输入):

function getEventPoint(e) {
  let x, y;
  if ('touches' in e && e.touches.length > 0) {
    const t = e.touches[0];
    x = t.clientX;
    y = t.clientY;
  } else {
    x = e.clientX;
    y = e.clientY;
  }
  return { x, y };
}

// 使用 Pointer Events(更简洁,自动处理多输入源)
canvas.addEventListener('pointerdown', (e) => {
  e.preventDefault();
  const { x, y } = getEventPoint(e);
  const rect = canvas.getBoundingClientRect();
  const canvasX = x - rect.left;
  const canvasY = y - rect.top;
  handleSpriteClick(canvasX, canvasY); // 你的游戏逻辑
});

✅ 优势:pointerdown 无需额外判断事件类型,且默认支持 e.clientX/clientY,大幅减少条件分支;若需兼容 IE10/旧 Android,仍可回退至 touchstart + mousedown 双监听。

? 总结要点

  • ❌ 不要访问 e.x 或 e.y —— 它们在 TouchEvent 中未定义;
  • ✅ 始终从 e.touches[0] 提取 clientX/clientY;
  • ✅ 对 Canvas 操作,必须减去 getBoundingClientRect() 的 left/top 值;
  • ✅ 添加 e.preventDefault() 防止移动端默认行为(如双指缩放、页面滚动);
  • ✅ 优先采用 pointerdown 事件提升代码可维护性与兼容性。

掌握这些要点,即可稳定、精准地将用户触摸映射到 Canvas 游戏世界中,为触控交互打下坚实基础。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
html5动画制作有哪些制作方法
html5动画制作有哪些制作方法

html5动画制作方法有使用CSS3动画、使用JavaScript动画库、使用HTML5 Canvas等。想了解更多html5动画制作方法相关内容,可以阅读本专题下面的文章。

540

2023.10.23

android开发三大框架
android开发三大框架

android开发三大框架是XUtil框架、volley框架、ImageLoader框架。本专题为大家提供android开发三大框架相关的各种文章、以及下载和课程。

327

2023.08.14

android是什么系统
android是什么系统

Android是一种功能强大、灵活可定制、应用丰富、多任务处理能力强、兼容性好、网络连接能力强的操作系统。本专题为大家提供android相关的文章、下载、课程内容,供大家免费下载体验。

1795

2023.08.22

android权限限制怎么解开
android权限限制怎么解开

android权限限制可以使用Root权限、第三方权限管理应用程序、ADB命令和Xposed框架解开。详细介绍:1、Root权限,通过获取Root权限,用户可以解锁所有权限,并对系统进行自定义和修改;2、第三方权限管理应用程序,用户可以轻松地控制和管理应用程序的权限;3、ADB命令,用户可以在设备上执行各种操作,包括解锁权限;4、Xposed框架,用户可以在不修改系统文件的情况下修改应用程序的行为和权限。

2109

2023.09.19

android重启应用的方法有哪些
android重启应用的方法有哪些

android重启应用有通过Intent、PendingIntent、系统服务、Runtime等方法。本专题为大家提供Android相关的文章、下载、课程内容,供大家免费下载体验。

284

2023.10.18

Android语音播放功能实现方法
Android语音播放功能实现方法

实现方法有使用MediaPlayer实现、使用SoundPool实现两种。可以根据具体的需求选择适合的方法进行实现。想了解更多语音播放的相关内容,可以阅读本专题下面的文章。

378

2024.03.01

Golang 并发编程模型与工程实践:从语言特性到系统性能
Golang 并发编程模型与工程实践:从语言特性到系统性能

本专题系统讲解 Golang 并发编程模型,从语言级特性出发,深入理解 goroutine、channel 与调度机制。结合工程实践,分析并发设计模式、性能瓶颈与资源控制策略,帮助将并发能力有效转化为稳定、可扩展的系统性能优势。

2

2026.02.27

Golang 高级特性与最佳实践:提升代码艺术
Golang 高级特性与最佳实践:提升代码艺术

本专题深入剖析 Golang 的高级特性与工程级最佳实践,涵盖并发模型、内存管理、接口设计与错误处理策略。通过真实场景与代码对比,引导从“可运行”走向“高质量”,帮助构建高性能、可扩展、易维护的优雅 Go 代码体系。

1

2026.02.27

Golang 测试与调试专题:确保代码可靠性
Golang 测试与调试专题:确保代码可靠性

本专题聚焦 Golang 的测试与调试体系,系统讲解单元测试、表驱动测试、基准测试与覆盖率分析方法,并深入剖析调试工具与常见问题定位思路。通过实践示例,引导建立可验证、可回归的工程习惯,从而持续提升代码可靠性与可维护性。

0

2026.02.27

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 5.5万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 3.2万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号