像 jQuery 一样封装 API

一、前言

jQuery 作为 JavaScript 函数库,是一种特定种类的API。它的功能强大而丰富,帮助解放了DOM API。即使在如今框架盛行的时代,仍然值得我们学习。
在正式学习使用 jQuery API 之前,让我们仿造其形式试着自己封装两个 API 。

二、实现目标

封装 addClass、setText 两个函数,实现
① 为元素批量添加类
② 设置元素中的文本内容

var $div = $('div')
$div.addClass('red') // 可将所有 div 的 class 添加一个 red
$div.setText('hi') // 可将所有 div 的 textContent 变为 hi

三、步骤

1. 封装三个好用的函数 getSiblings、addClass、setText。
// 匹配 节点node
function getSiblings(node) {
    var allChildren = node.parentNode.children
    var arr = { length: 0 }
    for (let i in allChildren) {
        if (allChildren[i] != node) {
            arr[arr.length] = allChildren[i]
            arr.length += 1
        }
    }
    return arr
}

function addClass(node, thoseClass) {
    // 参数 thoseClass 支持字符串和数组
    if(typeof thoseClass === 'string') {
        node.classList.add(thoseClass)
    }else if(Array.isArray(thoseClass)) {
        thoseClass.forEach( value => node.classList.add(value) ) 
    }
}

function setText(node, content) {
    node.textContent = content
}

console.log( getSiblings(node) )
addClass(node, ['red', 'big', 'center'])
setText(node, 'hi')

使用命名空间,如库YUI

xinDom = { 
    addClass: function(node, thoseClass) {
        // 参数 thoseClass 支持字符串和数组
        if(typeof thoseClass === 'string') {
            node.classList.add(thoseClass)
        }else if(Array.isArray(thoseClass)) {
            thoseClass.forEach( value => node.classList.add(value) ) 
        }
    },
    setText: function (node, content) {
        node.textContent = content
    }
}
xinDom.addClass(node, ['red', 'big', 'center'])
xinDom.setText(node, 'hi')
2. 节点node 放到前面调用
1)扩展Node接口。将函数添加到 节点原型(Node.prototype)中,则节点node可直接调用
Node.prototype.addClass = function(thoseClass) {
    // 使用 this 得到 节点node
     if(typeof thoseClass === 'string') {
        this.classList.add(thoseClass)
    }else if(Array.isArray(thoseClass)) {                         
        thoseClass.forEach( value => this.classList.add(value) )        
    }
}

Node.prototype.setText = function(content) {
    this.textContent = content
}

node.addClass.call(node, 'red') // 或 node.addClass('red')
node.setText.call(node, 'hi')   // 或 node.setText('hi')
  • 这种方式可能因重名导致互相覆盖,从而扰乱了已有的原型。因此使用第 2)种方法。
2)使用新的接口。创建一个构造函数 jQuery,返回封装了自有API的对象
  • 不止接受节点
// 匹配 节点node 或 选择器
window.jQuery = function(nodeOrSelector) {

    var nodes = {}
    if(typeof nodeOrSelector === 'string') {
        
        var tmp = document.querySelectorAll(nodeOrSelector)
        nodes.length = tmp.length
        for(var i=0; i<tmp.length; i++) {
            nodes[i] = tmp[i]
        }

    }else if(nodeOrSelector instanceof Node) {
        nodes = {
            0: nodeOrSelector,
            length: 1
        }
    }

    return {
        elements: nodes,
        addClass: function(thoseClass) {

            if(typeof thoseClass === 'string') {
                for(var i=0; i<nodes.length; i++) {
                    nodes[i].classList.add(thoseClass)
                }
            }else if(Array.isArray(thoseClass)) {
                for(var i=0; i<nodes.length; i++) {                            
                    thoseClass.forEach( value => nodes[i].classList.add(value) )
                }
            }

        },
        setText: function(content) {                    

            for(var i=0; i<nodes.length; i++) {
                nodes[i].textContent = content
            }
            
        }
    }
}

jQuery('div').setText('hi')
  • jQuery 这个函数中使用到了闭包。
3. 使用缩写,$ 指代 jQuery
window.$ = jQuery

var $div = $('div')
$div.addClass('red') // 可将所有 div 的 class 添加一个 red
$div.setText('hi')
  • 通过上述仿造 jQuery 封装 API 的过程,可窥见 jQuery 的本质,是一个构造函数接收一个节点或符合某要求的字符串(如选择器),然后返回给我们一个含有丰富 API 的对象,通过调用 API 来操作相应的 DOM 对象。
    【不成文的规定】jQuery 构造出的对象,其引用变量会以 $ 开头,与普通变量区分开。

四、jQuery 只是这样?

窥探了 jQuery 本质,它的强大并不仅限如此,jQuery 函数库的优点概括:

  1. 兼容性方面做得很棒。
  2. 不止提供了便捷的 DOM 操作,还有动画、Ajax等丰富的功能。
  3. jQuery 不仅使用了 prototype,还使用了 new(还未学到)。
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容

  • 一、样式篇 第1章 初识jQuery (1)环境搭建 进入官方网站获取最新的版本 http://jquery.co...
    凛0_0阅读 3,350评论 0 44
  • jQuery jQuery是JavaScript世界中使用最广泛的一个库。 jQuery这么流行,肯定是因为它解决...
    星腾_范特西阅读 2,079评论 0 27
  • 概要 64学时 3.5学分 章节安排 电子商务网站概况 HTML5+CSS3 JavaScript Node 电子...
    阿啊阿吖丁阅读 9,072评论 0 3
  • 第一章 jQuery简介 1-1 jQuery简介 1.简介 2.优势 3.特性与工具方法 1-2 环境搭建 进入...
    mo默22阅读 1,573评论 0 11
  • 美好的一天开始啦! 挥挥小手我们来给每位小朋友问好吧 “早上好 ,早上好,早上好” 今天我们班来了一位新同学——星...
    apple_Mia阅读 291评论 0 0