jquery学习

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了jquery学习相关的知识,希望对你有一定的参考价值。

JQuery

你可能听说过jQuery,它名字起得很土,但却是javascript世界中使用最广泛的一个库。

江湖传言,全世界大约有80~90%的网站直接或间接地使用了jQuery。鉴于它如此流行,又如此好用,所以每一个入门JavaScript的前端工程师都应该了解和学习它。

jQuery这么流行,肯定是因为它解决了一些很重要的问题。实际上,jQuery能帮我们干这些事情:

  • 消除浏览器差异:你不需要自己写冗长的代码来针对不同的浏览器来绑定事件,编写AJAX等代码;
  • 简洁的操作DOM的方法:写$(‘#test‘)肯定比document.getElementById(‘test‘)来得简洁;
  • 轻松实现动画、修改CSS等各种操作。

jQuery的理念“Write Less, Do More“,让你写更少的代码,完成更多的工作!


JQuery 版本

目前jQuery有1.x和2.x两个主要版本,区别在于2.x移除了对古老的IE 6、7、8的支持,因此2.x的代码更精简。选择哪个版本主要取决于你是否想支持IE 6~8。

$符号

也是一个合法的变量名,它是变量jQuery的别名:

  1. window.jQuery; // jQuery(selector, context)
  2. window.$; // jQuery(selector, context)
  3. $ === jQuery; // true
  4. typeof($); // ‘function‘

除了可以直接调用外,也可以有很多其他属性。

注意,你看到的$函数名可能不是jQuery(selector, context),因为很多JavaScript压缩工具可以对函数名和参数改名,所以压缩过的jQuery源码$函数可能变成a(b, c)。

绝大多数时候,我们都直接用这个变量不幸地被占用了,而且还不能改,那我们就只能让jQuery把$变量交出来,然后就只能使用jQuery这个变量:

  1. $; // jQuery(selector, context)
  2. jQuery.noConflict();
  3. $; // undefined
  4. jQuery; // jQuery(selector, context)

选择器

选择器是jQuery的核心。一个选择器写出来类似$(‘#dom-id‘)。

为什么jQuery要发明选择器?回顾一下DOM操作中我们经常使用的代码:

  1. // 按ID查找:
  2. var a = document.getElementById(‘dom-id‘);
  3. // 按tag查找:
  4. var divs = document.getElementsByTagNames(‘div‘);
  5. // 查找<p class="red">:
  6. var ps = document.getElementsByTagNames(‘p‘);
  7. // 过滤出class="red":
  8. // TODO:
  9. // 查找<table class="green">里面的所有<tr>:
  10. var table = ...
  11. for (var i=0; i<table.children; i++) {
  12. // TODO: 过滤出<tr>
  13. }

这些代码实在太繁琐了,并且,在层级关系中,例如,查找<table class="green">里面的所有<tr>,一层循环实际上是错的,因为<table>的标准写法是:

  1. <table>
  2. <tbody>
  3. <tr>...</tr>
  4. <tr>...</tr>
  5. </tbody>
  6. </table>

很多时候,需要递归查找所有子节点。

jQuery的选择器就是帮助我们快速定位到一个或多个DOM节点。

按ID查找

如果某个DOM节点有id属性,利用jQuery查找如下:

  1. // 查找<div id="abc">:
  2. var div = $(‘#abc‘);

注意,#abc以#开头。返回的对象是jQuery对象。

什么是jQuery对象?jQuery对象类似数组,它的每个元素都是一个引用了DOM节点的对象。

以上面的查找为例,如果id为abc的<div>存在,返回的jQuery对象如下:

[

]

如果id为abc的<div>不存在,返回的jQuery对象如下:

[]

总之jQuery的选择器不会返回undefined或者null,这样的好处是你不必在下一行判断if (div === undefined)。

jQuery对象和DOM对象之间可以互相转化:

  1. var div = $(‘#abc‘); // jQuery对象
  2. var divDom = div.get(0); // 假设存在div,获取第1个DOM元素
  3. var another = $(divDom); // 重新把DOM包装为jQuery对象

通常情况下你不需要获取DOM对象,直接使用jQuery对象更加方便。如果你拿到了一个DOM对象,那可以简单地调用$(aDomObject)把它变成jQuery对象,这样就可以方便地使用jQuery的API了。

按tag查找

按tag查找只需要写上tag名称就可以了:

  1. var ps = $(‘p‘); // 返回所有<p>节点
  2. ps.length; // 数一数页面有多少个<p>节点

按class查找

按class查找注意在class名称前加一个.:

  1. var a = $(‘.red‘); // 所有节点包含`class="red"`都将返回
  2. // 例如:
  3. // <div class="red">...</div>
  4. // <p class="green red">...</p>

通常很多节点有多个class,我们可以查找同时包含red和green的节点:

  1. var a = $(‘.red.green‘); // 注意没有空格!
  2. // 符合条件的节点:
  3. // <div class="red green">...</div>
  4. // <div class="blue green red">...</div>

按属性查找

一个DOM节点除了id和class外还可以有很多属性,很多时候按属性查找会非常方便,比如在一个表单中按属性来查找:

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

当属性的值包含空格等特殊字符时,需要用双引号括起来。

按属性查找还可以使用前缀查找或者后缀查找:

  1. var icons = $(‘[name^=icon]‘); // 找出所有name属性值以icon开头的DOM
  2. // 例如: name="icon-1", name="icon-2"
  3. var names = $(‘[name$=with]‘); // 找出所有name属性值以with结尾的DOM
  4. // 例如: name="startswith", name="endswith"

这个方法尤其适合通过class属性查找,且不受class包含多个名称的影响:

  1. var icons = $(‘[class^="icon-"]‘); // 找出所有class包含至少一个以`icon-`开头的DOM
  2. // 例如: class="icon-clock", class="abc icon-home"

组合查找

组合查找就是把上述简单选择器组合起来使用。如果我们查找$(‘[name=email]‘),很可能把表单外的<div name="email">也找出来,但我们只希望查找<input>,就可以这么写:

  1. var emailInput = $(‘input[name=email]‘); // 不会找出<div name="email">

同样的,根据tag和class来组合查找也很常见:

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

多项选择器

多项选择器就是把多个选择器用,组合起来一块选:

  1. $(‘p,div‘); // 把<p>和<div>都选出来
  2. $(‘p.red,p.green‘); // 把<p class="red">和<p class="green">都选出来

要注意的是,选出来的元素是按照它们在html中出现的顺序排列的,而且不会有重复元素。例如,<p class="red green">不会被上面的$(‘p.red,p.green‘)选择两次。

层级选择器

除了基本的选择器外,jQuery的层级选择器更加灵活,也更强大。

因为DOM的结构就是层级结构,所以我们经常要根据层级关系进行选择。
如果两个DOM元素具有层级关系,就可以用$(‘ancestor descendant‘)来选择,层级之间用空格隔开。例如:

  1. <!-- HTML结构 -->
  2. <div class="testing">
  3. <ul class="lang">
  4. <li class="lang-javascript">JavaScript</li>
  5. <li class="lang-python">Python</li>
  6. <li class="lang-lua">Lua</li>
  7. </ul>
  8. </div>

要选出JavaScript,可以用层级选择器:

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

因为<div><ul>都是<li>的祖先节点,所以上面两种方式都可以选出相应的<li>节点。

要选择所有的<li>节点,用:

  1. $(‘ul.lang li‘);

这种层级选择器相比单个的选择器好处在于,它缩小了选择范围,因为首先要定位父节点,才能选择相应的子节点,这样避免了页面其他不相关的元素。

例如:

  1. $(‘form[name=upload] input‘);

就把选择范围限定在name属性为upload的表单里。如果页面有很多表单,其他表单的<input>不会被选择。

多层选择也是允许的:

  1. $(‘form.test p input‘); // 在form表单选择被<p>包含的<input>

子选择器(Child Selector)

子选择器$(‘parent>child‘)类似层级选择器,但是限定了层级关系必须是父子关系,就是<child>节点必须是

  1. $(‘ul.lang>li.lang-javascript‘); // 可以选出[<li class="lang-javascript">JavaScript</li>]
  2. $(‘div.testing>li.lang-javascript‘); // [], 无法选出,因为<div>和<li>不构成父子关系

过滤器(Filter)

过滤器一般不单独使用,它通常附加在选择器上,帮助我们更精确地定位元素。观察过滤器的效果:

  1. $(‘ul.lang li‘); // 选出JavaScript、Python和Lua 3个节点
  2. $(‘ul.lang li:first-child‘); // 仅选出JavaScript
  3. $(‘ul.lang li:last-child‘); // 仅选出Lua
  4. $(‘ul.lang li:nth-child(2)‘); // 选出第N个元素,N从1开始
  5. $(‘ul.lang li:nth-child(even)‘); // 选出序号为偶数的元素
  6. $(‘ul.lang li:nth-child(odd)‘); // 选出序号为奇数的元素

表单相关

  • :input:可以选择<input>,<textarea>,<select>和<button>
  • :file:可以选择<input type="file">,和input[type=file]一样;
  • :checkbox:可以选择复选框,和input[type=checkbox]一样;
  • :radio:可以选择单选框,和input[type=radio]一样;
  • :focus:可以选择当前输入焦点的元素,例如把光标放到一个<input>上,用$(‘input:focus‘)就可以选出;
  • :checked:选择当前勾上的单选框和复选框,用这个选择器可以立刻获得用户选择的项目,如$(‘input[type=radio]:checked‘)
  • :enabled:可以选择可以正常输入的<input>、<select>
    等,也就是没有灰掉的输入;
  • :disabled:和:enabled正好相反,选择那些不能输入的。

此外,jQuery还有很多有用的选择器,例如,选出可见的或隐藏的元素:

  1. $(‘div:visible‘); // 所有可见的div
  2. $(‘div:hidden‘); // 所有隐藏的div

查找和过滤

通常情况下选择器可以直接定位到我们想要的元素,但是,当我们拿到一个jQuery对象后,还可以以这个对象为基准,进行查找和过滤。

最常见的查找是在某个节点的所有子节点中查找,使用find()方法,它本身又接收一个任意的选择器。例如如下的HTML结构:

  1. <!-- HTML结构 -->
  2. <ul class="lang">
  3. <li class="js dy">JavaScript</li>
  4. <li class="dy">Python</li>
  5. <li id="swift">Swift</li>
  6. <li class="dy">Scheme</li>
  7. <li name="haskell">Haskell</li>
  8. </ul>

用find()查找:

  1. var ul = $(‘ul.lang‘); // 获得<ul>
  2. var dy = ul.find(‘.dy‘); // 获得JavaScript, Python, Scheme
  3. var swf = ul.find(‘#swift‘); // 获得Swift
  4. var hsk = ul.find(‘[name=haskell]‘); // 获得Haskell

如果要从当前节点开始向上查找,使用parent()方法:

  1. var swf = $(‘#swift‘); // 获得Swift
  2. var parent = swf.parent(); // 获得Swift的上层节点<ul>
  3. var a = swf.parent(‘div.red‘); // 从Swift的父节点开始向上查找,直到找到某个符合条件的节点并返回

对于位于同一层级的节点,可以通过next()prev()方法,例如:
当我们已经拿到Swift节点后:

  1. var swift = $(‘#swift‘);
  2. swift.next(); // Scheme
  3. swift.next(‘[name=haskell]‘); // Haskell,因为Haskell是后续第一个符合选择器条件的节点
  4. swift.prev(); // Python
  5. swift.prev(‘.js‘); // JavaScript,因为JavaScript是往前第一个符合选择器条件的节点

过滤

和函数式编程的map、filter类似,jQuery对象也有类似的方法。

filter()方法可以过滤掉不符合选择器条件的节点:

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

或者传入一个函数,要特别注意函数内部的this被绑定为DOM对象,不是jQuery对象:

  1. var langs = $(‘ul.lang li‘); // 拿到JavaScript, Python, Swift, Scheme和Haskell
  2. langs.filter(function () {
  3. return this.innerHTML.indexOf(‘S‘) === 0; // 返回S开头的节点
  4. }); // 拿到Swift, Scheme

map()方法把一个jQuery对象包含的若干DOM节点转化为其他对象:

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

此外,一个jQuery对象如果包含了不止一个DOM节点,first()、last()slice()方法可以返回一个新的jQuery对象,把不需要的DOM节点去掉:

  1. var langs = $(‘ul.lang li‘); // 拿到JavaScript, Python, Swift, Scheme和Haskell
  2. var js = langs.first(); // JavaScript,相当于$(‘ul.lang li:first-child‘)
  3. var haskell = langs.last(); // Haskell, 相当于$(‘ul.lang li:last-child‘)
  4. var sub = langs.slice(2, 4); // Swift, Scheme, 参数和数组的slice()方法一致

操作DOM

修改Text和HTML

jQuery对象的text()html()方法分别获取节点的文本和原始HTML文本,例如,如下的HTML结构:

  1. <!-- HTML结构 -->
  2. <ul id="test-ul">
  3. <li class="js">JavaScript</li>
  4. <li name="book">Java &amp; JavaScript</li>
  5. </ul>

分别获取文本和HTML:

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

如何设置文本或HTML?jQuery的API设计非常巧妙:无参数调用text()是获取文本,传入参数就变成设置文本,HTML也是类似操作
一个jQuery对象可以包含0个或任意个DOM对象,它的方法实际上会作用在对应的每个DOM节点上
所以jQuery对象的另一个好处是我们可以执行一个操作,作用在对应的一组DOM节点上。即使选择器没有返回任何DOM节点,调用jQuery对象的方法仍然不会报错:

  1. // 如果不存在id为not-exist的节点:
  2. $(‘#not-exist‘).text(‘Hello‘); // 代码不报错,没有节点被设置为‘Hello‘

这意味着jQuery帮你免去了许多if语句。

修改CSS

jQuery对象有“批量操作”的特点,这用于修改CSS实在是太方便了。考虑下面的HTML结构:

  1. <!-- HTML结构 -->
  2. <ul id="test-css">
  3. <li class="lang dy"><span>JavaScript</span></li>
  4. <li class="lang"><span>Java</span></li>
  5. <li class="lang dy"><span>Python</span></li>
  6. <li class="lang"><span>Swift</span></li>
  7. <li class="lang dy"><span>Scheme</span></li>
  8. </ul>

要高亮显示动态语言,调用jQuery对象的css(‘name‘, ‘value‘)方法,我们用一行语句实现:

  1. $(‘#test-css li.dy>span‘).css(‘background-color‘, ‘#ffd351‘).css(‘color‘, ‘red‘);

注意,jQuery对象的所有方法都返回一个jQuery对象(可能是新的也可能是自身),这样我们可以进行链式调用,非常方便。

jQuery对象的css()方法可以这么用:

  1. var div = $(‘#test-div‘);
  2. div.css(‘color‘); // ‘#000033‘, 获取CSS属性
  3. div.css(‘color‘, ‘#336699‘); // 设置CSS属性
  4. div.css(‘color‘, ‘‘); // 清除CSS属性

为了和JavaScript保持一致,CSS属性可以用‘background-color‘和‘backgroundColor‘两种格式。

css()方法将作用于DOM节点的style属性,具有最高优先级。如果要修改class属性,可以用jQuery提供的下列方法:

  1. var div = $(‘#test-div‘);
  2. div.hasClass(‘highlight‘); // false, class是否包含highlight
  3. div.addClass(‘highlight‘); // 添加highlight这个class
  4. div.removeClass(‘highlight‘); // 删除highlight这个class

显示和隐藏DOM

要隐藏一个DOM,我们可以设置CSS的display属性为none,利用css()方法就可以实现。不过,要显示这个DOM就需要恢复原有的display属性,这就得先记下来原有的display属性到底是block还是inline还是别的值。

考虑到显示和隐藏DOM元素使用非常普遍,jQuery直接提供show()hide()方法,我们不用关心它是如何修改display属性的,总之它能正常工作:

  1. var a = $(‘a[target=_blank]‘);
  2. a.hide(); // 隐藏
  3. a.show(); // 显示

注意,隐藏DOM节点并未改变DOM树的结构,它只影响DOM节点的显示。这和删除DOM节点是不同的。

获取DOM信息

利用jQuery对象的若干方法,我们直接可以获取DOM的高宽等信息,而无需针对不同浏览器编写特定代码:

  1. // 浏览器可视窗口大小:
  2. $(window).width(); // 800
  3. $(window).height(); // 600
  4. // HTML文档大小:
  5. $(document).width(); // 800
  6. $(document).height(); // 3500
  7. // 某个div的大小:
  8. var div = $(‘#test-div‘);
  9. div.width(); // 600
  10. div.height(); // 300
  11. div.width(400); // 设置CSS属性 width: 400px,是否生效要看CSS是否有效
  12. div.height(‘200px‘); // 设置CSS属性 height: 200px,是否生效要看CSS是否有效

attr()removeAttr()方法用于操作DOM节点的属性:

  1. // <div id="test-div" name="Test" start="1">...</div>
  2. var div = $(‘#test-div‘);
  3. div.attr(‘data‘); // undefined, 属性不存在
  4. div.attr(‘name‘); // ‘Test‘
  5. div.attr(‘name‘, ‘Hello‘); // div的name属性变为‘Hello‘
  6. div.removeAttr(‘name‘); // 删除name属性
  7. div.attr(‘name‘); // undefined

prop()方法和attr()类似,但是HTML5规定有一种属性在DOM节点中可以没有值,只有出现与不出现两种,例如:

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

等价于:

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

attr()prop()对于属性checked处理有所不同:

  1. var radio = $(‘#test-radio‘);
  2. radio.attr(‘checked‘); // ‘checked‘
  3. radio.prop(‘checked‘); // true

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

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

类似的属性还有selected,处理时最好用is(‘:selected‘)

操作表单

对于表单元素,jQuery对象统一提供val()方法获取和设置对应的value属性:

  1. /*
  2. <input id="test-input" name="email" value="">
  3. <select id="test-select" name="city">
  4. <option value="BJ" selected>Beijing</option>
  5. <option value="SH">Shanghai</option>
  6. <option value="SZ">Shenzhen</option>
  7. </select>
  8. <textarea id="test-textarea">Hello</textarea>
  9. */
  10. var
  11. input = $(‘#test-input‘),
  12. select = $(‘#test-select‘),
  13. textarea = $(‘#test-textarea‘);
  14. input.val(); // ‘test‘
  15. input.val([email protected]); // 文本框的内容已变为[email protected]
  16. select.val(); // ‘BJ‘
  17. select.val(‘SH‘); // 选择框已变为Shanghai
  18. textarea.val(); // ‘Hello‘
  19. textarea.val(‘Hi‘); // 文本区域已更新为‘Hi‘

可见,一个val()就统一了各种输入框的取值和赋值的问题。

修改DOM结构

直接使用浏览器提供的API对DOM结构进行修改,不但代码复杂,而且要针对浏览器写不同的代码。

有了jQuery,我们就专注于操作jQuery对象本身,底层的DOM操作由jQuery完成就可以了,这样一来,修改DOM也大大简化了。

添加DOM

要添加新的DOM节点,除了通过jQuery的html()这种暴力方法外,还可以用append()方法,例如:

  1. <div id="test-div">
  2. <ul>
  3. <li><span>JavaScript</span></li>
  4. <li><span>Python</span></li>
  5. <li><span>Swift</span></li>
  6. </ul>
  7. </div>

如何向列表新增一个语言?首先要拿到<ul>节点:

  1. var ul = $(‘#test-div>ul‘);

然后,调用append()传入HTML片段:

  1. ul.append(‘<li><span>Haskell</span></li>‘);

除了接受字符串,append()还可以传入原始的DOM对象,jQuery对象和函数对象:

  1. // 创建DOM对象:
  2. var ps = document.createElement(‘li‘);
  3. ps.innerHTML = ‘<span>Pascal</span>‘;
  4. // 添加DOM对象:
  5. ul.append(ps);
  6. // 添加jQuery对象:
  7. ul.append($(‘#scheme‘));
  8. // 添加函数对象:
  9. ul.append(function (index, html) {
  10. return ‘<li><span>Language - ‘ + index + ‘</span></li>‘;
  11. });

传入函数时,要求返回一个字符串、DOM对象或者jQuery对象。因为jQuery的append()可能作用于一组DOM节点,只有传入函数才能针对每个DOM生成不同的子节点。

append()把DOM添加到最后,prepend()则把DOM添加到最前。

另外注意,如果要添加的DOM节点已经存在于HTML文档中,它会首先从文档移除,然后再添加,也就是说,用append(),你可以移动一个DOM节点。

如果要把新节点插入到指定位置,例如,JavaScript和Python之间,那么,可以先定位到JavaScript,然后用after()方法:

  1. var js = $(‘#test-div>ul>li:first-child‘);
  2. js.after(‘<li><span>Lua</span></li>‘);

也就是说,同级节点可以用after()或者before()方法。

删除节点

要删除DOM节点,拿到jQuery对象后直接调用remove()方法就可以了。如果jQuery对象包含若干DOM节点,实际上可以一次删除多个DOM节点:

  1. var li = $(‘#test-div>ul>li‘);
  2. li.remove(); // 所有<li>全被删除

事件

因为JavaScript在浏览器中以单线程模式运行,页面加载后,一旦页面上所有的JavaScript代码被执行完后,就只能依赖触发事件来执行JavaScript代码。

浏览器在接收到用户的鼠标或键盘输入后,会自动在对应的DOM节点上触发相应的事件。如果该节点已经绑定了对应的JavaScript处理函数,该函数就会自动调用。

由于不同的浏览器绑定事件的代码都不太一样,所以用jQuery来写代码,就屏蔽了不同浏览器的差异,我们总是编写相同的代码。

举个例子,假设要在用户点击了超链接时弹出提示框,我们用jQuery这样绑定一个click事件:

  1. /* HTML:
  2. *
  3. * <a id="test-link" href="#0">点我试试</a>
  4. *
  5. */
  6. // 获取超链接的jQuery对象:
  7. var a = $(‘#test-link‘);
  8. a.on(‘click‘, function () {
  9. alert(‘Hello!‘);
  10. });

on方法用来绑定一个事件,我们需要传入事件名称和对应的处理函数。

另一种更简化的写法是直接调用click()方法:

  1. a.click(function () {
  2. alert(‘Hello!‘);
  3. });

两者完全等价。我们通常用后面的写法。

jQuery能够绑定的事件主要包括:

鼠标事件

  • click: 鼠标单击时触发;
  • dblclick:鼠标双击时触发;
  • mouseenter:鼠标进入时触发;
  • mouseleave:鼠标移出时触发;
  • mousemove:鼠标在DOM内部移动时触发;
  • hover:鼠标进入和退出时触发两个函数,相当于mouseenter加上mouseleave

键盘事件

键盘事件仅作用在当前焦点的DOM上,通常是<input><textarea>

  • keydown:键盘按下时触发;
  • keyup:键盘松开时触发;
  • keypress:按一次键后触发。

其他事件

  • focus:当DOM获得焦点时触发;
  • blur:当DOM失去焦点时触发;
  • change:当<input>、<select>``或<textarea>的内容改变时触发;
  • submit:当
    提交时触发;
  • ready:当页面被载入并且DOM树完成初始化后触发。

其中,ready仅作用于document对象。由于ready事件在DOM完成初始化后触发,且只触发一次,所以非常适合用来写其他的初始化代码。假设我们想给一个<form>表单绑定submit事件,下面的代码没有预期的效果:

  1. <html>
  2. <head>
  3. <script>
  4. // 代码有误:
  5. $(‘#testForm).on(‘submit‘, function () {
  6. alert(‘submit!‘);
  7. });
  8. </script>
  9. </head>
  10. <body>
  11. <form id="testForm">
  12. ...
  13. </form>
  14. </body>

因为JavaScript在此执行的时候,<form>尚未载入浏览器,所以$(‘#testForm)返回[],并没有绑定事件到任何DOM上。

所以我们自己的初始化代码必须放到document对象的ready事件中,保证DOM已完成初始化:

  1. <html>
  2. <head>
  3. <script>
  4. $(document).on(‘ready‘, function () {
  5. $(‘#testForm).on(‘submit‘, function () {
  6. alert(‘submit!‘);
  7. });
  8. });
  9. </script>
  10. </head>
  11. <body>
  12. <form id="testForm">
  13. ...
  14. </form>
  15. </body>

这样写就没有问题了。因为相关代码会在DOM树初始化后再执行。

由于ready事件使用非常普遍,所以可以这样简化:

  1. $(document).ready(function () {
  2. // on(‘submit‘, function)也可以简化:
  3. $(‘#testForm).submit(function () {
  4. alert(‘submit!‘);
  5. });
  6. });

甚至还可以再简化为:

  1. $(function () {
  2. // init...
  3. });

上面的这种写法最为常见。如果你遇到$(function () {...})的形式,牢记这是document对象的ready事件处理函数。

完全可以反复绑定事件处理函数,它们会依次执行:

  1. $(function () {
  2. console.log(‘init A...‘);
  3. });
  4. $(function () {
  5. console.log(‘init B...‘);
  6. });
  7. $(function () {
  8. console.log(‘init C...‘);
  9. });

事件参数

有些事件,如mousemovekeypress,我们需要获取鼠标位置和按键的值,否则监听这些事件就没什么意义了。所有事件都会传入Event对象作为参数,可以从Event对象上获取到更多的信息:

  1. $(function () {
  2. $(‘#testMouseMoveDiv‘).mousemove(function (e) {
  3. $(‘#testMouseMoveSpan‘).text(‘pageX = ‘ + e.pageX + ‘, pageY = ‘ + e.pageY);
  4. });
  5. });

取消绑定

一个已被绑定的事件可以解除绑定,通过off(‘click‘, function)实现:

  1. function hello() {
  2. alert(‘hello!‘);
  3. }
  4. a.click(hello); // 绑定事件
  5. // 10秒钟后解除绑定:
  6. setTimeout(function () {
  7. a.off(‘click‘, hello);
  8. }, 10000);

需要特别注意的是,下面这种写法是无效的:

  1. // 绑定事件:
  2. a.click(function () {
  3. alert(‘hello!‘);
  4. });
  5. // 解除绑定:
  6. a.off(‘click‘, function () {
  7. alert(‘hello!‘);
  8. });

这是因为两个匿名函数虽然长得一模一样,但是它们是两个不同的函数对象,off(‘click‘, function () {...})无法移除已绑定的第一个匿名函数。

为了实现移除效果,可以使用off(‘click‘)一次性移除已绑定的click事件的所有处理函数。

同理,无参数调用off()一次性移除已绑定的所有类型的事件处理函数。

事件触发条件

一个需要注意的问题是,事件的触发总是由用户操作引发的。例如,我们监控文本框的内容改动:

  1. var input = $(‘#test-input‘);
  2. input.change(function () {
  3. console.log(‘changed...‘);
  4. });

当用户在文本框中输入时,就会触发change事件。但是,如果用JavaScript代码去改动文本框的值,将不会触发change事件:

  1. var input = $(‘#test-input‘);
  2. input.val(‘change it!‘); // 无法触发change事件

有些时候,我们希望用代码触发change事件,可以直接调用无参数的change()方法来触发该事件:

  1. var input = $(‘#test-input‘);
  2. input.val(‘change it!‘);
  3. input.change(); // 触发change事件

input.change()相当于input.trigger(‘change‘),它是trigger()方法的简写。

为什么我们希望手动触发一个事件呢?如果不这么做,很多时候,我们就得写两份一模一样的代码。

浏览器安全限制

在浏览器中,有些JavaScript代码只有在用户触发下才能执行,例如,window.open()函数:

  1. // 无法弹出新窗口,将被浏览器屏蔽:
  2. $(function () {
  3. window.open(‘/‘);
  4. });

这些“敏感代码”只能由用户操作来触发:

  1. var button1 = $(‘#testPopupButton1‘);
  2. var button2 = $(‘#testPopupButton2‘);
  3. function popupTestWindow() {
  4. window.open(‘/‘);
  5. }
  6. button1.click(function () {
  7. popupTestWindow();
  8. });
  9. button2.click(function () {
  10. // 不立刻执行popupTestWindow(),100毫秒后执行:
  11. setTimeout(popupTestWindow, 100);
  12. });

当用户点击button1时,click事件被触发,由于popupTestWindow()click事件处理函数内执行,这是浏览器允许的,而button2的click事件并未立刻执行popupTestWindow(),延迟执行的popupTestWindow()将被浏览器拦截。

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格式的数据:

  1. var jqxhr = $.ajax(‘/api/categories‘, {
  2. dataType: ‘json‘
  3. });
  4. // 请求已经发送了

不过,如何用回调函数处理返回的数据和出错时的响应呢?

还记得Promise对象吗?jQuery的jqXHR对象类似一个Promise对象,我们可以用链式写法来处理各种回调:

  1. ‘use strict‘;
  2. function ajaxLog(s) {
  3. var txt = $(‘#test-response-text‘);
  4. txt.val(txt.val() + ‘\n‘ + s);
  5. }
  6. $(‘#test-response-text‘).val(‘‘);
  7. var jqxhr = $.ajax(‘/api/categories‘, {
  8. dataType: ‘json‘
  9. }).done(function (data) {
  10. ajaxLog(‘成功, 收到的数据: ‘ + JSON.stringify(data));
  11. }).fail(function (xhr, status) {
  12. ajaxLog(‘失败: ‘ + xhr.status + ‘, 原因: ‘ + status);
  13. }).always(function () {
  14. ajaxLog(‘请求完成: 无论成功或失败都会调用‘);
  15. });

get

对常用的AJAX操作,jQuery提供了一些辅助方法。由于GET请求最常见,所以jQuery提供了get()方法,可以这么写:

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

第二个参数如果是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

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

实际构造的数据name=Bob%20Lee&check=1作为POST的body被发送。

getJSON

由于JSON用得越来越普遍,所以jQuery也提供了getJSON()方法来快速通过GET获取一个JSON对象:

  1. var jqxhr = $.getJSON(‘/path/to/resource‘, {
  2. name: ‘Bob Lee‘,
  3. check: 1
  4. }).done(function (data) {
  5. // data已经被解析为JSON对象了
  6. });

安全限制

jQuery的AJAX完全封装的是JavaScript的AJAX操作,所以它的安全限制和前面讲的用JavaScript写AJAX完全一样。

如果需要使用JSONP,可以在ajax()中设置jsonp: ‘callback‘,让jQuery实现JSONP跨域加载数据。

扩展

当我们使用jQuery对象的方法时,由于jQuery对象可以操作一组DOM,而且支持链式操作,所以用起来非常方便。

但是jQuery内置的方法永远不可能满足所有的需求。比如,我们想要高亮显示某些DOM元素,用jQuery可以这么实现:

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

总是写重复代码可不好,万一以后还要修改字体就更麻烦了,能不能统一起来,写个highlight()方法?

  1. $(‘span.hl‘).highlight();
  2. $(‘p a.hl‘).highlight();

答案是肯定的。我们可以扩展jQuery来实现自定义方法。将来如果要修改高亮的逻辑,只需修改一处扩展代码。这种方式也称为编写jQuery插件。

编写jQuery插件

给jQuery对象绑定一个新方法是通过扩展$.fn对象实现的。让我们来编写第一个扩展——highlight1()

  1. $.fn.highlight1 = function () {
  2. // this已绑定为当前jQuery对象:
  3. this.css(‘backgroundColor‘, ‘#fffceb‘).css(‘color‘, ‘#d85030‘);
  4. return this;
  5. }

注意到函数内部的this在调用时被绑定为jQuery对象,所以函数内部代码可以正常调用所有jQuery对象的方法。

对于如下的HTML结构:

  1. <!-- HTML结构 -->
  2. <div id="test-highlight1">
  3. <p>什么是<span>jQuery</span></p>
  4. <p><span>jQuery</span>是目前最流行的<span>JavaScript</span>库。</p>
  5. </div>

来测试一下highlight1()的效果:

  1. $(‘#test-highlight1 span‘).highlight1();

细心的童鞋可能发现了,为什么最后要return this;?因为jQuery对象支持链式操作,我们自己写的扩展方法也要能继续链式下去:

  1. $(‘span.hl‘).highlight1().slideDown();

不然,用户调用的时候,就不得不把上面的代码拆成两行。

但是这个版本并不完美。有的用户希望高亮的颜色能自己来指定,怎么办?

我们可以给方法加个参数,让用户自己把参数用对象传进去。于是我们有了第二个版本的highlight2()

  1. $.fn.highlight2 = function (options) {
  2. // 要考虑到各种情况:
  3. // options为undefined
  4. // options只有部分key
  5. var bgcolor = options && options.backgroundColor || ‘#fffceb‘;
  6. var color = options && options.color || ‘#d85030‘;
  7. this.css(‘backgroundColor‘, bgcolor).css(‘color‘, color);
  8. return this;
  9. }

对于如下HTML结构:

  1. <!-- HTML结构 -->
  2. <div id="test-highlight2">
  3. <p>什么是<span>jQuery</span> <span>Plugin</span></p>
  4. <p>编写<span>jQuery</span> <span>Plugin</span>可以用来扩展<span>jQuery</span>的功能。</p>
  5. </div>

来实测一下带参数的highlight2()

  1. $(‘#test-highlight2 span‘).highlight2({
  2. backgroundColor: ‘#00a8e6‘,
  3. color: ‘#ffffff‘
  4. });

对于默认值的处理,我们用了一个简单的&&和||短路操作符,总能得到一个有效的值。

另一种方法是使用jQuery提供的辅助方法$.extend(target, obj1, obj2, …),它把多个object对象的属性合并到第一个target对象中,遇到同名属性,总是使用靠后的对象的值,也就是越往后优先级越高:

  1. // 把默认值和用户传入的options合并到对象{}中并返回:
  2. var opts = $.extend({}, {
  3. backgroundColor: ‘#00a8e6‘,
  4. color: ‘#ffffff‘
  5. }, options);

紧接着用户对highlight2()提出了意见:每次调用都需要传入自定义的设置,能不能让我自己设定一个缺省值,以后的调用统一使用无参数的highlight2()

也就是说,我们设定的默认值应该能允许用户修改。

那默认值放哪比较合适?放全局变量肯定不合适,最佳地点是$.fn.highlight2这个函数对象本身。

于是最终版的highlight()终于诞生了:

  1. $.fn.highlight = function (options) {
  2. // 合并默认值和用户设定值:
  3. var opts = $.extend({}, $.fn.highlight.defaults, options);
  4. this.css(‘backgroundColor‘, opts.backgroundColor).css(‘color‘, opts.color);
  5. return this;
  6. }
  7. // 设定默认值:
  8. $.fn.highlight.defaults = {
  9. color: ‘#d85030‘,
  10. backgroundColor: ‘#fff8de‘
  11. }

这次用户终于满意了。用户使用时,只需一次性设定默认值:

  1. $.fn.highlight.defaults.color = ‘#fff‘;
  2. $.fn.highlight.defaults.backgroundColor = ‘#000‘;

然后就可以非常简单地调用highlight()了。

最终,我们得出编写一个jQuery插件的原则:

  1. $.fn绑定函数,实现插件的代码逻辑;
  2. 插件函数最后要return this;以支持链式调用;
  3. 插件函数要有默认值,绑定在$.fn.<pluginName>.defaults上;
  4. 用户在调用时可传入设定值以便覆盖默认值。

针对特定元素的扩展

我们知道jQuery对象的有些方法只能作用在特定DOM元素上,比如submit()方法只能针对form。如果我们编写的扩展只能针对某些类型的DOM元素,应该怎么写?

还记得jQuery的选择器支持filter()方法来过滤吗?我们可以借助这个方法来实现针对特定元素的扩展。

举个例子,现在我们要给所有指向外链的超链接加上跳转提示,怎么做?

先写出用户调用的代码:

  1. $(‘#main a‘).external();

然后按照上面的方法编写一个external扩展:

  1. $.fn.external = function () {
  2. // return返回的each()返回结果,支持链式调用:
  3. return this.filter(‘a‘).each(function () {
  4. // 注意: each()内部的回调函数的this绑定为DOM本身!
  5. var a = $(this);
  6. var url = a.attr(‘href‘);
  7. if (url && (url.indexOf(‘http://‘)===0 || url.indexOf(‘https://‘)===0)) {
  8. a.attr(‘href‘, ‘#0‘)
  9. .removeAttr(‘target‘)
  10. .append(‘ <i class="uk-icon-external-link"></i>‘)
  11. .click(function () {
  12. if(confirm(‘你确定要前往‘ + url + ‘?‘)) {
  13. window.open(url);
  14. }
  15. });
  16. }
  17. });
  18. }

以上是关于jquery学习的主要内容,如果未能解决你的问题,请参考以下文章

Visual Studio 2012-2019的130多个jQuery代码片段。

jQuery学习手册

markdown 在WordPress中使用jQuery代码片段

使用 NodeJS 和 JSDOM/jQuery 从代码片段构建 PHP 页面

很实用的JQuery代码片段(转)

几个有用的JavaScript/jQuery代码片段(转)