vue源码解析2——模板解析

2 模板解析

从上节的第<5>步，引出模板解析，将el的所有子节点取出, 添加到一个新建的文档fragment对象中，对fragment中的所有层次子节点递归进行编译解析处理。

1. 文本节点： 从data中取出表达式对应的属性值，设置为文本节点的textContent
2. 元素节点：获取节点属性，判断是否是指令 解析指令

function Compile(el, vm) {
    this.$vm = vm;
    // <1> // 保存el元素 $el是我们html里的元素
    this.$el = this.isElementNode(el) ? el : document.querySelector(el);

    if (this.$el) {
        // <2> 将el所有子节点取出来放到一个fragment对象当中，我们进去看看
        this.$fragment = this.node2Fragment(this.$el);
        // <5> 编译fragment中所有层次子节点 进去看看
        this.init();
        this.$el.appendChild(this.$fragment);
    }
}

Compile.prototype = {
    node2Fragment: function(el) {
        // <3> new一个fragment对象
        var fragment = document.createDocumentFragment(),
            child;

        // <4> 将原生节点拷贝到fragment appendChild会将节点从el中删除并添加到fragment
        while (child = el.firstChild) {
            fragment.appendChild(child);
        }

        return fragment;
    },

    init: function() {
        this.compileElement(this.$fragment);
    },

    compileElement: function(el) {
        var childNodes = el.childNodes, // <7>childNodes为所有子节点 包括文本，元素，空格
            me = this;

        [].slice.call(childNodes).forEach(function(node) { // <7> 遍历节点
            var text = node.textContent;
            var reg = /\{\{(.*)\}\}/;  // 正则对象(匹配大括号表达式)

            if (me.isElementNode(node)) { // <8> 判断节点类型 并分类解析
                me.compile(node);

            } else if (me.isTextNode(node) && reg.test(text)) {
                me.compileText(node, RegExp.$1);
            }

            if (node.childNodes && node.childNodes.length) {
                me.compileElement(node);
            }
        });
    },

    compile: function(node) {  // <8.1> 标签节点解析
        var nodeAttrs = node.attributes,  // 所有标签节点属性
            me = this;

        [].slice.call(nodeAttrs).forEach(function(attr) {
            var attrName = attr.name; // 得到属性名: 例如v-on:click / class：
            if (me.isDirective(attrName)) { // 判断是否是指令属性
                var exp = attr.value;  // 得到指令表达式(属性值): test
                var dir = attrName.substring(2);  // 得到指令名: on:click
                
                if (me.isEventDirective(dir)) { // 如果是事件指令
                    compileUtil.eventHandler(node, me.$vm, exp, dir);
                   
                } else {   // 普通指令 通过不同的dir调相应的方法
                    compileUtil[dir] && compileUtil[dir](node, me.$vm, exp);
                }

                node.removeAttribute(attrName);
            }
        });
    },

    compileText: function(node, exp) {
        compileUtil.text(node, this.$vm, exp);
    },

    isDirective: function(attr) {
        return attr.indexOf('v-') == 0;
    },

    isEventDirective: function(dir) {
        return dir.indexOf('on') === 0;
    },

    isElementNode: function(node) {
        return node.nodeType == 1;
    },

    isTextNode: function(node) {
        return node.nodeType == 3;
    }
};

// 指令处理集合
var compileUtil = {
    text: function(node, vm, exp) {
        this.bind(node, vm, exp, 'text');
    },

    html: function(node, vm, exp) {
        this.bind(node, vm, exp, 'html');
    },

    model: function(node, vm, exp) {
        this.bind(node, vm, exp, 'model');

        var me = this,
            val = this._getVMVal(vm, exp);
        node.addEventListener('input', function(e) {
            var newValue = e.target.value;
            if (val === newValue) {
                return;
            }

            me._setVMVal(vm, exp, newValue);
            val = newValue;
        });
    },

    class: function(node, vm, exp) {
        this.bind(node, vm, exp, 'class');
    },
     // 解析指令的核心方法
    bind: function(node, vm, exp, dir) {
        var updaterFn = updater[dir + 'Updater']; // 根据指令名(text)得到对应的更新节点函数

        updaterFn && updaterFn(node, this._getVMVal(vm, exp)); // 如果存在调用来更新节点
        // 创建表达式对应的watcher对象 用于数据改变-界面改变 
        // 从这里我们进入Watcher (详情看第三篇)
        new Watcher(vm, exp, function(value, oldValue) {
            updaterFn && updaterFn(node, value, oldValue); // 当对应的属性值发生了变化时, 自动调用, 更新对应的节点
        });
    },

    // 事件处理
    eventHandler: function(node, vm, exp, dir) {
        var eventType = dir.split(':')[1],  // 得到事件名/类型: click
            fn = vm.$options.methods && vm.$options.methods[exp]; // 根据表达式得到事件处理函数(从methods中): test(){}

        if (eventType && fn) {
            node.addEventListener(eventType, fn.bind(vm), false); // 绑定指定事件名和回调函数的DOM事件监听, 将回调函数中的this强制绑定为vm
        }
    },

    _getVMVal: function(vm, exp) {
        var val = vm._data;
        exp = exp.split('.');
        exp.forEach(function(k) {
            val = val[k];
        });
        return val;
    },

    _setVMVal: function(vm, exp, value) {
        var val = vm._data;
        exp = exp.split('.');
        exp.forEach(function(k, i) {
            // 非最后一个key，更新val的值
            if (i < exp.length - 1) {
                val = val[k];
            } else {
                val[k] = value;
            }
        });
    }
};


var updater = {
    textUpdater: function(node, value) {
        node.textContent = typeof value == 'undefined' ? '' : value;
    },

    htmlUpdater: function(node, value) {
        node.innerHTML = typeof value == 'undefined' ? '' : value;
    },

    classUpdater: function(node, value, oldValue) {
        var className = node.className;
        className = className.replace(oldValue, '').replace(/\s$/, '');

        var space = className && String(value) ? ' ' : '';

        node.className = className + space + value;
    },

    modelUpdater: function(node, value, oldValue) {
        node.value = typeof value == 'undefined' ? '' : value;
    }
};