Vue.js 源码分析(十五) 指令篇 v-bind指令详解

指令是Vue.js模板中最常用的一项功能，它带有前缀v-,比如上面说的v-if、v-html、v-pre等。指令的主要职责就是当其表达式的值改变时，相应的将某些行为应用到DOM上，先介绍v-bind指令

v-bind用于动态地绑定一个或多个特性，或一个组件 prop 到表达式。

例如:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/vue.js"></script>
    <title>Document</title>    
</head>
<body>
    <div id="app"><a v-bind:href="href">链接</a></div>
    <script>
    Vue.config.productionTip=false;
    Vue.config.devtools=false;
    var app = new Vue({
        el:'#app',
        data:{href:"http://www.baidu.com"}
    })
    </script> 
</body>
</html>

渲染为:

当我们点击整个超链接时将跳转到http://www.baidu.com，如果在控制台输入app.href="http://www.taobao.com"时:

点击按钮后就跳转到淘宝了

源码分析

以上面的例子为例,Vue内部将DOM解析成AST对象的时候会执行parse()函数，该函数解析到a节点时会执行到processElement()函数，该函数先将key、ref、插槽、class和style解析完后就会执行processAttrs()函数，如下:

function processAttrs (el) {    //第9526行  对剩余的属性进行分析
  var list = el.attrsList;
  var i, l, name, rawName, value, modifiers, isProp; 
  for (i = 0, l = list.length; i < l; i++) {              //遍历每个属性
    name = rawName = list[i].name; 
    value = list[i].value;
    if (dirRE.test(name)) {                                //如果该属性以v-、@或:开头，表示这是Vue内部指令
      // mark element as dynamic
      el.hasBindings = true;
      // modifiers 
      modifiers = parseModifiers(name);                     //获取修饰符，比如:{native: true,prevent: true}
      if (modifiers) {
        name = name.replace(modifierRE, '');
      }
      if (bindRE.test(name)) { // v-bind                      //bindRD等于/^:|^v-bind:/ ，即该属性是v-bind指令时 例如:<a :href="url">你好</a>
        name = name.replace(bindRE, '');                          //去掉指令特性，获取特性名，比如 href
        value = parseFilters(value);                              //对一些表达式做解析，例如{a|func1|func2}
        isProp = false;                                           //是否绑定到DOM对象上
        if (modifiers) {
          if (modifiers.prop) {                                   //如果有修饰符
            isProp = true;
            name = camelize(name);
            if (name === 'innerHtml') { name = 'innerHTML'; }
          }
          if (modifiers.camel) {
            name = camelize(name);
          }
          if (modifiers.sync) {
            addHandler(
              el,
              ("update:" + (camelize(name))),
              genAssignmentCode(value, "$event")
            );
          }
        }
        if (isProp || (
          !el.component && platformMustUseProp(el.tag, el.attrsMap.type, name)    //如果isProp为true
        )) {                                                                            //则调用addProp()
          addProp(el, name, value);
        } else {
          addAttr(el, name, value);                                               //否则调用addAttr()
        }
      } else if (onRE.test(name)) { // v-on                     //onRE等于/^@|^v-on:/，即该属性是v-on指令时
        name = name.replace(onRE, '');
        addHandler(el, name, value, modifiers, false, warn$2);
      } else { // normal directives                             //普通指令
        name = name.replace(dirRE, '');
        // parse arg
        var argMatch = name.match(argRE);
        var arg = argMatch && argMatch[1];
        if (arg) {
          name = name.slice(0, -(arg.length + 1));
        }
        addDirective(el, name, rawName, value, arg, modifiers);
        if ("development" !== 'production' && name === 'model') {
          checkForAliasModel(el, value);
        }
      }
    } else {
      /*略*/
    }
  }
}

addAttr()函数用于在AST对象上新增一个attrs属性，如下:

function addAttr (el, name, value) {    //第6550行 
  (el.attrs || (el.attrs = [])).push({ name: name, value: value });     //将{name: name,value: value}保存到el.attrs里面
  el.plain = false;                                                      //修正el.plain为false
}

例子里执行到这里时对应的AST对象为:

执行generate()函数获取data$2时会判断是否有attrs属性，如果有则将属性保存到attrs上，例子里的实例渲染后render函数等于:

  if (el.attrs) { 　　　　//第10306行
    data += "attrs:{" + (genProps(el.attrs)) + "},";
  }

genProps用于拼凑对应的值，如下:

function genProps (props) {     //第10537行 拼凑AST对象的属性或DOM属性用的
  var res = '';   
  for (var i = 0; i < props.length; i++) {    //遍历prps
    var prop = props[i];                         //对应的值
    /* istanbul ignore if */
    {
      res += "\"" + (prop.name) + "\":" + (transformSpecialNewlines(prop.value)) + ",";   //拼凑字符串
    }
  }
  return res.slice(0, -1)
}

