Vue 自定义表单组件怎么实现输入框的聚焦与失焦控制

轻雪姑娘_1366

轻雪姑娘_1366

2026-11-17

239人浏览

原创

最推荐用 v-focus 自定义指令实现输入框聚焦,它不依赖 ref、声明式干净,适配原生 input 和 el-input 等封装组件,内部通过 querySelector 查找真实 input 元素并调用 focus()。

vue 自定义表单组件怎么实现输入框的聚焦与失焦控制

聚焦控制:用 v-focus 指令统一处理

自定义表单组件中,输入框聚焦最推荐用 v-focus 自定义指令实现。它不依赖 ref,声明式写法干净,适配原生 input 和封装组件(如 el-input、u-input)。

关键点在于指令内部主动查找真实 input 元素:

  • 原生 :直接调用 el.focus()
  • el-input 等封装组件:用 el.querySelector('input') || el.querySelector('.el-input__inner') 定位,再调用 focus()
  • 更稳妥可加 requestAnimationFrame(() => input?.focus()),确保浏览器完成渲染

局部使用时,在 <script setup></script> 中定义即可:

const vFocus = { mounted(el) { const input = el.querySelector('input') || el.querySelector('.el-input__inner'); requestAnimationFrame(() => input?.focus()); } };

失焦控制:配合事件与条件逻辑

失焦不是靠指令自动触发,而是通过 @blur 事件显式控制。在自定义表单组件中,常见需求有:

  • 点击其他区域或按钮后,让当前输入框失焦:this.$refs.inputRef.blur()
  • 表单提交/保存成功后主动失焦,避免键盘残留:inputEl.blur()
  • 需要“始终聚焦”某输入框(如出库单号):给它绑定 @blur="() => $nextTick(() => $refs.targetInput.focus())",但要注意循环聚焦风险,建议加防抖或状态判断

注意:v-show 不会销毁 DOM,失焦后再次显示不会重新触发 mounted;若需每次显示都聚焦,改用 v-if 或监听 updated 钩子 + 判断可见性。

Vue工具箱(免费版)
Vue工具箱(免费版)

规避 Vue 3 常见陷阱:响应式、ref 与 reactive、computed 时机与组合式 API 优选实践。

下载

适配动态与异步场景

自定义表单组件常含异步加载字段或模态框内嵌表单,此时聚焦时机很关键:

  • Modal 中的输入框:在 mounted 里用 nextTick 确保动画结束再聚焦
  • 异步加载的表单项:等数据 ready 后,用 nextTick 或 setTimeout(..., 100) 延迟聚焦,避开 DOM 未就绪问题
  • 移动端键盘弹出延迟:加 setTimeout(() => input?.focus(), 300) 更可靠
  • SSR 场景下 autofocus 失效:v-focus 指令天然只在客户端执行,无兼容问题

封装进自定义表单组件的最佳实践

如果你的自定义表单组件(比如 )内部封装了 或 ,可在组件内暴露聚焦能力:

  • 提供 focus() 方法:methods: { focus() { this.$refs.innerInput?.focus(); } }
  • 支持 v-focus 指令透传:在模板中把 v-focus 绑定到内部真实 input 上,或用 v-bind="$attrs" 让父级指令生效
  • 添加 prop 控制是否自动聚焦,例如 auto-focus,并在 mounted 中按需调用 focus()

这样既保持组件灵活性,又不破坏 Vue 的响应式与指令体系。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vue.js vue

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.08.11

3063

5

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

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

2023.10.09

6703

6

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

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

2024.03.19

7530

13

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

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

2024.03.22

7478

10

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

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

2024.05.22

1063

5

TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

2026.02.13

332

17

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

2026.02.25

560

17

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

2026.03.13

411

19

TypeScript 全栈开发进阶指南
TypeScript 全栈开发进阶指南

面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

2026.06.03

346

29

热门下载

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

精品课程

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

共42课时 | 17.6万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.4万人学习

Vue.js 微实战--十天技能课堂
Vue.js 微实战--十天技能课堂

共18课时 | 1.7万人学习