该指令会跳过所在元素和它的子元素的编译过程,也就是把这个节点及其子节点当作一个静态节点来处理,例如:
- <!DOCTYPE html>
- <html lang="en">
- <head>
- <meta charset="UTF-8">
- <title>Document</title>
- <script src="https://cdn.jsdelivr.net/npm/vue@2.5.16/dist/vue.js"></script>
- </head>
- <body>
- <div id="app">
- <p v-pre :title="message">{{message}}</p>
- <p>{{message}}</p>
- </div>
- <script>
- Vue.config.productionTip=false;
- Vue.config.devtools=false;
- var app = new Vue({
- el:'#app',
- data:{message:"Hello World"}
- })
- </script>
- </body>
- </html>
编译后的结果为:

对应的HTML节点树为:

可以看到:title属性也被当成了特性来处理了,我们在控制台输入app.message="Hello Vue!"看看渲染变化:

可以看到对于v-pre对应的DOM节点,数据变化时也不会触发渲染的
源码分析
解析模板时如果遇到标签开始,会执行start函数,对于 <p v-pre :title="message">{{message}}</p>来说
- start: function start (tag, attrs, unary) { //第9136行 解析到标签开始时执行到这里
- /*略*/
-
- if (!inVPre) { //如果inVPre为false inVPre是个全局,用于判断当前是否在v-pre属性的环境之下,比如<p v-pre><span>123</span></p>解析到span标签时可以通过该属性来判断当前在v-pre内
- processPre(element); //尝试解析v-pre属性
- if (element.pre) { //如果element有v-pre属性
- inVPre = true; //则设置inVPre为true
- }
- }
- if (platformIsPreTag(element.tag)) {
- inPre = true;
- }
- if (inVPre) { //如果当前为pre标签
- processRawAttrs(element); //则设置inPre为true
- } else if (!element.processed) {
- // structural directives
- processFor(element); //对于v-pre特性标记的节点来说,不会进行这里面的分支,也就不会处理Vue指令了
- processIf(element);
- processOnce(element);
- // element-scope stuff
- processElement(element, options);
- }
- /*略*/
- },
processRawAttrs用于将特性保存到AST对象的attrs属性上,如下:
- function processRawAttrs (el) { //第9317行 如果设置了v-pre特性,则执行到这里
- var l = el.attrsList.length;
- if (l) {
- var attrs = el.attrs = new Array(l);
- for (var i = 0; i < l; i++) { //遍历当前所有的特性,依次保存到e.attrs上面
- attrs[i] = {
- name: el.attrsList[i].name,
- value: JSON.stringify(el.attrsList[i].value)
- };
- }
- } else if (!el.pre) {
- // non root node in pre blocks with no attributes
- el.plain = true;
- }
- }
后面在gendata()函数执行时就会拼凑成attr属性里,最后render渲染成相应的DOM节点后就会将该attr属性保存到对应的节点上了,例子里的模板渲染成render函数如下:
- with(this){return _c('div',{attrs:{"id":"app"}},[_c('p',{pre:true,attrs:{":title":"message"}},[_v("{{message}}")]),_v(" "),_c('p',[_v(_s(message))])])}
红色标记的就是v-pre编译后的模板,等到p元素渲染成真实DOM节点的时候,就会触发Vue内部attrs模块的updateAttrs方法进行初始化,之后就和v-bind指令里的后部分流程时一样的,最后会调用原生的DOM函数setAttribute去设置特性