看Zepto如何實現增刪改查DOM

前言

dom也就是文檔對象模型,是針對HTML和XML的一個api,描繪了一個層次化的節點樹。雖然瀏覽器原生給咱們提供了許多操做dom的方法,使咱們能夠對dom進行查找,複製,替換和刪除等操做。可是zepto在其基礎上再次封裝,給以咱們更加便捷的操做方式。先看下圖,咱們以刪除元素插入元素,複製元素包裹元素替換元素幾個模塊分別探究zepto如何一一將其實現。javascript

DOM操做
DOM操做

原文連接css

github項目地址 html

刪除元素

remove

當父節點存在時,從其父節點中刪除當前集合中的元素。java

remove: function () {
  return this.each(function () {
    if (this.parentNode != null)
      this.parentNode.removeChild(this)
  })
}複製代碼

遍歷當前集合中的元素,當該元素的父節點存在的時候,使用removeChild刪除該元素。node

detach

功能和remove同樣,都是刪除元素。git

$.fn.detach = $.fn.remove複製代碼

能夠看到就是在$的原型上添加了一個指向remove函數的方法detachgithub

empty

清空對象集合中每一個元素的DOM內容ajax

empty: function () {
  return this.each(function () { this.innerHTML = '' })
},複製代碼

遍歷當前集合中的元素,而後將元素的innerHTML屬性設置爲空。也就達到了清除DOM內容的目的。json

插入元素

插入元素的相關api比較多,咱們先來重溫部分api的使用用法和比較一下他們之間的區別。api

append, prepend, after, before

<ul class="box">
  <li>1</li>
</ul>複製代碼
let $box = $('.box')
let insertDom = '<li>i am child</li>'

// append appendTo
// $box.append(insertDom)
// $(insertDom).appendTo($box)

/* <ul class="box"> <li>1</li> <li>i am child</li> </ul> */


// prepend prependTo
// $box.prepend(insertDom)
// $(insertDom).prependTo($box)

/* <ul class="box"> <li>i am child</li> <li>1</li> </ul> */

// before insertBefore
// $box.before(insertDom)
// $(insertDom).insertBefore($box)

/* <li>i am child</li> <ul class="box"> <li>1</li> </ul> */

 // after insertAfter
// $box.after(insertDom)
// $(insertDom).insertAfter($box)

/* <ul class="box"> <li>1</li> </ul> <li>i am child</li> */複製代碼

以上是append,appendTo,prepend,prependTo,after,insertAfter,before,insertBefore八個方法的基本用法,以及用過以後的dom結構。咱們總結一下他們的區別。

首先每一個方法的入參均可覺得html字符串,dom節點,或者節點組成的數組。參考自zeptojs_api

append,appendTo,prepend,prependTo都是在元素內部插入內容,而after,insertAfter,before,insertBefore則是在元素外部插入內容。

append,appendTo是在元素的末尾插入內容,prepend,prependTo是在元素的初始位置插入,after,insertAfter是在元素的後面插入內容,before,insertBefore則是在元素的前面插入內容

接下來咱們開始學習和閱讀實現這8大方法的核心源碼部分

adjacencyOperators = ['after', 'prepend', 'before', 'append']