例子执行到这里渲染的render函数等于:

with(this) {
    return _c('div', {
        attrs: {
            "id": "app"
        }
    },
    [_c('a', {
        attrs: {
            "href": href
        }
    },
    [_v("链接")])])
}

这样当该函数执行的时候就会触发Vue实例的href属性，此时就会将渲染watcher作为href属性的订阅者了，当href修改时就会触发渲染watcher的重新渲染了。

最后当a标签整个DOM元素生成之后会触发attrs模块的create事件去设置href特性，如下:

function updateAttrs (oldVnode, vnode) {      //第6294行 更新attrs
  var opts = vnode.componentOptions;                                      //获取vnode.componentOptions(组件才有)
  if (isDef(opts) && opts.Ctor.options.inheritAttrs === false) {
    return
  }
  if (isUndef(oldVnode.data.attrs) && isUndef(vnode.data.attrs)) {        //如果在oldVnode和vnode上都没有定义attrs属性
    return                                                                     //则直接返回，不做处理
  }
  var key, cur, old;
  var elm = vnode.elm;
  var oldAttrs = oldVnode.data.attrs || {};
  var attrs = vnode.data.attrs || {};                             //新VNode的attrs属性
  // clone observed objects, as the user probably wants to mutate it
  if (isDef(attrs.__ob__)) {
    attrs = vnode.data.attrs = extend({}, attrs);
  }

  for (key in attrs) {                                            //遍历新VNode的每个attrs
    cur = attrs[key];
    old = oldAttrs[key];
    if (old !== cur) {
      setAttr(elm, key, cur);                                     //则调用setAttr设置属性
    }
  }
  // #4391: in IE9, setting type can reset value for input[type=radio]
  // #6666: IE/Edge forces progress value down to 1 before setting a max
  /* istanbul ignore if */
  if ((isIE || isEdge) && attrs.value !== oldAttrs.value) {       //IE9的特殊情况
    setAttr(elm, 'value', attrs.value);
  }
  for (key in oldAttrs) {
    if (isUndef(attrs[key])) {
      if (isXlink(key)) {
        elm.removeAttributeNS(xlinkNS, getXlinkProp(key));
      } else if (!isEnumeratedAttr(key)) {
        elm.removeAttribute(key);
      }
    }
  }
}

function setAttr (el, key, value) {         //设置el元素的key属性为value
  if (el.tagName.indexOf('-') > -1) {            //如果el的标签名里含有-
    baseSetAttr(el, key, value); 
  } else if (isBooleanAttr(key)) {                //如果key是布尔类型的变量(比如:disabled、selected)
    // set attribute for blank value
    // e.g. <option disabled>Select one</option>
    if (isFalsyAttrValue(value)) {
      el.removeAttribute(key);
    } else {
      // technically allowfullscreen is a boolean attribute for <iframe>,
      // but Flash expects a value of "true" when used on <embed> tag
      value = key === 'allowfullscreen' && el.tagName === 'EMBED'
        ? 'true'
        : key;
      el.setAttribute(key, value);
    }
  } else if (isEnumeratedAttr(key)) {             //如果key是这三个之一:contenteditable,draggable,spellcheck
    el.setAttribute(key, isFalsyAttrValue(value) || value === 'false' ? 'false' : 'true');
  } else if (isXlink(key)) {
    if (isFalsyAttrValue(value)) {
      el.removeAttributeNS(xlinkNS, getXlinkProp(key));
    } else {
      el.setAttributeNS(xlinkNS, key, value);
    }
  } else {                                          //不满足上述的情况就直接调用baseSetAttr设置属性
    baseSetAttr(el, key, value);
  }
}

function baseSetAttr (el, key, value) {         //设置el的key属性为value
  if (isFalsyAttrValue(value)) {                  //如果value是null或false
    el.removeAttribute(key);                       //则删除属性
  } else { 
    // #7138: IE10 & 11 fires input event when setting placeholder on
    // <textarea>... block the first input event and remove the blocker
    // immediately.
    /* istanbul ignore if */
    if ( 
      isIE && !isIE9 &&
      el.tagName === 'TEXTAREA' &&
      key === 'placeholder' && !el.__ieph
    ) {                                         特殊情况 
      var blocker = function (e) {
        e.stopImmediatePropagation();
        el.removeEventListener('input', blocker);
      };
      el.addEventListener('input', blocker);
      // $flow-disable-line
      el.__ieph = true; /* IE placeholder patched */
    }
    el.setAttribute(key, value);                    //直接调用原生DOMAPI setAttribute设置属性
  }
}

Vue.js 源码分析(十五) 指令篇 v-bind指令详解

猜你喜欢