Vue.js 虚拟 DOM 对非标准 DOM 属性的处理与映射

秋婷姑娘_7806

秋婷姑娘_7806

2026-07-01

622人浏览

原创

vue的vnode将非标准dom属性分类映射:普通自定义属性(如data-*)归入data.attrs,原生dom属性(如value、innerhtml)归入data.domprops,内置指令(如v-html、ref、key)由运行时单独处理,确保渲染行为与dom语义一致。

vue.js 虚拟 dom 对非标准 dom 属性的处理与映射

Vue.js 的虚拟 DOM(VNode)在处理非标准 DOM 属性时,并不简单地“忽略”或“丢弃”,而是依据属性类型和语义进行分类映射:一部分进入 data.attrs,一部分进入 data.domProps,还有部分被 Vue 特殊识别并用于内部行为(如 v-model、ref、key 等)。这种区分直接影响最终真实 DOM 的生成结果和运行时行为。

非标准属性如何归类到 VNode 的 data 结构中

当模板或 render 函数中使用一个 HTML 属性(比如 custom-id="abc"、data-something="123"、x-once="true"),Vue 会根据预设规则决定它该落在 VNode 的哪个字段:

  • 普通自定义属性(如 data-*、aria-*、custom-id)→ vnode.data.attrs:这类属性会被原样挂载到真实 DOM 元素上,浏览器能读取但不触发特殊逻辑;
  • DOM 原生属性(如 innerHTML、textContent、value、checked)→ vnode.data.domProps:这些是直接写入 DOM 元素 JS 属性的值,绕过 attribute 机制,优先级高于 attrs,且不会出现在 HTML 字符串中;
  • Vue 内置指令或保留属性(如 v-html、ref、key、is)→ 不进入 attrs 或 domProps,而是由编译器/运行时单独提取处理:例如 v-html 会清空 children 并设置 domProps.innerHTML;ref 会注册引用而非渲染为属性。

为什么不能全塞进 attrs?

因为 attrs 和 domProps 在底层 patch 过程中走的是不同路径:

Ainative Vue Sdk
Ainative Vue Sdk

使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景:(1) 安装 `@ainative/vue-sdk`,(2) 在 Vue 组件中使用 `useChat` 组合式函数,(3) 提供……

下载
  • attrs 对应 element.setAttribute(),影响 HTML 字符串层面;
  • domProps 对应 element[prop] = value,直接影响 JS 属性状态(如表单控件的 value 值、input 的 checked 状态);
  • 若把 value 放进 attrs,会导致 input 初始值显示但无法响应后续数据绑定——因为真实 DOM 的 value 属性只控制初始值,而 JS 属性 value 才控制实时值。

自定义元素与 Web Components 中的非标准属性

在使用自定义元素(如 <my-button disabled></my-button>)或 Web Components 时,Vue 仍按上述规则处理:

  • 布尔属性如 disabled、hidden 若存在即为 true,会被正确映射为 domProps.disabled = true;
  • 带值的自定义属性(如 theme="dark")默认进 attrs,除非组件显式声明 prop 接收并转换为 domProps;
  • 如果组件内部通过 this.$attrs 透传,那些未被声明为 prop 的非标准属性会作为 attrs 继续向下传递,保持语义一致性。

开发者可控的映射方式

你可以在 render 函数或 JSX 中显式控制归属:

  • 用 attrs: { 'data-id': '123' } → 写入 data.attrs;
  • 用 domProps: { innerHTML: '<b>hello</b>' } → 写入 data.domProps;
  • 用 props: { customValue: 'x' } → 若子组件声明了 customValue prop,则走 props 流程,否则可能降级为 attrs(取决于 inheritAttrs: false 设置)。

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

相关文章

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

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

下载

相关标签:

vue.js vue js

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

相关专题

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

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

2023.08.11

2403

5

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

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

2023.10.09

5183

6

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

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

2024.03.19

6250

13

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

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

2024.03.22

5798

10

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

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

2024.05.22

823

5

html5动画制作有哪些制作方法
html5动画制作有哪些制作方法

html5动画制作方法有使用CSS3动画、使用JavaScript动画库、使用HTML5 Canvas等。想了解更多html5动画制作方法相关内容,可以阅读本专题下面的文章。

2023.10.23

3971

6

HTML与HTML5的区别
HTML与HTML5的区别

HTML与HTML5的区别:1、html5支持矢量图形,html本身不支持;2、html5中可临时存储数据,html不行;3、html5新增了许多控件;4、html本身不支持音频和视频,html5支持;5、html无法处理不准确的语法,html5能够处理等等。想了解更多HTML与HTML5的相关内容,可以阅读本专题下面的文章。

2024.03.06

6788

6

html5从入门到精通汇总
html5从入门到精通汇总

想系统掌握HTML5开发?本合集精选全网优质学习资源,涵盖免费教程、实战项目、视频课程与权威电子书,从基础语法到高级特性(Canvas、本地存储、响应式布局等)一应俱全,适合零基础小白到进阶开发者,助你高效入门并精通HTML5前端开发。

2025.12.30

794

19

html5新老标签汇总
html5新老标签汇总

HTML5在2026年持续优化网页语义化与交互体验,不仅引入了如<header>、<nav>、<article>、<section>、<aside>、<footer>等结构化标签,还新增了<video>、<audio>、<canvas>、<figure>、<time>、<mark>等增强多媒体与

2025.12.30

694

12

热门下载

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

精品课程

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

共42课时 | 17万人学习

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

共12课时 | 1.4万人学习

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

共18课时 | 1.7万人学习