adjacencyOperators.forEach(function(operator, operatorIndex) {
  var inside = operatorIndex % 2

  $.fn[operator] = function() {
    // arguments can be nodes, arrays of nodes, Zepto objects and HTML strings
    var argType, nodes = $.map(arguments, function(arg) {
      var arr = []
      argType = type(arg)
      if (argType == "array") {
        arg.forEach(function(el) {
          if (el.nodeType !== undefined) return arr.push(el)
          else if ($.zepto.isZ(el)) return arr = arr.concat(el.get())
          arr = arr.concat(zepto.fragment(el))
        })
        return arr
      }
      return argType == "object" || arg == null ?
        arg : zepto.fragment(arg)
    }),
        parent, copyByClone = this.length > 1
    if (nodes.length < 1) return this

    return this.each(function(_, target) {
      parent = inside ? target : target.parentNode

      // convert all methods to a "before" operation
      target = operatorIndex == 0 ? target.nextSibling :
      operatorIndex == 1 ? target.firstChild :
      operatorIndex == 2 ? target :
      null

      var parentInDocument = $.contains(document.documentElement, parent)

      nodes.forEach(function(node) {
        if (copyByClone) node = node.cloneNode(true)
        else if (!parent) return $(node).remove()

        parent.insertBefore(node, target)
        if (parentInDocument) traverseNode(node, function(el) {
          if (el.nodeName != null && el.nodeName.toUpperCase() === 'SCRIPT' &&
              (!el.type || el.type === 'text/javascript') && !el.src) {
            var target = el.ownerDocument ? el.ownerDocument.defaultView : window
            target['eval'].call(target, el.innerHTML)
          }
        })
          })
    })
  }複製代碼

遍歷adjacencyOperators數組給$原型添加對應的方法

adjacencyOperators = ['after', 'prepend', 'before', 'append']

adjacencyOperators.forEach(function(operator, operatorIndex) {
  // xxx
  $.fn[operator] = function() {
    // xxx
  }
  // xxx
})複製代碼

能夠看到經過循環遍歷adjacencyOperators從而給$的原型添加對應的方法。

轉換node節點

var argType, nodes = $.map(arguments, function(arg) {
  var arr = []
  argType = type(arg)
  if (argType == "array") {
    arg.forEach(function(el) {
      if (el.nodeType !== undefined) return arr.push(el)
      else if ($.zepto.isZ(el)) return arr = arr.concat(el.get())
      arr = arr.concat(zepto.fragment(el))
    })
    return arr
  }
  return argType == "object" || arg == null ?
    arg : zepto.fragment(arg)
})複製代碼

例子

// 1 html字符串
$box.append('<span>hello world</span>')
// 2 dom節點
$box.append(document.createElement('span'))
// 3 多個參數
$box.append('<span>1</span>', '<span>2</span>')
// 4 數組
$box.append(['<span>hello world</span>', document.createElement('span')])複製代碼

由於傳入的內容能夠爲html字符串,dom節點,或者節點組成的數組。這裏對可能的狀況分類型作了處理。經過內部的type函數判斷每一個參數的數據類型並保存在argType中。

當參數類型爲數組(相似上面例子中的4)的時候,再對該參數進行遍歷,若是該參數中的元素存在nodeType屬性則將該元素推動數組arr,
若是該參數中的元素是一個Zepto對象,則調用get方法,將arr與返回的原生元素數組進行合併。

當參數類型爲object或者null的時候直接返回,不然就是處理字符串形式了,經過調用zepto.fragment(這個函數在後面的文章中會詳細講解,如今就其理解爲將html字符串處理成dom節點數組就能夠了)處理並將結果返回。

到如今爲止,咱們已經明白了怎麼將傳入的content轉化爲對應的dom節點

接下來咱們來看如何將nodes中建立好的dom節點插入到目標位置。

parent, copyByClone = this.length > 1

if (nodes.length < 1) return this複製代碼

先留意一下parent,以及copyByClone這兩個變量,挺重要的,具體做用下面會詳細說明。而且若是須要插入的元素數組的長度小於1,那麼也就沒有必要繼續往下走了,直接return this進行鏈式操做。

return this.each(function(_, target) {
  // xxx
  nodes.forEach(function(node) {
    // xxx 
    // 注意這行,全部的插入操做都經過insertBefore函數完成
    parent.insertBefore(node, target)
    // xxx
  })

})複製代碼

整個後續代碼就是兩層嵌套循環,第一層遍歷當前選中的元素集合,第二層就是須要插入的nodes節點集合。經過兩個循環來最終完成元素的插入操做,而且很重要的一點是,不論是append仍是after等方法都是經過insertBefore來模擬完成的。

肯定parent節點以及target目標節點

經過上面的分析咱們知道經過insertBefore(在當前節點的某個子節點以前再插入一個子節點)來完成節點的插入,很重要的幾個因素就是

parentNode.insertBefore(newNode, referenceNode)

  1. 父節點(parentNode)
  2. 須要插入的新節點(newNode)
  3. 參考節點referenceNode

因此肯定以上1和3就顯得極其重要了。怎麼肯定呢?

return this.each(function(_, target) {
  parent = inside ? target : target.parentNode

  // convert all methods to a "before" operation
  target = operatorIndex == 0 ? target.nextSibling :
  operatorIndex == 1 ? target.firstChild :
  operatorIndex == 2 ? target :
  null
  // xxx
})複製代碼

inside是個啥啊!!!,讓咱們回到頂部看這段

adjacencyOperators = ['after', 'prepend', 'before', 'append']
adjacencyOperators.forEach(function (operator, operatorIndex) {
  var inside = operatorIndex % 2
  // xxx
})複製代碼

因此說當要往$原型上添加的方法是prependappend的時候inside爲1也就是真,當爲afterbefore的時候爲0也就是假。

由於prependappend都是往當前選中的元素內部添加新節點,因此parent固然就是target自己了,可是afterbefore確是要往選中的元素外部添加新節點,天然parent就變成了當前選中元素的父節點。到這裏上面的三要素1,已經明確了,還有3(target)如何肯定呢?

target = operatorIndex == 0 ? target.nextSibling :
  operatorIndex == 1 ? target.firstChild :
  operatorIndex == 2 ? target :
  null複製代碼
  1. 若是operatorIndex爲0,即after方法,node節點應該是插入到目標元素target的後面,也就是target的下一個兄弟節點的前面
  2. 若是operatorIndex爲1,即prepend方法,node應該插入到目標元素target的第一個子元素的前面
  3. 若是operatorIndex爲2,即before方法,node節點應該插入到target節點的前面
  4. 不然operatorIndex爲4了,即append方法,node節點應該插入到target最後一個子節點的末尾,insertBefore傳入null,正好與其功能相對應

好啦三要素3頁已經明確了,接下來咱們把重要放在第二個循環。

將新節點插入到指定位置

nodes.forEach(function(node) {
  if (copyByClone) node = node.cloneNode(true)
  else if (!parent) return $(node).remove()

  parent.insertBefore(node, target)
  // 處理插入script狀況
})複製代碼

在將節點插入到指定位置的前有一個判斷,若是copyByClone爲真,就將要插入的新節點複製一份。爲何要這麼作呢?咱們來看個例子。

<ul class="list">
  <li>1</li>
  <li>2</li>
  <li>3</li>
</ul>複製代碼
let $list = document.querySelector('.list')
  let $listLi = document.querySelectorAll('.list li')
  let createEle = (tagName, text) => {
    let ele = document.createElement(tagName)
    ele.innerHTML = text
    return ele
  }
  let $span1 = createEle('span', 'span1')
  let $span2 = createEle('span', 'span2')

  Array.from($listLi).forEach((target) => {
    [$span1, $span2].forEach((node) => {
      // node = node.cloneNode(true)
      $list.insertBefore(node, target)
    })
  })複製代碼

先將cloneNode那部分給註銷了,咱們指望往三個li的前面都插入兩個span,可是結果會怎麼樣呢?只有最後一個節點前面能夠成功地插入兩個span節點。這樣就不是咱們先要的結果了,根據insertBefore mdn解釋,若是newElement已經在DOM樹中,newElement首先會從DOM樹中移除。,因此當咱們須要往多個li中插入一樣相似的兩個節點的時候,才須要將新節點克隆一份再插入。

咱們接着回到源碼。

nodes.forEach(function(node) {
  if (copyByClone) node = node.cloneNode(true)
  else if (!parent) return $(node).remove()

  parent.insertBefore(node, target)
  // 處理插入script狀況
})複製代碼

若是須要(當前選中元素的個數大於1)克隆節點的時候,先將新節點克隆一份,若是沒有找到對應的parent節點,就講要插入的新節點刪除,最後經過insertBefore方法插入新節點。

到了這裏咱們彷佛已經完成了從

建立新節點 => 將新節點插入到指定位置的操做了。任務好像已經完成了,可是革命還沒有成功,同志仍需努力啊。接下來看最後一點代碼,主要是處理,當插入的節點是script
標籤的時候,須要手動去執行其包含的js代碼。

var parentInDocument = $.contains(document.documentElement, parent)

if (parentInDocument) traverseNode(node, function(el) {
  if (el.nodeName != null && el.nodeName.toUpperCase() === 'SCRIPT' &&
      (!el.type || el.type === 'text/javascript') && !el.src) {
    var target = el.ownerDocument ? el.ownerDocument.defaultView : window
    target['eval'].call(target, el.innerHTML)
  }
})複製代碼

先提早看一下traverseNode這個函數的代碼

function traverseNode(node, fun) {
  fun(node)
  for (var i = 0, len = node.childNodes.length; i < len; i++)
    traverseNode(node.childNodes[i], fun)
}複製代碼

這個函數的主要做用就是將傳入的node節點做爲參數去調用傳入的fun函數。而且遞歸的將node節點的子節點,交給fun去處理。

接下來繼續看。

首先經過$.contains方法判斷parent是否在document文檔中,接着須要知足一下幾個條件纔去執行後續操做。

  1. 存在nodeName屬性
  2. nodeName是script標籤
  3. type屬性爲空或者type屬性爲text/javascript
  4. src屬性爲空(即不指定外部腳本)

肯定window對象

var target = el.ownerDocument ? el.ownerDocument.defaultView : window複製代碼

新節點存在ownerDocument mdn則window對象爲defaultView mdn,不然使用window對象自己。

這裏主要會考慮node節點是iframe種的元素狀況,才須要作三目處理。

最後即是調用target['eval'].call(target, el.innerHTML)去執行script中的代碼了。

到這裏咱們終於知道了'after', 'prepend', 'before', 'append'實現全過程(偷樂一下😀,不容易啊)。

appendTo, prependTo, insertBefore, insertAfter

緊接着咱們繼續往前走,前面說了插入操做有不少個方法,其中
insertAfter,insertBefore,prependTo,appendTo的實現基於上述幾個方法。

// append => appendTo
// prepend => prependTo
// before => insertBefore
// after => insertAfter

$.fn[inside ? operator + 'To' : 'insert' + (operatorIndex ? 'Before' : 'After')] = function (html) {
  $(html)[operator](this)
  return this
}複製代碼

若是是append或者prepend則往$原型上添加appendToprependTo方法,若是是before或者after的時候,便往$的原型上添加insertBeforeinsertAfter方法。由於其兩兩對應的方法本質上是一樣的功能,只是在使用上有點相反的意思,因此簡單的反向調用一下就能夠了。

html

獲取或設置對象集合中元素的HTML內容。當沒有給定content參數時,返回對象集合中第一個元素的innerHtml。當給定content參數時,用其替換對象集合中每一個元素的內容。content能夠是append中描述的全部類型 zeptojs_api

例子

1. html()   ⇒ string

2. html(content)   ⇒ self

3. html(function(index, oldHtml){ ... })   ⇒ self複製代碼

源碼實現

html: function (html) {
  return 0 in arguments ?
    this.each(function (idx) {
      var originHtml = this.innerHTML
      $(this).empty().append(funcArg(this, html, idx, originHtml))
    }) :
    (0 in this ? this[0].innerHTML : null)
}複製代碼

當沒有傳html參數的時候,先判斷當前選中的元素是否存在,存在則讀取第一個元素的innerHTML並返回,不然直接返回null

(0 in this ? this[0].innerHTML : null)複製代碼

當傳了html參數的時候。對當前選中的元素集合進行遍歷設置,先保存當前元素的innerHTML到originHtml變量中,再將當前元素的innerHTML置空,並將funcArg函數執行以後返回的html插入到當前元素中。

function funcArg(context, arg, idx, payload) {
  return isFunction(arg) ? arg.call(context, idx, payload) : arg
}複製代碼

能夠看到funcArg會對傳入arg進行類型判斷,若是是函數,就把對應的參數傳入函數再將函數的執行結果返回,不是函數就直接返回arg。

text

獲取或者設置全部對象集合中元素的文本內容。當沒有給定content參數時,返回當前對象集合中第一個元素的文本內容(包含子節點中的文本內容)。當給定content參數時,使用它替換對象集合中全部元素的文本內容。它有待點似 html,與它不一樣的是它不能用來獲取或設置 HTML。zeptojs_api

text: function (text) {
  return 0 in arguments ?
    this.each(function (idx) {
      var newText = funcArg(this, text, idx, this.textContent)
      this.textContent = newText == null ? '' : '' + newText
    }) :
    (0 in this ? this.pluck('textContent').join("") : null)
}複製代碼

text實現方法與html比較相似有些不一樣的是沒有傳參數的時候,html是獲取第一個元素的innerHTMLtext則是將當前全部元素的textContent拼接起來並返回.

複製元素

clone

經過深度克隆來複制集合中的全部元素。zeptojs_api

clone: function () {
  return this.map(function () { return this.cloneNode(true) })
}複製代碼

對當前選中的元素集合進行遍歷操做,底層仍是用的瀏覽器cloneNode,並傳參爲true表示須要進行深度克隆(其實感受這裏是否是將true設置爲可選參數比較好呢,讓使用者決定是深度克隆與否不是更合理?)

須要注意的地方是cloneNode方法不會複製添加到DOM節點中的Javascript屬性,例如事件處理程序等,這個方法只複製特性,子節點,其餘一切都不會複製,IE在此存在一個bug,即他會賦值事件處理程序,因此咱們建議在賦值之間最好先移除事件處理程序(摘自《JavaScript高級程序設計第三版》10.1.1 Node類型小字部分)

替換元素

replaceWidth

用給定的內容替換全部匹配的元素。(包含元素自己) zeptojs_api

replaceWith: function(newContent) {
  return this.before(newContent).remove()
}複製代碼

源碼實現其實很簡單分兩步,第一步調用前面咱們講的before方法將制定newContent插入到元素的前面,第二部步將當前選中的元素刪除。天然也就達到了替換的目的。

包裹元素

wrapAll

在全部匹配元素外面包一個單獨的結構。結構能夠是單個元素或 幾個嵌套的元素zeptojs_api/#wrapAll

wrapAll: function (structure) {
  // 若是選中的元素存在
  if (this[0]) {
    // 則將制定structure結構經過before方法,插入到選中的第一個元素的前面
    $(this[0]).before(structure = $(structure))
    var children
    // drill down to the inmost element
    // 獲取structure的最深層次的第一個子元素
    while ((children = structure.children()).length) structure = children.first()
    // 將當前的元素集合經過append方法添加到structure末尾
    $(structure).append(this)
  }
  // 反則直接返回this進行後續的鏈式操做
  return this
}複製代碼

源碼實現直接看註釋就能夠了,這裏須要注意一下children函數是獲取對象集合中全部的直接子節點。而first函數則是獲取當前集合的第一個元素。

另外咱們看一下下面兩個例子。

<ul class="box">
  <li>1</li>
  <li>2</li>
</ul>
<div class="wrap">
</div>
<div class="wrap">
</div>複製代碼
$('.box').wrapAll('.wrap')複製代碼

執行上述代碼以後dom結構會變成

<div class="wrap">
  <ul class="box">
    <li>1</li>
    <li>2</li>
  </ul>
</div>

<div class="wrap">
  <ul class="box">
    <li>1</li>
    <li>2</li>
  </ul>
</div>

<ul class="box">
  <li>1</li>
  <li>2</li>
</ul>複製代碼

能夠看到原來ul結構仍是存在,彷彿是複製了一份ul及其子節點到wrap中被包裹起來。

接下來再看一個例子,惟一的區別就在wrap結構中嵌套了基層。

<ul class="box">
    <li>1</li>
    <li>2</li>
</ul>
<div class="wrap">
  <div class="here"></div>
  <div></div>
</div>
<div class="wrap">
  <div class="here"></div>
  <div></div>
</div>複製代碼

可是最後執行$('.box').wrapAll('.wrap')獲得的dom結果是。

<div class="wrap">
  <div class="here">
    <ul class="box">
      <li>1</li>
      <li>2</li>
    </ul>
  </div>
  <div></div>
</div>

<div class="wrap">
  <div class="here"></div>
  <div></div>
</div>複製代碼

嘿嘿能夠看到,ul原來的結構不見了,被移動到了第一個wrap的第一個子節點here中。具體緣由是什麼呢?你們能夠從新回去看一下append的核心實現。

wrap

在每一個匹配的元素外層包上一個html元素。structure參數能夠是一個單獨的元素或者一些嵌套的元素。也能夠是一個html字符串片斷或者dom節點。還能夠是一個生成用來包元素的回調函數,這個函數返回前兩種類型的包裹片斷。zeptojs_api/#wrapAll

wrap: function (structure) {
  var func = isFunction(structure)
  // 當前選中的元素不爲空,而且structure不是一個函數
  if (this[0] && !func)
    // 就將structure轉化後的第一個元素賦值給dom元素
    var dom = $(structure).get(0),
      // 若是dom元素的parentNode存在或者當前選中的元素個數大於1那麼clone爲true
      clone = dom.parentNode || this.length > 1
  // 對當前選中元素進行遍歷而且調用wrapAll方法
  return this.each(function (index) {
    $(this).wrapAll(
      // 若是structure爲函數,則將當前的元素和對應的索引傳入函數
      func ? structure.call(this, index) :
        // 若是clone爲true,則使用拷貝的副本
        clone ? dom.cloneNode(true) : dom
    )
  })
}複製代碼

wrapInner

將每一個元素中的內容包裹在一個單獨的結構中 zeptojs_api/#wrapInner

wrapInner: function (structure) {
  // 判斷structure是否爲函數
  var func = isFunction(structure)
  // 對當前元素集合進行遍歷處理
  return this.each(function (index) {
    // contents => 獲取當前元素的全部子節點(包括元素節點和文本節點)
    var self = $(this), contents = self.contents(),
      // structure爲函數則將其執行結果賦值爲dom,不然直接將其賦值
      dom = func ? structure.call(this, index) : structure
      // 當前元素的子節點不爲空,則調用wrapAll,不然直接將dom插入self當前元素便可
    contents.length ? contents.wrapAll(dom) : self.append(dom)
  })
}複製代碼

須要注意的是這個函數和前面的wrapAll和wrap有點不同,這裏強調的是將當前元素中的內容(包括元素節點和文本節點)進行包裹。

unwrap

移除集合中每一個元素的直接父節點,並把他們的子元素保留在原來的位置

unwrap: function () {
  // 經過parent()獲取當前元素集合的全部直接父節點
  // 將獲取到的父節點集合進行遍歷
  this.parent().each(function () {
    // 將該父節點替換爲該父節點的全部子節點
    $(this).replaceWith($(this).children())
  })
  return this
},複製代碼

結尾

呼呼呼,終於寫完了,快累死了。歡迎你們指正文中的問題。

參考

讀Zepto源碼之操做DOM

Zepto源碼分析-zepto模塊

ownerDocument

insertBefore

innerHTML

《JavaScript高級程序設計第三版》

文章記錄

form模塊

  1. zepto源碼分析之form模塊(2017-10-01)

zepto模塊

  1. 這些Zepto中實用的方法集(2017-08-26)
  2. Zepto核心模塊之工具方法拾遺 (2017-08-30)
  3. 看zepto如何實現增刪改查DOM (2017-10-2)

event模塊

  1. mouseenter與mouseover爲什麼這般糾纏不清?(2017-06-05)
  2. 向zepto.js學習如何手動觸發DOM事件(2017-06-07)
  3. 誰說你只是"會用"jQuery?(2017-06-08)

ajax模塊

  1. 原來你是這樣的jsonp(原理與具體實現細節)(2017-06-11)
相關文章
相關標籤/搜索