深入理解Vue官方文檔梳理之全局API
Vue.extend
配置項data必須為function,否則配置無效。data的合并規(guī)則(可以看《Vue官方文檔梳理-全局配置》)源碼如下:
傳入非function類型的data(上圖中data配置為{a:1}),在合并options時,如果data不是function類型,開發(fā)版會發(fā)出警告,然后直接返回了parentVal,這意味著extend傳入的data選項被無視了。
我們知道實例化Vue的時候,data可以是對象,這里的合并規(guī)則不是通用的嗎?注意上面有個if(!vm)的判斷,實例化的時候vm是有值的,因此不同于Vue.extend,其實下面的注釋也做了說明(in a Vue.extend merge, both should be function),這也是官方文檔為何說data是個特例。
另外官方文檔所說的“子類”,是因為Vue.extend返回的是一個“繼承”Vue的函數(shù),源碼結(jié)構(gòu)如下:
Vue.extend = function (extendOptions) { //*** var Super = this; var SuperId = Super.cid; //*** var Sub = function VueComponent(options) { this._init(options); }; Sub.prototype = Object.create(Super.prototype); Sub.prototype.constructor = Sub; //*** return Sub };
Vue.nextTick
既然使用vue,當然要沿著數(shù)據(jù)驅(qū)動的方式思考,所謂數(shù)據(jù)驅(qū)動,就是不要直接去操作dom,dom的所有操作完全可以利用vue的各種指令來完成,指令將數(shù)據(jù)和dom進行了“綁定”,操作數(shù)據(jù)不僅能實現(xiàn)dom的更新,而且更方便。
如果瀏覽器支持Promise,或者用了Promise庫(但是對外暴露的必須叫Promise,因為源碼中的判斷為typeof Promise !== 'undefined'),nextTick返回的就是Promise對象。
Vue.nextTick().then(() => { // do sth })
Vue執(zhí)行nextTick的回調(diào)采用call的方式cb.call(ctx);ctx就是當前Vue實例,因此在回調(diào)中可以直接使用this調(diào)用實例的配置。
nextTick可以簡單理解為將回調(diào)放到末尾執(zhí)行,源碼中如果當前不支持Promise和MutationObserver,那么會采用setTimeout的方式來執(zhí)行回調(diào),這不就是我們常用的延后執(zhí)行代碼的方式。
if (typeof Promise !== 'undefined' && isNative(Promise)) { } else if (typeof MutationObserver !== 'undefined' && ( isNative(MutationObserver) || // PhantomJS and iOS 7.x MutationObserver.toString() === '[object MutationObserverConstructor]' )) { } else { // fallback to setTimeout /* istanbul ignore next */ timerFunc = function () { setTimeout(nextTickHandler, 0); }; }
舉個例子來實際看下:
<div id="app"> <div ref="dom">{{a}}</div> </div> new Vue({ el: '#app', data: { a: 1 }, mounted: function name(params) { console.log('start'); this.$nextTick(function () { console.log('beforeChange', this.$refs.dom.textContent) }) this.a = 2; console.log('change'); this.$nextTick(function () { console.log('afterChange', this.$refs.dom.textContent) }) console.log('end'); } }) // 控制臺依次打印 // start // change // end // beforeChange 1 // afterChange 2
你估計會有些納悶,既然都是最后才執(zhí)行,那為什么beforeChange輸出的是1而不是2,這是因為this.a=2背后觸發(fā)dom更新也是采用nextTick的方式,上面的代碼實際執(zhí)行的順序是:beforeChange>更新dom>afterChange。
Vue.set
Vue.set( target, key, value ),target不能是 Vue 實例,或者 Vue 實例的根數(shù)據(jù)對象,因為源碼中做了如下判斷:
var ob = (target).__ob__; if (target._isVue || (ob && ob.vmCount)) { "development" !== 'production' && warn( 'Avoid adding reactive properties to a Vue instance or its root $data ' + 'at runtime - declare it upfront in the data option.' ); return val }
target._isVue阻止了給Vue實例添加屬性,ob && ob.vmCount阻止了給Vue實例的根數(shù)據(jù)對象添加屬性。
Vue.delete
如果Vue能檢測到delete操作,那么就不會出現(xiàn)這個api。如果一定要用delete來刪除$data的屬性,那就用Vue.delete,否則不會觸發(fā)dom的更新。
同Vue.set,Vue.delete( target, key )的target不能是一個 Vue 示例或 Vue 示例的根數(shù)據(jù)對象。源碼中的阻止方式和Vue.set相同。
在2.2.0+ 版本中target若為數(shù)組,key則是數(shù)組下標。因為Vue.delete刪除數(shù)組實際是用splice來刪除,delete雖然能用于刪除數(shù)組,但位置還在,不能算真正的刪除。
var a = [1, 2, 3]; delete a[0]; console.log(a); // [undefined, 2, 3]
Vue.use
Vue.use 源碼比較簡單,可以全部貼出來。
Vue.use = function (plugin) { var installedPlugins = (this._installedPlugins || (this._installedPlugins = [])); if (installedPlugins.indexOf(plugin) > -1) { return this } // additional parameters var args = toArray(arguments, 1); args.unshift(this); if (typeof plugin.install === 'function') { plugin.install.apply(plugin, args); } else if (typeof plugin === 'function') { plugin.apply(null, args); } installedPlugins.push(plugin); return this };
安裝的插件放到了 installedPlugins ,安裝插件前通過installedPlugins.indexOf(plugin)來判斷插件是否被安裝過,進而阻止注冊相同插件多次。
插件類型為 object,必須指定 install 屬性來安裝插件(typeof plugin.install === 'function'),另外插件執(zhí)行采用plugin.install.apply(plugin, args);,因此 this 訪問 object 的其他屬性。此處的 args 是由 Vue(args.unshift(this);) 和 Vue.use 傳入的除了 plugin 的其他參數(shù)(toArray(arguments, 1),1 表示從 arguments[1] 開始截?。?。
Vue.use({ a: 1, install: function (Vue) { console.log(this.a) // 1 console.log(arguments) // [function Vue(options),"a", "b", "c"] } }, 'a', 'b', 'c')
插件類型為 function,安裝調(diào)用plugin.apply(null, args);,因此在嚴格模式下插件運行時上下文 this 為 null,非嚴格模式為 Window。
'use strict' Vue.use(function plugin() { console.log(this) // null console.log(arguments) // [function Vue(options),"a", "b", "c"] }, 'a', 'b', 'c')
Vue.compile
和眾多 JS 模板引擎的原理一樣,預先會把模板轉(zhuǎn)化成一個 render 函數(shù),Vue.compile 就是來完成這個工作的,目標是將模板(template 或 el)轉(zhuǎn)化成 render 函數(shù)。
Vue.compile 返回了{render:Function,staticRenderFns:Array},render 可直接應用于 Vue 的配置項 render,而 staticRenderFns 是怎么來的,而且按照官網(wǎng)的例子,Vue 還有個隱藏的配置項 staticRenderFns,先來個例子看看。
var compiled = Vue.compile( '<div>' + '<header><h1>no data binding</h1></header>' + '<section>{{prop}}</section>' + '</div>' ) console.log(compiled.render.toString()) console.log(compiled.staticRenderFns.toString()) // render function anonymous() { with(this) { return _c('div', [_m(0), _c('section', [_v(_s(prop))])]) } } // staticRenderFns function anonymous() { with(this) { return _c('header', [_c('h1', [_v("no data binding")])]) } }
原來沒有和數(shù)據(jù)綁定的 dom 會放到 staticRenderFns 中,然后在 render 中以_m(0)來調(diào)用。但是并不盡然,比如上述模板去掉<h1>,staticRenderFns 長度為 0,header 直接放到了 render 函數(shù)中。
function anonymous() { with(this) { return _c('div', [_c('header', [_v("no data binding")]), _c('section', [_v(_s(prop))])]) } }
Vue.compile 對應的源碼比較復雜,上述渲染 <header> 沒有放到 staticRenderFns 對應源碼的核心判斷如下:
// For a node to qualify as a static root, it should have children that // are not just static text. Otherwise the cost of hoisting out will // outweigh the benefits and it's better off to just always render it fresh. if (node.static && node.children.length && !( node.children.length === 1 && node.children[0].type === 3 )) { node.staticRoot = true; return } else { node.staticRoot = false; }
<header> 不符判斷條件 !(node.children.length === 1 && node.children[0].type === 3), <header> 有一個子節(jié)點 TextNode(nodeType=3)。 注釋也說明了一個 node 符合靜態(tài)根節(jié)點的條件。
另外官網(wǎng)說明了此方法只在獨立構(gòu)建時有效,什么是獨立構(gòu)建?這個官網(wǎng)做了詳細的介紹,不再贅述。對應官網(wǎng)地址:對不同構(gòu)建版本的解釋。
仔細觀察編譯后的 render 方法,和我們自己寫的 render 方法有很大區(qū)別。但是仍然可以直接配置到 render 配置選項上。那么里面的那些 _c()、_m() 、_v()、_s() 能調(diào)用?隨便看一個 Vue 的實例的 __proto__ 就會發(fā)現(xiàn):
// internal render helpers. // these are exposed on the instance prototype to reduce generated render // code size. Vue.prototype._o = markOnce; Vue.prototype._n = toNumber; Vue.prototype._s = toString; Vue.prototype._l = renderList; Vue.prototype._t = renderSlot; Vue.prototype._q = looseEqual; Vue.prototype._i = looseIndexOf; Vue.prototype._m = renderStatic; Vue.prototype._f = resolveFilter; Vue.prototype._k = checkKeyCodes; Vue.prototype._b = bindObjectProps; Vue.prototype._v = createTextVNode; Vue.prototype._e = createEmptyVNode; Vue.prototype._u = resolveScopedSlots; Vue.prototype._g = bindObjectListeners;
正如注釋所說,這些方法是為了減少生成的 render 函數(shù)的體積。
全局 API 還剩 directive、filter、component、mixin,這幾個比較類似,而且都對應著配置項,會在「選項」中再詳細介紹。
以上就是本文的全部內(nèi)容,希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
vue計算屬性時v-for處理數(shù)組時遇到的一個bug問題
這篇文章主要介紹了在做vue計算屬性,v-for處理數(shù)組時遇到的一個bug 問題,需要的朋友可以參考下2018-01-01詳解vue數(shù)組遍歷方法forEach和map的原理解析和實際應用
這篇文章主要介紹了詳解vue數(shù)組遍歷方法forEach和map的原理解析和實際應用,小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2018-11-11vite創(chuàng)建vue3項目頁面引用public下js文件失敗解決辦法
Vue3相較于之前的版本有了不少變化,如引用全局Js文件,這篇文章主要給大家介紹了關(guān)于vite創(chuàng)建vue3項目頁面引用public下js文件失敗的解決辦法,文中通過代碼介紹的非常詳細,需要的朋友可以參考下2023-11-11