JavaScript教程8 - jQuery

jQuery

jQuery這麼流行,肯定是因爲它解決了一些很重要的問題。實際上,jQuery能幫我們幹這些事情:

  • 消除瀏覽器差異:你不需要自己寫冗長的代碼來針對不同的瀏覽器來綁定事件,編寫AJAX等代碼;
  • 簡潔的操作DOM的方法:寫$(’#test’)肯定比document.getElementById(‘test’)來得簡潔;
  • 輕鬆實現動畫、修改CSS等各種操作。

jQuery的理念“Write Less, Do More“,讓你寫更少的代碼,完成更多的工作!

使用jQuery

使用jQuery只需要在頁面的引入jQuery文件即可:

<html>
<head>
    <script src="//code.jquery.com/jquery-1.11.3.min.js"></script>
	...
</head>
<body>
    ...
</body>
</html>
console.log('jQuery版本:' + $.fn.jquery);

$符號

jQueryjQueryjQuery是著名的jQuery符號。實際上,jQuery把所有功能全部封裝在一個全局變量jQuery中,而也是一個合法的變量名,它是變量jQuery的別名:

window.jQuery; // jQuery(selector, context)
window.$; // jQuery(selector, context)
$ === jQuery; // true
typeof($); // 'function'

本質上就是一個函數,但是函數也是對象,於是除了可以直接調用外,也可以有很多其他屬性。


選擇器

選擇器是jQuery的核心。一個選擇器寫出來類似$(’#dom-id’)。

按ID查找

如果某個DOM節點有id屬性,利用jQuery查找如下:

// 查找<div id="abc">:
var div = $('#abc');

注意,#abc以#開頭。返回的對象是jQuery對象。

什麼是jQuery對象?jQuery對象類似數組,它的每個元素都是一個引用了DOM節點的對象。

總之jQuery的選擇器不會返回undefined或者null,這樣的好處是你不必在下一行判斷if (div === undefined)。

jQuery對象和DOM對象之間可以互相轉化:

var div = $('#abc'); // jQuery對象
var divDom = div.get(0); // 假設存在div,獲取第1個DOM元素
var another = $(divDom); // 重新把DOM包裝爲jQuery對象

通常情況下你不需要獲取DOM對象,直接使用jQuery對象更加方便。如果你拿到了一個DOM對象,那可以簡單地調用$(aDomObject)把它變成jQuery對象,這樣就可以方便地使用jQuery的API了。

按tag查找

按tag查找只需要寫上tag名稱就可以了:

var ps = $('p'); // 返回所有<p>節點
ps.length; // 數一數頁面有多少個<p>節點

按class查找

按class查找注意在class名稱前加一個.:

var a = $('.red'); // 所有節點包含`class="red"`都將返回
// 例如:
// <div class="red">...</div>
// <p class="green red">...</p>

通常很多節點有多個class,我們可以查找同時包含red和green的節點:

var a = $('.red.green'); // 注意沒有空格!
// 符合條件的節點:
// <div class="red green">...</div>
// <div class="blue green red">...</div>

按屬性查找

一個DOM節點除了id和class外還可以有很多屬性,很多時候按屬性查找會非常方便,比如在一個表單中按屬性來查找:

var email = $('[name=email]'); // 找出<??? name="email">
var passwordInput = $('[type=password]'); // 找出<??? type="password">
var a = $('[items="A B"]'); // 找出<??? items="A B">

當屬性的值包含空格等特殊字符時,需要用雙引號括起來

按屬性查找還可以使用前綴查找或者後綴查找:

var icons = $('[name^=icon]'); // 找出所有name屬性值以icon開頭的DOM
// 例如: name="icon-1", name="icon-2"
var names = $('[name$=with]'); // 找出所有name屬性值以with結尾的DOM
// 例如: name="startswith", name="endswith"

這個方法尤其適合通過class屬性查找,且不受class包含多個名稱的影響:

var icons = $('[class^="icon-"]'); // 找出所有class包含至少一個以`icon-`開頭的DOM
// 例如: class="icon-clock", class="abc icon-home"

組合查找

組合查找就是把上述簡單選擇器組合起來使用。如果我們查找$(’[name=email]’),很可能把表單外的

也找出來,但我們只希望查找,就可以這麼寫:

var emailInput = $('input[name=email]'); // 不會找出<div name="email">

同樣的,根據tag和class來組合查找也很常見:

var tr = $('tr.red'); // 找出<tr class="red ...">...</tr>

多項選擇器

多項選擇器就是把多個選擇器用,組合起來一塊選:

$('p,div'); // 把<p>和<div>都選出來
$('p.red,p.green'); // 把<p class="red">和<p class="green">都選出來

要注意的是,選出來的元素是按照它們在HTML中出現的順序排列的,而且不會有重複元素。例如,

不會被上面的$(‘p.red,p.green’)選擇兩次。

練習

使用jQuery選擇器分別選出指定元素:

  • 僅選擇JavaScript
  • 僅選擇Erlang
  • 選擇JavaScript和Erlang
  • 選擇所有編程語言
  • 選擇名字input
  • 選擇郵件和名字input
<!-- HTML結構 -->
<div id="test-jquery">
    <p id="para-1" class="color-red">JavaScript</p>
    <p id="para-2" class="color-green">Haskell</p>
    <p class="color-red color-green">Erlang</p>
    <p name="name" class="color-black">Python</p>
    <form class="test-form" target="_blank" action="#0" onsubmit="return false;">
        <legend>註冊新用戶</legend>
        <fieldset>
            <p><label>名字: <input name="name"></label></p>
            <p><label>郵件: <input name="email"></label></p>
            <p><label>口令: <input name="password" type="password"></label></p>
            <p><button type="submit">註冊</button></p>
        </fieldset>
    </form>
</div>
'use strict';

var selected = null;

// 僅選擇JavaScript
selected = $('#para-1');

// 僅選擇Erlang
selected = $('.color-red.color-green');

// 選擇JavaScript和Erlang
selected = $('.color-red');

//選擇所有編程語言
selected = $('p[class^="color-"]');

// 選擇名字input
selected = $('input[name=name]');

// 選擇郵件和名字input
selected = $('input[name=email],input[name=name]');

層級選擇器(Descendant Selector)

如果兩個DOM元素具有層級關係,就可以用$(‘ancestor descendant’)來選擇,層級之間用空格隔開。例如:

<!-- HTML結構 -->
<div class="testing">
    <ul class="lang">
        <li class="lang-javascript">JavaScript</li>
        <li class="lang-python">Python</li>
        <li class="lang-lua">Lua</li>
    </ul>
</div>

要選出JavaScript,可以用層級選擇器:

$('ul.lang li.lang-javascript'); // [<li class="lang-javascript">JavaScript</li>]
$('div.testing li.lang-javascript'); // [<li class="lang-javascript">JavaScript</li>]

因爲

    都是
  • 的祖先節點,所以上面兩種方式都可以選出相應的
  • 節點。

要選擇所有的

  • 節點,用:
  • $('ul.lang li');
    

    這種層級選擇器相比單個的選擇器好處在於,它縮小了選擇範圍,因爲首先要定位父節點,才能選擇相應的子節點,這樣避免了頁面其他不相關的元素。

    例如:

    $('form[name=upload] input');
    

    就把選擇範圍限定在name屬性爲upload的表單裏。如果頁面有很多表單,其他表單的不會被選擇。

    多層選擇也是允許的:

    $('form.test p input'); // 在form表單選擇被<p>包含的<input>
    

    子選擇器(Child Selector)

    子選擇器$(‘parent>child’)類似層級選擇器,但是限定了層級關係必須是父子關係,就是節點必須是節點的直屬子節點。還是以上面的例子:

    $('ul.lang>li.lang-javascript'); // 可以選出[<li class="lang-javascript">JavaScript</li>]
    $('div.testing>li.lang-javascript'); // [], 無法選出,因爲<div>和<li>不構成父子關係
    

    過濾器(Filter)

    過濾器一般不單獨使用,它通常附加在選擇器上,幫助我們更精確地定位元素。觀察過濾器的效果:

    $('ul.lang li'); // 選出JavaScript、Python和Lua 3個節點
    $('ul.lang li:first-child'); // 僅選出JavaScript
    $('ul.lang li:last-child'); // 僅選出Lua
    $('ul.lang li:nth-child(2)'); // 選出第N個元素,N從1開始
    $('ul.lang li:nth-child(even)'); // 選出序號爲偶數的元素
    $('ul.lang li:nth-child(odd)'); // 選出序號爲奇數的元素
    

    表單相關

    針對表單元素,jQuery還有一組特殊的選擇器:

    • :input:可以選擇,,和;
    • :file:可以選擇,和input[type=file]一樣;
    • :checkbox:可以選擇複選框,和input[type=checkbox]一樣;
    • :radio:可以選擇單選框,和input[type=radio]一樣;
    • :focus:可以選擇當前輸入焦點的元素,例如把光標放到一個上,用$(‘input:focus’)就可以選出;
    • :checked:選擇當前勾上的單選框和複選框,用這個選擇器可以立刻獲得用戶選擇的項目,如$(‘input[type=radio]:checked’);
    • :enabled:可以選擇可以正常輸入的、 等,也就是沒有灰掉的輸入;
    • :disabled:和:enabled正好相反,選擇那些不能輸入的。

    此外,jQuery還有很多有用的選擇器,例如,選出可見的或隱藏的元素:

    $('div:visible'); // 所有可見的div
    $('div:hidden'); // 所有隱藏的div
    

    查找

    <!-- HTML結構 -->
    <ul class="lang">
        <li class="js dy">JavaScript</li>
        <li class="dy">Python</li>
        <li id="swift">Swift</li>
        <li class="dy">Scheme</li>
        <li name="haskell">Haskell</li>
    </ul>
    

    用find()查找:

    var ul = $('ul.lang'); // 獲得<ul>
    var dy = ul.find('.dy'); // 獲得JavaScript, Python, Scheme
    var swf = ul.find('#swift'); // 獲得Swift
    var hsk = ul.find('[name=haskell]'); // 獲得Haskell
    

    如果要從當前節點開始向上查找,使用parent()方法:

    var swf = $('#swift'); // 獲得Swift
    var parent = swf.parent(); // 獲得Swift的上層節點<ul>
    var a = swf.parent('.red'); // 獲得Swift的上層節點<ul>,同時傳入過濾條件。如果ul不符合條件,返回空jQuery對象
    

    對於位於同一層級的節點,可以通過next()和prev()方法,例如:

    當我們已經拿到Swift節點後:

    var swift = $('#swift');
    
    swift.next(); // Scheme
    swift.next('[name=haskell]'); // 空的jQuery對象,因爲Swift的下一個元素Scheme不符合條件[name=haskell]
    
    swift.prev(); // Python
    swift.prev('.dy'); // Python,因爲Python同時符合過濾器條件.dy
    

    過濾

    和函數式編程的map、filter類似,jQuery對象也有類似的方法。

    filter()方法可以過濾掉不符合選擇器條件的節點:

    var langs = $('ul.lang li'); // 拿到JavaScript, Python, Swift, Scheme和Haskell
    var a = langs.filter('.dy'); // 拿到JavaScript, Python, Scheme
    

    或者傳入一個函數,要特別注意函數內部的this被綁定爲DOM對象,不是jQuery對象:

    var langs = $('ul.lang li'); // 拿到JavaScript, Python, Swift, Scheme和Haskell
    langs.filter(function () {
        return this.innerHTML.indexOf('S') === 0; // 返回S開頭的節點
    }); // 拿到Swift, Scheme
    

    map()方法把一個jQuery對象包含的若干DOM節點轉化爲其他對象:

    var langs = $('ul.lang li'); // 拿到JavaScript, Python, Swift, Scheme和Haskell
    var arr = langs.map(function () {
        return this.innerHTML;
    }).get(); // 用get()拿到包含string的Array:['JavaScript', 'Python', 'Swift', 'Scheme', 'Haskell']
    

    此外,一個jQuery對象如果包含了不止一個DOM節點,first()、last()和slice()方法可以返回一個新的jQuery對象,把不需要的DOM節點去掉:

    var langs = $('ul.lang li'); // 拿到JavaScript, Python, Swift, Scheme和Haskell
    var js = langs.first(); // JavaScript,相當於$('ul.lang li:first-child')
    var haskell = langs.last(); // Haskell, 相當於$('ul.lang li:last-child')
    var sub = langs.slice(2, 4); // Swift, Scheme, 參數和數組的slice()方法一致
    

    操作DOM

    修改Text和HTML

    jQuery對象的text()和html()方法分別獲取節點的文本和原始HTML文本,例如,如下的HTML結構:

    <!-- HTML結構 -->
    <ul id="test-ul">
        <li class="js">JavaScript</li>
        <li name="book">Java &amp; JavaScript</li>
    </ul>
    

    分別獲取文本和HTML:

    $('#test-ul li[name=book]').text(); // 'Java & JavaScript'
    $('#test-ul li[name=book]').html(); // 'Java &amp; JavaScript'
    

    如何設置文本或HTML?jQuery的API設計非常巧妙:無參數調用text()是獲取文本,傳入參數就變成設置文本,HTML也是類似操作,自己動手試試:

    'use strict';
    var j1 = $('#test-ul li.js');
    var j2 = $('#test-ul li[name=book]');
    j1.html('<span style="color: red">JavaScript</span>');
    j2.text('JavaScript & ECMAScript');
    

    一個jQuery對象可以包含0個或任意個DOM對象,它的方法實際上會作用在對應的每個DOM節點上。

    $('#test-ul li').text('JS'); // 兩個節點都變成了JS
    

    所以jQuery對象的另一個好處是我們可以執行一個操作,作用在對應的一組DOM節點上。即使選擇器沒有返回任何DOM節點,調用jQuery對象的方法仍然不會報錯:

    // 如果不存在id爲not-exist的節點:
    $('#not-exist').text('Hello'); // 代碼不報錯,沒有節點被設置爲'Hello'
    

    這意味着jQuery幫你免去了許多if語句。

    修改CSS

    jQuery對象有“批量操作”的特點,這用於修改CSS實在是太方便了。考慮下面的HTML結構:

    <!-- HTML結構 -->
    <ul id="test-css">
        <li class="lang dy"><span>JavaScript</span></li>
        <li class="lang"><span>Java</span></li>
        <li class="lang dy"><span>Python</span></li>
        <li class="lang"><span>Swift</span></li>
        <li class="lang dy"><span>Scheme</span></li>
    </ul>
    

    要高亮顯示動態語言,調用jQuery對象的css(‘name’, ‘value’)方法,我們用一行語句實現:

    'use strict';
    $('#test-css li.dy>span').css('background-color', '#ffd351').css('color', 'red');
    

    注意,jQuery對象的所有方法都返回一個jQuery對象(可能是新的也可能是自身),這樣我們可以進行鏈式調用,非常方便。

    jQuery對象的css()方法可以這麼用:

    var div = $('#test-div');
    div.css('color'); // '#000033', 獲取CSS屬性
    div.css('color', '#336699'); // 設置CSS屬性
    div.css('color', ''); // 清除CSS屬性
    

    爲了和JavaScript保持一致,CSS屬性可以用’background-color’和’backgroundColor’兩種格式。

    css()方法將作用於DOM節點的style屬性,具有最高優先級。如果要修改class屬性,可以用jQuery提供的下列方法:

    var div = $('#test-div');
    div.hasClass('highlight'); // false, class是否包含highlight
    div.addClass('highlight'); // 添加highlight這個class
    div.removeClass('highlight'); // 刪除highlight這個class
    

    練習:分別用css()方法和addClass()方法高亮顯示JavaScript:

    <!-- HTML結構 -->
    <style>
    .highlight {
        color: #dd1144;
        background-color: #ffd351;
    }
    </style>
    
    <div id="test-highlight-css">
        <ul>
            <li class="py"><span>Python</span></li>
            <li class="js"><span>JavaScript</span></li>
            <li class="sw"><span>Swift</span></li>
            <li class="hk"><span>Haskell</span></li>
        </ul>
    </div>
    
    'use strict';
    var div = $('#test-highlight-css');
    
    //div.find('.js').addClass('highlight');
    
    div.find('.js').css('color','#dd1144').css('background-color','#ffd351');
    

    顯示和隱藏DOM

    要隱藏一個DOM,我們可以設置CSS的display屬性爲none,利用css()方法就可以實現。不過,要顯示這個DOM就需要恢復原有的display屬性,這就得先記下來原有的display屬性到底是block還是inline還是別的值。

    考慮到顯示和隱藏DOM元素使用非常普遍,jQuery直接提供show()和hide()方法,我們不用關心它是如何修改display屬性的,總之它能正常工作:

    var a = $('a[target=_blank]');
    a.hide(); // 隱藏
    a.show(); // 顯示
    

    注意,隱藏DOM節點並未改變DOM樹的結構,它隻影響DOM節點的顯示。這和刪除DOM節點是不同的。

    獲取DOM信息

    利用jQuery對象的若干方法,我們直接可以獲取DOM的高寬等信息,而無需針對不同瀏覽器編寫特定代碼:

    / 瀏覽器可視窗口大小:
    $(window).width(); // 800
    $(window).height(); // 600
    
    // HTML文檔大小:
    $(document).width(); // 800
    $(document).height(); // 3500
    
    // 某個div的大小:
    var div = $('#test-div');
    div.width(); // 600
    div.height(); // 300
    div.width(400); // 設置CSS屬性 width: 400px,是否生效要看CSS是否有效
    div.height('200px'); // 設置CSS屬性 height: 200px,是否生效要看CSS是否有效
    

    **attr()removeAttr()**方法用於操作DOM節點的屬性:

    // <div id="test-div" name="Test" start="1">...</div>
    var div = $('#test-div');
    div.attr('data'); // undefined, 屬性不存在
    div.attr('name'); // 'Test'
    div.attr('name', 'Hello'); // div的name屬性變爲'Hello'
    div.removeAttr('name'); // 刪除name屬性
    div.attr('name'); // undefined
    

    **prop()**方法和attr()類似,但是HTML5規定有一種屬性在DOM節點中可以沒有值,只有出現與不出現兩種,例如:

    <input id="test-radio" type="radio" name="test" checked value="1">
    

    等價於:

    <input id="test-radio" type="radio" name="test" checked="checked" value="1">
    

    attr()和prop()對於屬性checked處理有所不同:

    var radio = $('#test-radio');
    radio.attr('checked'); // 'checked'
    radio.prop('checked'); // true
    

    prop()返回值更合理一些。不過,用**is()**方法判斷更好:

    var radio = $('#test-radio');
    radio.is(':checked'); // true
    

    類似的屬性還有selected,處理時最好用is(’:selected’)。

    操作表單

    對於表單元素,jQuery對象統一提供val()方法獲取和設置對應的value屬性:

    /*
        <input id="test-input" name="email" value="">
        <select id="test-select" name="city">
            <option value="BJ" selected>Beijing</option>
            <option value="SH">Shanghai</option>
            <option value="SZ">Shenzhen</option>
        </select>
        <textarea id="test-textarea">Hello</textarea>
    */
    var
        input = $('#test-input'),
        select = $('#test-select'),
        textarea = $('#test-textarea');
    
    input.val(); // 'test'
    input.val('[email protected]'); // 文本框的內容已變爲[email protected]
    
    select.val(); // 'BJ'
    select.val('SH'); // 選擇框已變爲Shanghai
    
    textarea.val(); // 'Hello'
    textarea.val('Hi'); // 文本區域已更新爲'Hi'
    

    可見,一個val()就統一了各種輸入框的取值和賦值的問題。

    添加DOM

    要添加新的DOM節點,

    • 通過jQuery的**html()**這種暴力方法外,
    • 還可以用**append()**方法
    • 除了接受字符串,append()還可以傳入原始的DOM對象,jQuery對象和函數對象
    • 如果要把新節點插入到指定位置,例如,JavaScript和Python之間,那麼,可以先定位到JavaScript,然後用**after()**方法

    刪除節點

    要刪除DOM節點,拿到jQuery對象後直接調用remove()方法就可以了。如果jQuery對象包含若干DOM節點,實際上可以一次刪除多個DOM節點:

    var li = $('#test-div>ul>li');
    li.remove(); // 所有<li>全被刪除
    

    練習

    除了列出的3種語言外,請再添加Pascal、Lua和Ruby,然後按字母順序排序節點:

    <!-- HTML結構 -->
    <div id="test-div">
        <ul>
            <li><span>JavaScript</span></li>
            <li><span>Python</span></li>
            <li><span>Swift</span></li>
        </ul>
    </div>
    
    'use strict';
    
    var ul = $("#test-div ul");
    ul.append("<li><span>Pascal</span></li>")
      .append("<li><span>Lua</span></li>")
      .append("<li><span>Ruby</span></li>");
    var sli = ul.find("li");
    sli.sort((a, b) => {
      a = a.innerHTML;
      b = b.innerHTML;
      return a.localeCompare(b);
    });
    ul.append(sli);
    

    事件

    因爲JavaScript在瀏覽器中以單線程模式運行,頁面加載後,一旦頁面上所有的JavaScript代碼被執行完後,就只能依賴觸發事件來執行JavaScript代碼

    瀏覽器在接收到用戶的鼠標或鍵盤輸入後,會自動在對應的DOM節點上觸發相應的事件。如果該節點已經綁定了對應的JavaScript處理函數,該函數就會自動調用。

    由於不同的瀏覽器綁定事件的代碼都不太一樣,所以用jQuery來寫代碼,就屏蔽了不同瀏覽器的差異,我們總是編寫相同的代碼。

    舉個例子,假設要在用戶點擊了超鏈接時彈出提示框,我們用jQuery這樣綁定一個click事件:

    /* HTML:
     *
     * <a id="test-link" href="#0">點我試試</a>
     *
     */
    
    // 獲取超鏈接的jQuery對象:
    var a = $('#test-link');
    a.on('click', function () {
        alert('Hello!');
    });
    

    on方法用來綁定一個事件,我們需要傳入事件名稱和對應的處理函數。

    另一種更簡化的寫法是直接調用click()方法:

    a.click(function () {
        alert('Hello!');
    });
    

    jQuery能夠綁定的事件主要包括:

    鼠標事件

    click: 鼠標單擊時觸發; dblclick:鼠標雙擊時觸發; mouseenter:鼠標進入時觸發; mouseleave:鼠標移出時觸發; mousemove:鼠標在DOM內部移動時觸發; hover:鼠標進入和退出時觸發兩個函數,相當於mouseenter加上mouseleave。

    鍵盤事件

    鍵盤事件僅作用在當前焦點的DOM上,通常是和。

    keydown:鍵盤按下時觸發; keyup:鍵盤松開時觸發; keypress:按一次鍵後觸發。

    其他事件

    focus:當DOM獲得焦點時觸發; blur:當DOM失去焦點時觸發; change:當、或的內容改變時觸發; submit:當提交時觸發; ready:當頁面被載入並且DOM樹完成初始化後觸發。

    其中,ready僅作用於document對象。由於ready事件在DOM完成初始化後觸發,且只觸發一次,所以非常適合用來寫其他的初始化代碼。假設我們想給一個表單綁定submit事件,下面的代碼沒有預期的效果:

    <html>
    <head>
        <script>
            // 代碼有誤:
            $('#testForm).on('submit', function () {
                alert('submit!');
            });
        </script>
    </head>
    <body>
        <form id="testForm">
            ...
        </form>
    </body>
    

    因爲JavaScript在此執行的時候,尚未載入瀏覽器,所以$(’#testForm)返回[],並沒有綁定事件到任何DOM上。

    所以我們自己的初始化代碼必須放到document對象的ready事件中,保證DOM已完成初始化

    <html>
    <head>
        <script>
            $(document).on('ready', function () {
                $('#testForm).on('submit', function () {
                    alert('submit!');
                });
            });
        </script>
    </head>
    <body>
        <form id="testForm">
            ...
        </form>
    </body>
    

    這樣寫就沒有問題了。因爲相關代碼會在DOM樹初始化後再執行。

    由於ready事件使用非常普遍,所以可以這樣簡化:

    $(document).ready(function () {
        // on('submit', function)也可以簡化:
        $('#testForm).submit(function () {
            alert('submit!');
        });
    });
    

    甚至還可以再簡化爲:

    $(function () {
        // init...
    });
    

    上面的這種寫法最爲常見。如果你遇到$(function () {…})的形式,牢記這是document對象的ready事件處理函數。

    完全可以反覆綁定事件處理函數,它們會依次執行:

    $(function () {
        console.log('init A...');
    });
    $(function () {
        console.log('init B...');
    });
    $(function () {
        console.log('init C...');
    });
    

    事件參數

    有些事件,如mousemove和keypress,我們需要獲取鼠標位置和按鍵的值,否則監聽這些事件就沒什麼意義了。所有事件都會傳入Event對象作爲參數,可以從Event對象上獲取到更多的信息:

    $(function () {
        $('#testMouseMoveDiv').mousemove(function (e) {
            $('#testMouseMoveSpan').text('pageX = ' + e.pageX + ', pageY = ' + e.pageY);
        });
    });
    

    取消綁定

    一個已被綁定的事件可以解除綁定,通過off(‘click’, function)實現:

    function hello() {
        alert('hello!');
    }
    
    a.click(hello); // 綁定事件
    
    // 10秒鐘後解除綁定:
    setTimeout(function () {
        a.off('click', hello);
    }, 10000);
    

    事件觸發條件

    一個需要注意的問題是,事件的觸發總是由用戶操作引發的。例如,我們監控文本框的內容改動:

    var input = $('#test-input');
    input.change(function () {
        console.log('changed...');
    });
    

    當用戶在文本框中輸入時,就會觸發change事件。但是,如果用JavaScript代碼去改動文本框的值,將不會觸發change事件:

    var input = $('#test-input');
    input.val('change it!'); // 無法觸發change事件
    

    有些時候,我們希望用代碼觸發change事件,可以直接調用無參數的change()方法來觸發該事件:

    var input = $('#test-input');
    input.val('change it!');
    input.change(); // 觸發change事件
    

    input.change()相當於input.trigger(‘change’),它是trigger()方法的簡寫。

    瀏覽器安全限制

    在瀏覽器中,有些JavaScript代碼只有在用戶觸發下才能執行,例如,window.open()函數:

    // 無法彈出新窗口,將被瀏覽器屏蔽:
    $(function () {
        window.open('/');
    });
    

    這些“敏感代碼”只能由用戶操作來觸發:

    var button1 = $('#testPopupButton1');
    var button2 = $('#testPopupButton2');
    
    function popupTestWindow() {
        window.open('/');
    }
    
    button1.click(function () {
        popupTestWindow();
    });
    
    button2.click(function () {
        // 不立刻執行popupTestWindow(),100毫秒後執行:
        setTimeout(popupTestWindow, 100);
    });
    

    當用戶點擊button1時,click事件被觸發,由於popupTestWindow()在click事件處理函數內執行,這是瀏覽器允許的,而button2的click事件並未立刻執行popupTestWindow(),延遲執行的popupTestWindow()將被瀏覽器攔截。

    練習

    對如下的Form表單:

    <!-- HTML結構 -->
    <form id="test-form" action="test">
        <legend>請選擇想要學習的編程語言:</legend>
        <fieldset>
            <p><label class="selectAll"><input type="checkbox"> <span class="selectAll">全選</span><span class="deselectAll">全不選</span></label> <a href="#0" class="invertSelect">反選</a></p>
            <p><label><input type="checkbox" name="lang" value="javascript"> JavaScript</label></p>
            <p><label><input type="checkbox" name="lang" value="python"> Python</label></p>
            <p><label><input type="checkbox" name="lang" value="ruby"> Ruby</label></p>
            <p><label><input type="checkbox" name="lang" value="haskell"> Haskell</label></p>
            <p><label><input type="checkbox" name="lang" value="scheme"> Scheme</label></p>
    		<p><button type="submit">Submit</button></p>
        </fieldset>
    </form>
    

    綁定合適的事件處理函數,實現以下邏輯:

    當用戶勾上“全選”時,自動選中所有語言,並把“全選”變成“全不選”;

    當用戶去掉“全不選”時,自動不選中所有語言;

    當用戶點擊“反選”時,自動把所有語言狀態反轉(選中的變爲未選,未選的變爲選中);

    當用戶把所有語言都手動勾上時,“全選”被自動勾上,並變爲“全不選”;

    當用戶手動去掉選中至少一種語言時,“全不選”自動被去掉選中,並變爲“全選”。

    'use strict';
    
    var
        form = $('#test-form'),
        langs = form.find('[name=lang]'),
        selectAll = form.find('label.selectAll :checkbox'),
        selectAllLabel = form.find('label.selectAll span.selectAll'),
        deselectAllLabel = form.find('label.selectAll span.deselectAll'),
        invertSelect = form.find('a.invertSelect');
    
    // 重置初始化狀態:
    form.find('*').show().off();
    form.find(':checkbox').prop('checked', false).off();
    deselectAllLabel.hide();
    // 攔截form提交事件:
    form.off().submit(function (e) {
        e.preventDefault();
        alert(form.serialize());
    });
    
    // 綁定事件
    // 全選/全不選
    selectAll.click(function(){
    	isSelectAllChecked = selectAll.prop('checked');
    	langs.prop('checked', isSelectAllChecked);
    	if (isSelectAllChecked) {
    		selectAllLabel.hide();
    		deselectAllLabel.show();
    	} else {
    		selectAllLabel.show();
    		deselectAllLabel.hide();
    	}
    });
    
    // 反選
    invertSelect.click(function(){
    	for (var i = 0; i < langs.length; i++) {
    		lang = langs.get(i);
    		// console.log(lang.value + ' is checked:' + lang.checked);
    		lang.checked = !lang.checked;
    	};
    });
    
    // 手動選中
    langs.click(function(){
    	isAllChecked = true;
    	for (var i = 0; i < langs.length; i++) {
    		if (!langs.get(i).checked) {
    			isAllChecked = false;
    			break;
    		};
    	};
    	// console.log('Click langs, all checked: ' + isAllChecked);
    	if (isAllChecked) {
    		selectAll.prop('checked', true);
    		selectAllLabel.hide();
    		deselectAllLabel.show();
    	} else {
    		selectAll.prop('checked', false);
    		selectAllLabel.show();
    		deselectAllLabel.hide();
    	}
    });
    

    動畫

    用JavaScript實現動畫,原理非常簡單:我們只需要以固定的時間間隔(例如,0.1秒),每次把DOM元素的CSS樣式修改一點(例如,高寬各增加10%),看起來就像動畫了。

    但是要用JavaScript手動實現動畫效果,需要編寫非常複雜的代碼。如果想要把動畫效果用函數封裝起來便於複用,那考慮的事情就更多了。

    使用jQuery實現動畫,代碼已經簡單得不能再簡化了:只需要一行代碼!

    讓我們先來看看jQuery內置的幾種動畫樣式:

    show / hide

    直接以無參數形式調用show()和hide(),會顯示和隱藏DOM元素。但是,只要傳遞一個時間參數進去,就變成了動畫:

    var div = $('#test-show-hide');
    div.hide(3000); // 在3秒鐘內逐漸消失
    

    時間以毫秒爲單位,但也可以是’slow’,'fast’這些字符串:

    var div = $('#test-show-hide');
    div.show('slow'); // 在0.6秒鐘內逐漸顯示
    

    toggle()方法則根據當前狀態決定是show()還是hide()。

    slideUp / slideDown

    你可能已經看出來了,show()和hide()是從左上角逐漸展開或收縮的,而slideUp()和slideDown()則是在垂直方向逐漸展開或收縮的。

    slideUp()把一個可見的DOM元素收起來,效果跟拉上窗簾似的,slideDown()相反,而slideToggle()則根據元素是否可見來決定下一步動作:

    var div = $('#test-slide');
    div.slideUp(3000); // 在3秒鐘內逐漸向上消失
    

    fadeIn / fadeOut

    fadeIn()和fadeOut()的動畫效果是淡入淡出,也就是通過不斷設置DOM元素的opacity屬性來實現,而fadeToggle()則根據元素是否可見來決定下一步動作:

    var div = $('#test-fade');
    div.fadeOut('slow'); // 在0.6秒內淡出
    

    自定義動畫

    如果上述動畫效果還不能滿足你的要求,那就祭出最後大招:animate(),它可以實現任意動畫效果,我們需要傳入的參數就是DOM元素最終的CSS狀態和時間,jQuery在時間段內不斷調整CSS直到達到我們設定的值:

    var div = $('#test-animate');
    div.animate({
        opacity: 0.25,
        width: '256px',
        height: '256px'
    }, 3000); // 在3秒鐘內CSS過渡到設定值
    

    animate()還可以再傳入一個函數,當動畫結束時,該函數將被調用:

    var div = $('#test-animate');
    div.animate({
        opacity: 0.25,
        width: '256px',
        height: '256px'
    }, 3000, function () {
        console.log('動畫已結束');
        // 恢復至初始狀態:
        $(this).css('opacity', '1.0').css('width', '128px').css('height', '128px');
    });
    

    實際上這個回調函數參數對於基本動畫也是適用的。

    串行動畫

    jQuery的動畫效果還可以串行執行,通過**delay()**方法還可以實現暫停,這樣,我們可以實現更復雜的動畫效果,而代碼卻相當簡單:

    var div = $('#test-animates');
    // 動畫效果:slideDown - 暫停 - 放大 - 暫停 - 縮小
    div.slideDown(2000)
       .delay(1000)
       .animate({
           width: '256px',
           height: '256px'
       }, 2000)
       .delay(1000)
       .animate({
           width: '128px',
           height: '128px'
       }, 2000);
    }
    

    因爲動畫需要執行一段時間,所以jQuery必須不斷返回新的Promise對象才能後續執行操作。簡單地把動畫封裝在函數中是不夠的。

    爲什麼有的動畫沒有效果

    你可能會遇到,有的動畫如slideUp()根本沒有效果。這是因爲jQuery動畫的原理是逐漸改變CSS的值,如height從100px逐漸變爲0。但是很多不是block性質的DOM元素,對它們設置height根本就不起作用,所以動畫也就沒有效果。

    此外,jQuery也沒有實現對background-color的動畫效果,用animate()設置background-color也沒有效果。這種情況下可以使用CSS3的transition實現動畫效果。

    練習

    在執行刪除操作時,給用戶顯示一個動畫比直接調用remove()要更好。請在表格刪除一行的時候添加一個淡出的動畫效果:

    'use strict';
    
    function deleteFirstTR() {
        var tr = $('#test-table>tbody>tr:visible').first();
        tr.fadeOut(500, ()=>{tr.remove()})
    }
    
    deleteFirstTR();
    

    AJAX

    用JavaScript寫AJAX前面已經介紹過了,主要問題就是不同瀏覽器需要寫不同代碼,並且狀態和錯誤處理寫起來很麻煩。

    用jQuery的相關對象來處理AJAX,不但不需要考慮瀏覽器問題,代碼也能大大簡化。

    ajax

    jQuery在全局對象jQuery(也就是$)綁定了ajax()函數,可以處理AJAX請求。ajax(url, settings)函數需要接收一個URL和一個可選的settings對象,常用的選項如下:

    • async:是否異步執行AJAX請求,默認爲true,千萬不要指定爲false;
    • method:發送的Method,缺省爲’GET’,可指定爲’POST’、'PUT’等;
    • contentType:發送POST請求的格式,默認值爲’application/x-www-form-urlencoded; charset=UTF-8’,也可以指定爲text/plain、application/json;
    • data:發送的數據,可以是字符串、數組或object。如果是GET請求,data將被轉換成query附加到URL上,如果是POST請求,根據contentType把data序列化成合適的格式;
    • headers:發送的額外的HTTP頭,必須是一個object;
    • dataType:接收的數據格式,可以指定爲’html’、‘xml’、‘json’、'text’等,缺省情況下根據響應的Content-Type猜測。

    下面的例子發送一個GET請求,並返回一個JSON格式的數據:

    var jqxhr = $.ajax('/api/categories', {
        dataType: 'json'
    });
    // 請求已經發送了
    

    不過,如何用回調函數處理返回的數據和出錯時的響應呢?

    還記得Promise對象嗎?jQuery的jqXHR對象類似一個Promise對象,我們可以用鏈式寫法來處理各種回調:

    'use strict';
    
    function ajaxLog(s) {
        var txt = $('#test-response-text');
        txt.val(txt.val() + '\n' + s);
    }
    
    $('#test-response-text').val('');
    var jqxhr = $.ajax('/api/categories', {
        dataType: 'json'
    }).done(function (data) {
        ajaxLog('成功, 收到的數據: ' + JSON.stringify(data));
    }).fail(function (xhr, status) {
        ajaxLog('失敗: ' + xhr.status + ', 原因: ' + status);
    }).always(function () {
        ajaxLog('請求完成: 無論成功或失敗都會調用');
    });
    

    get

    對常用的AJAX操作,jQuery提供了一些輔助方法。由於GET請求最常見,所以jQuery提供了get()方法,可以這麼寫:

    var jqxhr = $.get('/path/to/resource', {
        name: 'Bob Lee',
        check: 1
    });
    

    第二個參數如果是object,jQuery自動把它變成query string然後加到URL後面,實際的URL是:

    /path/to/resource?name=Bob%20Lee&check=1
    

    這樣我們就不用關心如何用URL編碼並構造一個query string了。

    post

    post()和get()類似,但是傳入的第二個參數默認被序列化爲application/x-www-form-urlencoded:

    var jqxhr = $.post('/path/to/resource', {
        name: 'Bob Lee',
        check: 1
    });
    

    實際構造的數據name=Bob%20Lee&check=1作爲POST的body被髮送。

    getJSON

    由於JSON用得越來越普遍,所以jQuery也提供了getJSON()方法來快速通過GET獲取一個JSON對象:

    var jqxhr = $.getJSON('/path/to/resource', {
        name: 'Bob Lee',
        check: 1
    }).done(function (data) {
        // data已經被解析爲JSON對象了
    });
    

    安全限制

    jQuery的AJAX完全封裝的是JavaScript的AJAX操作,所以它的安全限制和前面講的用JavaScript寫AJAX完全一樣。

    如果需要使用JSONP,可以在ajax()中設置jsonp: ‘callback’,讓jQuery實現JSONP跨域加載數據。

    關於跨域的設置請參考瀏覽器 - AJAX一節中CORS的設置。


    擴展

    當我們使用jQuery對象的方法時,由於jQuery對象可以操作一組DOM,而且支持鏈式操作,所以用起來非常方便。

    但是jQuery內置的方法永遠不可能滿足所有的需求。比如,我們想要高亮顯示某些DOM元素,用jQuery可以這麼實現:

    $('span.hl').css('backgroundColor', '#fffceb').css('color', '#d85030');
    
    $('p a.hl').css('backgroundColor', '#fffceb').css('color', '#d85030');
    

    總是寫重複代碼可不好,萬一以後還要修改字體就更麻煩了,能不能統一起來,寫個highlight()方法?

    $('span.hl').highlight();
    
    $('p a.hl').highlight();
    

    答案是肯定的。我們可以擴展jQuery來實現自定義方法。將來如果要修改高亮的邏輯,只需修改一處擴展代碼。這種方式也稱爲編寫jQuery插件。

    編寫jQuery插件

    給jQuery對象綁定一個新方法是通過擴展$.fn對象實現的。讓我們來編寫第一個擴展——highlight1():

    $.fn.highlight1 = function () {
        // this已綁定爲當前jQuery對象:
        this.css('backgroundColor', '#fffceb').css('color', '#d85030');
        return this;
    }
    

    注意到函數內部的this在調用時被綁定爲jQuery對象,所以函數內部代碼可以正常調用所有jQuery對象的方法。

    對於如下的HTML結構:

    <!-- HTML結構 -->
    <div id="test-highlight1">
        <p>什麼是<span>jQuery</span></p>
        <p><span>jQuery</span>是目前最流行的<span>JavaScript</span>庫。</p>
    </div>
    

    來測試一下highlight1()的效果:

    'use strict';
    $('#test-highlight1 span').highlight1();
    

    細心的童鞋可能發現了,爲什麼最後要return this;?因爲jQuery對象支持鏈式操作,我們自己寫的擴展方法也要能繼續鏈式下去:

    $('span.hl').highlight1().slideDown();
    

    不然,用戶調用的時候,就不得不把上面的代碼拆成兩行。

    但是這個版本並不完美。有的用戶希望高亮的顏色能自己來指定,怎麼辦?

    我們可以給方法加個參數,讓用戶自己把參數用對象傳進去。於是我們有了第二個版本的highlight2():

    $.fn.highlight2 = function (options) {
        // 要考慮到各種情況:
        // options爲undefined
        // options只有部分key
        var bgcolor = options && options.backgroundColor || '#fffceb';
        var color = options && options.color || '#d85030';
        this.css('backgroundColor', bgcolor).css('color', color);
        return this;
    }
    

    對於如下HTML結構:

    <!-- HTML結構 -->
    <div id="test-highlight2">
        <p>什麼是<span>jQuery</span> <span>Plugin</span></p>
        <p>編寫<span>jQuery</span> <span>Plugin</span>可以用來擴展<span>jQuery</span>的功能。</p>
    </div>
    

    來實測一下帶參數的highlight2():

    'use strict';
    
    $('#test-highlight2 span').highlight2({
        backgroundColor: '#00a8e6',
        color: '#ffffff'
    });
    

    對於默認值的處理,我們用了一個簡單的**&&和||短路操作符**,總能得到一個有效的值。

    另一種方法是使用jQuery提供的輔助方法**$.extend(target, obj1, obj2, …)**,它把多個object對象的屬性合併到第一個target對象中,遇到同名屬性,總是使用靠後的對象的值,也就是越往後優先級越高:

    // 把默認值和用戶傳入的options合併到對象{}中並返回:
    var opts = $.extend({}, {
        backgroundColor: '#00a8e6',
        color: '#ffffff'
    }, options);
    

    緊接着用戶對highlight2()提出了意見:每次調用都需要傳入自定義的設置,能不能讓我自己設定一個缺省值,以後的調用統一使用無參數的highlight2()?

    也就是說,我們設定的默認值應該能允許用戶修改。

    那默認值放哪比較合適?放全局變量肯定不合適,最佳地點是$.fn.highlight2這個函數對象本身。

    於是最終版的highlight()終於誕生了:

    $.fn.highlight = function (options) {
        // 合併默認值和用戶設定值:
        var opts = $.extend({}, $.fn.highlight.defaults, options);
        this.css('backgroundColor', opts.backgroundColor).css('color', opts.color);
        return this;
    }
    
    // 設定默認值:
    $.fn.highlight.defaults = {
        color: '#d85030',
        backgroundColor: '#fff8de'
    }
    

    這次用戶終於滿意了。用戶使用時,只需一次性設定默認值:

    $.fn.highlight.defaults.color = '#fff';
    $.fn.highlight.defaults.backgroundColor = '#000';
    

    然後就可以非常簡單地調用highlight()了。

    對如下的HTML結構:

    <!-- HTML結構 -->
    <div id="test-highlight">
        <p>如何編寫<span>jQuery</span> <span>Plugin</span></p>
        <p>編寫<span>jQuery</span> <span>Plugin</span>,要設置<span>默認值</span>,並允許用戶修改<span>默認值</span>,或者運行時傳入<span>其他值</span></p>
    </div>
    
    'use strict';
    $.fn.highlight.defaults.color = '#659f13';
    $.fn.highlight.defaults.backgroundColor = '#f2fae3';
    
    $('#test-highlight p:first-child span').highlight();
    
    $('#test-highlight p:last-child span').highlight({
        color: '#dd1144'
    });
    
    

    最終,我們得出編寫一個jQuery插件的原則:

    • 給$.fn綁定函數,實現插件的代碼邏輯;
    • 插件函數最後要return this;以支持鏈式調用;
    • 插件函數要有默認值,綁定在$.fn..defaults上;
    • 用戶在調用時可傳入設定值以便覆蓋默認值。

    針對特定元素的擴展

    我們知道jQuery對象的有些方法只能作用在特定DOM元素上,比如submit()方法只能針對form。如果我們編寫的擴展只能針對某些類型的DOM元素,應該怎麼寫?

    還記得jQuery的選擇器支持filter()方法來過濾嗎?我們可以藉助這個方法來實現針對特定元素的擴展。

    舉個例子,現在我們要給所有指向外鏈的超鏈接加上跳轉提示,怎麼做?

    先寫出用戶調用的代碼

    $('#main a').external();
    

    然後按照上面的方法編寫一個external擴展:

    $.fn.external = function () {
        // return返回的each()返回結果,支持鏈式調用:
        return this.filter('a').each(function () {
            // 注意: each()內部的回調函數的this綁定爲DOM本身!
            var a = $(this);
            var url = a.attr('href');
            if (url && (url.indexOf('http://')===0 || url.indexOf('https://')===0)) {
                a.attr('href', '#0')
                 .removeAttr('target')
                 .append(' <i class="uk-icon-external-link"></i>')
                 .click(function () {
                    if(confirm('你確定要前往' + url + '?')) {
                        window.open(url);
                    }
                });
            }
        });
    }
    
    

    對如下的HTML結構:

    <!-- HTML結構 -->
    <div id="test-external">
        <p>如何學習<a href="http://jquery.com">jQuery</a></p>
        <p>首先,你要學習<a href="/wiki/1022910821149312">JavaScript</a>,並瞭解基本的<a href="https://developer.mozilla.org/en-US/docs/Web/HTML">HTML</a></p>
    </div>
    

    實測外鏈效果:

    'use strict';
    $('#test-external a').external();
    

    小結

    擴展jQuery對象的功能十分簡單,但是我們要遵循jQuery的原則,編寫的擴展方法能支持鏈式調用、具備默認值和過濾特定元素,使得擴展方法看上去和jQuery本身的方法沒有什麼區別。

    發表評論
    所有評論
    還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
    相關文章