讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

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

轻雪姑娘_1366

轻雪姑娘_1366

发布时间:2026-11-17 09:41:31

|

239人浏览过

|

来源于php中文网

原创

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

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

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

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

关键点在于指令内部主动查找真实 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 事件显式控制。在自定义表单组件中,常见需求有:

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

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

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

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

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

适配动态与异步场景

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

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

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

如果你的自定义表单组件(比如 <my-form-input></my-form-input>)内部封装了 <input> 或 <el-input></el-input>,可在组件内暴露聚焦能力:

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

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

热门AI工具

更多
墨刀AI
墨刀AI Hot

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

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

火山引擎

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

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

咔片AIPPT

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

DeepSeek

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

豆包大模型

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

WorkBuddy

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

相关专题

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

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

3063

2023.08.11

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

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

6703

2023.10.09

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

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

7530

2024.03.19

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

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

7478

2024.03.22

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

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

1063

2024.05.22

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

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

332

2026.02.13

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

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

560

2026.02.25

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

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

411

2026.03.13

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

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

精品课程

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

共42课时 | 17.6万人学习

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

共12课时 | 1.4万人学习

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

共18课时 | 1.7万人学习

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

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