Setup 模板引用怎么在 setup 中定义同名 ref 变量精确绑定模板中的原生输入框

阿瑶君_5841

阿瑶君_5841

2026-08-25

786人浏览

原创

必须显式调用 ref(null) 并在模板中用同名字符串 ref="username",才能使 username.value 精确指向原生 input DOM 实例;若误用 :ref="username" 则无法自动绑定且易覆盖初始值。

setup 模板引用怎么在 setup 中定义同名 ref 变量精确绑定模板中的原生输入框

在 Vue 3 的 setup 中,若模板里有原生输入框(如 ),想用同名 ref 变量实现**精确绑定**(即 ref 名和 input 的 ref 特性值一致,并能正确获取 DOM 实例),关键在于:**不能仅靠变量名匹配,必须显式调用 ref() 并在模板中用同名字符串赋给 ref 特性**。

1. 正确声明同名 ref 变量

在 setup 中用 ref(null) 初始化,变量名与模板中 ref 特性的值严格一致(区分大小写、无空格):

import { ref } from 'vue'

export default {
  setup() {
    const username = ref(null) // ← 变量名 = 'username'
    
    return {
      username // ← 必须暴露,供模板访问
    }
  }
}

2. 模板中使用同名字符串 ref 特性

在模板中,给原生 设置 ref="username"(注意是字符串字面量,不是 :ref="username"):

Vuejs
Vuejs

Vue.js 官方推荐通过 npm 进行安装,这是构建现代化前端项目最主流的方式。在终端中执行 npm install vue 即可获取最新稳定版,如需指定版本可添加 @版本号,例如 npm install vue@3.4.0。安装前请确保已配置 Node.js 环境(推荐 v18 及以上版本),并建议将 npm 镜像源切换至国内镜像以提升下载速度。对于大型项目,还可通过 npm create v

下载
<template><input ref="username" type="text" placeholder="请输入用户名"></template>

✅ 这样 Vue 才会在挂载后把该 DOM 元素赋值给 username.value;
❌ 若写成 :ref="username",会触发 ref 回调,但无法自动绑定到 username.value,且容易覆盖初始值。

3. 验证与使用 DOM 实例

组件挂载后,username.value 即为原生 元素,可直接操作:

  • 聚焦:username.value?.focus()
  • 取值:username.value?.value
  • 设值:username.value.value = 'admin'
  • 监听事件时配合 onMounted 确保 DOM 已就绪

4. 注意事项

  • ref 名必须是合法标识符(如 userInput 可以,user-input 不行)
  • 多个同名 ref 会导致最后一个覆盖前面的(不推荐重名)
  • 服务端渲染(SSR)时 ref 值为 null,需加空值判断
  • 若需响应式控制输入内容,应另配 v-model 绑定数据,ref 仅用于 DOM 操作

相关专题

更多
vue2.0和3.0区别
vue2.0和3.0区别

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

2023.07.17

1794

5

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

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

2024.02.23

12802

5

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

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

2026.02.10

356

23

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

2026.11.20

0

7

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

2026.11.20

0

17

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

2026.11.20

0

10

PHP8.6数组与数据处理教程
PHP8.6数组与数据处理教程

本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。

2026.11.20

0

8

PHP8.6升级迁移教程
PHP8.6升级迁移教程

本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。

2026.11.20

0

10

PHP8.6安装配置与FPM运维教程
PHP8.6安装配置与FPM运维教程

本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。

2026.11.20

0

10

热门下载

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

精品课程

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

共42课时 | 17.6万人学习

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

共12课时 | 1.5万人学习

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

共18课时 | 1.8万人学习