讲师中心 微信公众号
AI工具推荐 视频效率加速

Vue.js 组合式 API 中处理 DOM 操作的 Refs

冬敏吖_4501

冬敏吖_4501

发布时间:2026-07-07 10:29:46

|

283人浏览过

|

来源于php中文网

原创

ref 是 Vue 3 组合式 API 中访问 DOM 元素最常用且安全的方式,需配合 onMounted 使用,声明名须与模板 ref 属性严格一致,推荐 Vue 3.5+ 的 useTemplateRef,DOM 操作不触发响应式更新。

vue.js 组合式 api 中处理 dom 操作的 refs

在 Vue 3 组合式 API 中,ref 是访问 DOM 元素最常用、也最安全的方式,但它不是“一写就用”,关键在于时机、声明方式和使用逻辑。

必须配合 onMounted 使用

DOM 节点只在组件挂载后才真实存在。在 setup 中直接读取 ref.value 会得到 null:

  • 正确做法:用 onMounted 钩子包裹操作逻辑
  • 错误做法:在 setup 顶层或 onBeforeMount 中尝试调用 focus()、getBoundingClientRect() 等方法
  • Vue 3.5+ 推荐用 useTemplateRef(自动处理挂载时机),比手动 ref + onMounted 更简洁

声明 ref 变量要与模板中 ref 名称严格一致

组合式 API 不再依赖 this.$refs,而是靠变量名映射:

Wjs Uploading Video
Wjs Uploading Video

将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。

下载
  • 模板写 <input ref="inputEl" />,setup 中就要写 const inputEl = ref(null)
  • 名称不一致会导致 value 始终为 null,且无报错提示,容易排查困难
  • 多个 ref 时建议用语义化命名,如 searchInput、listContainer,避免通用名如 el

常见 DOM 操作示例(无需额外库)

拿到 DOM 引用后,可直接调用原生 API,这些操作不触发响应式更新,也不受 Vue 监控:

立即学习“前端免费学习笔记(深入)”;

  • 聚焦输入框:inputEl.value?.focus()
  • 滚动到底部:listEl.value?.scrollTop = listEl.value?.scrollHeight
  • 测量尺寸位置:boxEl.value?.getBoundingClientRect()
  • 绑定原生事件(谨慎):inputEl.value?.addEventListener('input', handler),记得在 onUnmounted 中移除

注意 ref 的非响应式本质

$refs 或 ref.value 指向的是真实 DOM 节点或组件实例,它们本身不是响应式数据:

  • 不能在模板中用 {{ inputEl }} 渲染(会显示 object)
  • 不要把它当作状态变量传给其他 ref 或 computed
  • 若需基于 DOM 状态做响应式判断(比如是否可见),应手动监听并更新一个独立的 ref

热门AI工具

更多
讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2523

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

5443

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6470

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

6098

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

863

2024.05.22

vue2.0和3.0区别
vue2.0和3.0区别

vue2.0和3.0区别:vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现,vue3中使⽤了es6的proxy API对数据代理,实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容,供大家免费下载体验。

1674

2023.07.17

vue3的生命周期有哪些
vue3的生命周期有哪些

vue3的生命周期:1、beforecreate;2、created;3、beforemount;4、mounted;5、beforeupdate;6、updated;7、beforedestroy;8、destroyed;9、activated;10、deactivated等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

12102

2024.02.23

Vue3组合式API与组件开发实战
Vue3组合式API与组件开发实战

本专题讲解 Vue 3 组合式 API 的核心概念与应用技巧,深入分析响应式系统、生命周期管理、组件设计与复用策略。通过完整项目案例,指导前端开发者实现高性能、结构清晰的 Vue 应用,提升开发效率与代码可维护性。

316

2026.02.10

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

20

2026.10.16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app快速上手
uni-app快速上手

共0课时 | 0人学习

Vue 教程
Vue 教程

共42课时 | 17.1万人学习

Vue3.x 工具篇--十天技能课堂
Vue3.x 工具篇--十天技能课堂

共26课时 | 2.5万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn