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

聚焦控制:用 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> 中定义即可:
失焦控制:配合事件与条件逻辑
失焦不是靠指令自动触发,而是通过 @blur 事件显式控制。在自定义表单组件中,常见需求有:
立即学习“前端免费学习笔记(深入)”;
- 点击其他区域或按钮后,让当前输入框失焦:
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 的响应式与指令体系。


















