jQuery

jQuery

原作げんさく者しゃ	約やく翰·雷かみなり西にし格かく
開發かいはつ者しゃ	jQuery Team
首くび次じ发布	2006年ねん8月がつ26日にち​（2006-08-26）
当とう前ぜん版本はんぽん	3.7.1（2023年ねん8月がつ28日にち，12個月かげつ前まえ）
源みなもと代だい码库	github.com/jquery/jquery
编程语言	JavaScript
类型	網あみ頁ぺーじ應用おうよう程ほど序じょ框かまち架か
许可协议	MIT许可证
网站	jquery.com

jQuery是ぜ一いち套跨瀏りゅう覽らん器き的てきJavaScript函はこ式しき庫こ，用よう于简化かHTML與あずかJavaScript之の間あいだ的てき操作そうさ。約やく翰·雷かみなり西にし格かく（John Resig）在ざい2006年ねん1月がつ的てきBarCamp NYC上じょう釋しゃく出いずる了りょう第だい一いち個こ版本はんぽん。目前もくぜん由よしDave Methvin领导的てき团队进行开发。全ぜん球たま前まえ10,000个访问最高だか的てき网站中ちゅう，有ゆう65%使用しよう了りょうjQuery，是ぜ曾經最さい受歡迎かんげい的てきJavaScript函はこ式しき庫こ。

簡介

jQuery是ぜ开源软件，使用しようMIT许可证授权。 jQuery的てき语法设计使し得とく许多操作そうさ变得容易ようい，如操作文さくぶん档对象ぞう（document）、选择文ぶん档对象ぞう模型もけい（DOM）元素げんそ、创建动画效果こうか、处理事件じけん、以及开发Ajax程ほど序じょ。jQuery也提供ていきょう了りょう给开发人员在其上创建插件的てき能力のうりょく。这使开发人じん员可以对底そこ层交互与动画、高こう级效果こうか和わ高だか级主题化的てき组件进行抽象ちゅうしょう化か。模かたぎ块化的てき方式ほうしき使しjQuery函数かんすう库能够创建たて功いさお能のう强大きょうだい的てき动态网页以及网络应用程ほど序じょ。

微ほろ软和わ诺基亚已やめ宣布せんぷ在ざい他た们的平台ひらだい上じょう绑定jQuery。微ほろ软最初はつ在ざいVisual Studio中ちゅう集成しゅうせい了りょうjQuery以便在ざい微ほろ软自己じこ的てきASP.NET AJAX框かまち架か和わASP.NET MVC Framework中ちゅう使用しよう，而诺基もと亚则在ざい他た的てきWeb运行时组件けん开发平台ひらだい中ちゅう集成しゅうせい了りょうjQuery。MediaWiki自じ从1.16版本はんぽん后きさき也开始はじめ使用しようjQuery。

jQuery 1.3版はん以後いご，引入全ぜん新しん的てき層そう疊たたみ樣式ようしき表ひょう（CSS）选择器き引擎Sizzle。同時どうじ不ふ再さい提供ていきょうPacked版本はんぽん，因いん為ため解かい壓縮あっしゅく所しょ消耗しょうもう的てき時間じかん，遠大えんだい於所節ぶし省しょう的てき下か載の時間じかん，且不利ふり於除じょ錯，且已有ゆうGoogle AJAX Libraries API等とう公開こうかい站台提供ていきょうjQuery的てきjs的てき引用いんよう服ふく务，故こPacked版本はんぽん原本げんぽん的てき優ゆう點てん已やめ蕩とろけ然しか無む存そん。

特色とくしょく

jQuery有ゆう下か列れつ特色とくしょく：

• 使用しよう多た浏览器き开源选择器き引擎Sizzle（jQuery项目的もくてき衍生产品）进行DOM元素げんそ选择
• 基もと于CSS选择器き的てきDOM操作そうさ，使用しよう元素げんそ的てき名称めいしょう和わ属性ぞくせい（如id和わclass）作さく为选择DOM中ちゅう节点的てき条件じょうけん
• 事件じけん
• 特效とっこう和わ動畫どうが
• Ajax
• Deferred和わPromise对象来らい控ひかえ制せい异步处理
• JSON解析かいせき
• 通つう过插件けん扩展
• 工具こうぐ函数かんすう，如特征せい检测
• 现代浏览器き中ちゅう原生げんせい的てき兼けん容よう性せい方法ほうほう，但ただし对于旧版きゅうばん浏览器き需要じゅよう后きさき备（fallback）方法ほうほう，比ひ如inArray()和わeach()
• 多た浏览器き（不要ふよう与あずか跨またが浏览器き混淆こんこう）支持しじ

浏览器き支持しじ

jQuery 3.0及以后きさき版本はんぽん支持しじ“当とう前まえ−1版本はんぽん” 的てきFirefox、Chrome、Safari、Edge（就是说当前ぜん稳定版本はんぽん以及当とう前ぜん稳定版本はんぽん之の前まえ的てき一いち个版本はんぽん），另外还支持しじInternet Explorer 9以后的てきIE版本はんぽん。在ざい移うつり动端支持しじiOS 7+和わAndroid 4.0+。

用法ようほう

加か載のjQuery

jQuery库是包含ほうがん所有しょゆう公共こうきょうDOM、事件じけん、效果こうか和わAjax函数かんすう的てき一いち个JavaScript文ぶん件けん。可か以通过链接せっ到いた本地ほんじ副本ふくほん或ある公共こうきょう服ふく务器提供ていきょう的てき许多副本ふくほん之の一いち把わjQuery包含ほうがん在ざい网页中ちゅう。jQuery有ゆう一いち个由MaxCDN托たく管かん的てき內容傳でん遞網路ろ（CDN）。 Google和わ微ほろ软也托たく管かん了りょうjQuery。

<script src="jquery.js"></script>

也可以直接ちょくせつ从CDN中ちゅう加か载jQuery：

<script
  src="https://code.jquery.com/jquery-3.3.1.min.js"
  integrity="sha256-FgpCb/KJQlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8="
  crossorigin="anonymous"></script>

使用しよう风格

jQuery有ゆう两种使用しよう风格：

• 通つう过jQuery对象的てき工こう厂方法ほう$函数かんすう。这些函数かんすう通常つうじょう称しょう作さく命令めいれい，使用しよう方法ほうほう链进行调用，因いん为它们都返かえし回かいjQuery对象。
• 通つう过$.开头的てき函数かんすう。这些是ぜ工具こうぐ函数かんすう，它们不ふ直接ちょくせつ作用さよう于jQuery对象。

在ざいjQuery中ちゅう访问和わ操作そうさ多た个DOM节点通常つうじょう从用CSS选择器き字じ符ふ串くし调用$函数かんすう开始。这会返かえし回かい一いち个引用いんようHTML页面中ちゅう所有しょゆう匹ひき配はい元素げんそ的てきjQuery对象。比ひ如$("div.test")，会かい返かえし回かい一いち个拥有ゆうclass test的てき所有しょゆうdiv元素げんそ的てきjQuery对象。可か以通过调用よう返かえし回かい的てきjQuery对象或ある节点本身ほんみ的てき方法ほうほう来らい操作そうさ这个节点集しゅう。

无冲突模式しき

jQuery还有.noConflict()模も式しき，这会释放对$的てき控ひかえ制せい。如果其他的てき库也使用しよう$作さく为标识符的てき话，这个模も式しき会かい比ひ较有用よう。在ざい无冲突模式しき下か，开发人じん员可以使用しようjQuery替がえ代だい$而不会かい缺かけ失しつ任にん何なん功こう能のう。

典型てんけい的てき代だい码开头

通常つうじょう，jQuery是ぜ通どおり过将初はつ始はじめ化か代だい码和事件じけん处理函数かんすう放ひ入いれ$(handler)中ちゅう来らい使用しよう的てき。当とう浏览器き构建DOM并发送おく加か载事件じけん时触发。

$(function() {
    // 这个匿名とくめい函数かんすう是ぜ页面加か载完成かんせい时要调用的てき函数かんすう。
    // jQuery代だい码，事件じけん处理回かい调写在ざい这里。
});

或ある者もの

$(fn); // 在ざい其他地方ちほう定てい义的名めい为fn的てき函数かんすう，是ぜ页面加か载完成かんせい时要调用的てき函数かんすう。

或ある者もの我わが们也可か以使用しよう

$(document).ready(function() {
    // 这是页面完成かんせい加か载时要よう调用的てき函数かんすう。
    // jQuery代だい码，事件じけん处理回かい调写在ざい这里。
});

由よし于历史し原因げんいん，$(document).ready(callback)已やめ经成为DOM就绪时运行ぎょう代だい码的实质性せい标志。但ただしjQuery 3.0以后，鼓つづみ励开发人员使用よう更さら简短的てき$(handler)标志。

对尚未み加か载的元素げんそ进行事件じけん处理的てき回かい调函数すう可か以作为匿名とくめい函数かんすう在ざい.ready()内部ないぶ注ちゅう册さつ。这些事件じけん处理函数かんすう只ただ会かい在ざい触さわ发事件じけん时被调用。例れい如，下面かめん的てき代だい码添加てんか了りょう一いち个，用よう于在img图像元素げんそ上じょう单击鼠ねずみ标事件じけん的てき处理函数かんすう。

$(function() {
    $('img').on('click', function() {
        // 处理页面中ちゅう任にん何なんimg元素げんそ上じょう的てきclick事件じけん。
    });
});

链接（Chaining）

jQuery命令めいれい通常つうじょう返かえし回かい一いち个jQuery对象，因いん此命令めいれい可か以链接せっ：

$('div.test').add('p.quote').addClass('blue').slideDown('slow');

这行代だい码找到了りょう所有しょゆうclass属性ぞくせい为test的てきdiv标签，以及所有しょゆうclass属性ぞくせい为quote的てきp标签的てき并集，对于所有しょゆう匹ひき配はい的てき元素げんそ都と增加ぞうか一いち个blue的てきclass属性ぞくせい，并用一个动画增加了它们的高度。函数かんすう$与あずかadd影かげ响匹配はい的てき元素げんそ有ゆう哪些，而addClass和わslideDown影かげ响了引用いんよう的てき节点。

一いち些jQuery函数かんすう返かえし回かい特定とくてい的てき值（例れい如$('#input-user-email').val()）。在ざい这些情じょう况下，由ゆかり于该值没有ゆう引用いんようjQuery对象，链接将はた不ふ起おこり作用さよう。

创建新しん的てきDOM元素げんそ

除じょ了りょう通どおり过jQuery对象层次结构访问DOM节点外がい，如果作さく为参数すう传递给$()的てき字じ符ふ串くし看み起おこり来らい像ぞうHTML，也可以创建けん新しん的てきDOM元素げんそ。例れい如，这行代だい码找到ID为carmakes的てきHTML select元素げんそ，并会增加ぞうか一いち个value属性ぞくせい为"VAG"、文字もじ为"Volkswagen"的てきoption元素げんそ：

$('select#carmakes')
    .append($('<option>')
    .attr({
        value:"VAG"
    })
    .append("Volkswagen"));

工具こうぐ函数かんすう

带有$.前ぜん缀的jQuery函数かんすう是ぜ工具こうぐ函数かんすう，或ある者もの说是影かげ响全局きょく属性ぞくせい和行かずゆき为的函数かんすう。下面かめん的てき例れい子こ使用しよう了りょう函数かんすうeach()来き遍あまね历数组：

$.each([1,2,3], function() {
    console.log(this + 1);
});

这会将はた“2”，“3”，“4”写うつし入にゅう控ひかえ制せい台だい。

Ajax

使用しよう$.ajax()可か以执行ぎょう跨またが浏览器き的てきAjax请求。其相关方法ほう可用かよう于加载和处理远程数すう据すえ。

$.ajax({
    type: 'POST',
    url: '/process/submit.php',
    data: {
        name : 'John',
        location : 'Boston'
    },
}).done(function(msg) {
    alert('Data Saved: ' + msg);
}).fail(function(xmlHttpRequest, statusText, errorThrown) {
    alert('Your form submission failed.\n\n'
      + 'XML Http Request: ' + JSON.stringify(xmlHttpRequest)
      + ',\nStatus Text: ' + statusText
      + ',\nError Thrown: ' + errorThrown);
});

本ほん示しめせ例れい将しょう数すう据すえname=John和わlocation=Boston发布到いた服ふく务器上じょう的てき/process/submit.php。当とう这个请求结束时，会かい调用success函数かんすう来らい提ひさげ醒用户。如果请求失しつ败，它会提ひさげ醒用户，告知こくち该请求もとめ的てき状じょう态以及特定とくてい的てき错误。

异步

请注意ちゅうい，上面うわつら的てき例れい子こ使用しよう$.ajax() 的てき延期えんき性せい来らい处理它的异步特性とくせい：.done()和わ.fail()创建仅在异步过程完成かんせい时才运行的てき回かい调。

發はつ佈版本はんぽん

JQuery目前もくぜん分ぶん成なり1.x版ばん、2.x版ばん、3.x版ばん，這三種發佈版本，後ご两种不ふ再さい支援しえんIE 6/7/8，前者ぜんしゃ透過とうかjQuery Migrate plugin與あずか先せん前ぜん版本はんぽん保持ほじ相しょう容よう。

版本はんぽん号ごう	发布日び期き	最新さいしん更新こうしん	大小だいしょう（KB）	备注
1.0	2006年ねん8月がつ26日にち (2006-08-26)			第だい一いち个稳定てい版本はんぽん
1.1	2007年ねん1月がつ14日にち (2007-01-14)
1.2	2007年ねん9月がつ10日とおか (2007-09-10)	1.2.6	54
1.3	2009年ねん1月がつ14日にち (2009-01-14)	1.3.2	55.9	将はたSizzle选择器き引擎引入核心かくしん
1.4	2010年ねん1月がつ14日にち (2010-01-14)	1.4.4	76
1.5	2011年ねん1月がつ31日にち (2011-01-31)	1.5.2	83	延のべ迟回调管理かんり，ajax模も块重写うつし
1.6	2011年ねん5月がつ3日にち (2011-05-03)	1.6.4	89	显著改善かいぜんattr()与あずかval()的てき性能せいのう
1.7	2011年ねん11月3日にち (2011-11-03)	1.7.2 (2012年ねん3月がつ21日にち (2012-03-21))	92	新しん的てき事件じけんAPI：.on()和わ.off()，而旧的てきAPI仍然支持しじ。
1.8	2012年ねん8月がつ9日にち (2012-08-09)	1.8.3 (2012年ねん11月13日にち (2012-11-13))	91.4	重じゅう写うつしSizzle选择器き引擎，改善かいぜん动画和わ$(html, props)的てき灵活性せい。
1.9	2013年ねん1月がつ15日にち (2013-01-15)	1.9.1 (2013年ねん2月がつ4日にち (2013-02-04))	90	移うつり除じょ弃用接せっ口こう，清せい理代りよ码
1.10	2013年ねん5月がつ24日にち (2013-05-24)	1.10.2 (2013年ねん7月がつ3日にち (2013-07-03))	91	修おさむ复了1.9和わ2.0 beta版本はんぽん周期しゅうき的てきbug和わ差さ异
1.11	2014年ねん1月がつ24日にち (2014-01-24)	1.11.3 (2015年ねん4月がつ28日にち (2015-04-28))	95.9
1.12	2016年ねん1月がつ8日にち (2016-01-08)	1.12.4 (2016年ねん5月がつ20日はつか (2016-05-20))	95
2.0	2013年ねん4月がつ18日にち (2013-04-18)	2.0.3 (2013年ねん7月がつ3日にち (2013-07-03))	81.1	除去じょきょ对IE 6-8的てき支持しじ以提高性能こうせいのう，并降低てい文ぶん件けん大小だいしょう
2.1	2014年ねん1月がつ24日にち (2014-01-24)	2.1.4 (2015年ねん4月がつ28日にち (2015-04-28))	82.4
2.2	2016年ねん1月がつ8日にち (2016-01-08)	2.2.4 (2016年ねん5月がつ20日はつか (2016-05-20))	85.6
3.0	2016年ねん6月がつ9日にち (2016-06-09)	3.0.0 (2016年ねん6月がつ9日にち (2016-06-09))	86.3	Deferred、$.ajax、$.when支持しじPromises/A+，令れい.data()兼けん容ようHTML5
3.1	2016年ねん7月がつ7日にち (2016-07-07)	3.1.1 (2016年ねん9月がつ23日にち (2016-09-23))	86.3	加入かにゅうjQuery.readyException，ready handler错误现在不ふ会かい不ふ显示了りょう
3.2	2017年ねん3月がつ16日にち (2017-03-16)	3.2.1 (2017年ねん3月がつ20日はつか (2017-03-20))	84.6	增加ぞうか了りょう对检索さく<template>元素げんそ内容ないよう的てき支持しじ，弃用了りょう多た种旧方法ほうほう。
3.3	2018年ねん1月がつ19日にち (2018-01-19)	3.3.1 (2018年ねん1月がつ20日はつか (2018-01-20))	84.8	弃用旧きゅう函数かんすう，函数かんすう现在可か以接受类，并支持しじ其写成なり数すう组格式しき。
3.4	2019年ねん4月がつ10日とおか (2019-04-10)	3.4.1 (2019年ねん5月がつ1日にち (2019-05-01))	86.1	改あらため進しん性能せいのう，增加ぞうかnonce及nomodule，修復しゅうふくradio elements。
3.5	2020年ねん4月がつ10日とおか (2020-04-10)	3.5.1 (2019年ねん5月がつ4日にち (2019-05-04))	87.4	安全あんぜん性せい更新こうしん，以.even()及.odd()代替だいたい:even及:odd，棄用jQuery.trim。
3.6	2021年ねん3月がつ2日にち (2021-03-02)	3.6.4 (2023年ねん3月がつ8日にち (2023-03-08))	88.2	错误修正しゅうせい，当とう发生JSONP错误时返回かいJSON，兼けん容よう新版しんぱんChrome选择器き。
3.7	2023年ねん5月がつ11日にち (2023-05-11)	3.7.1 (2023年ねん8月がつ28日にち (2023-08-28))	85.4	添加てんか了りょう .uniqueSort() 方法ほうほう，性能せいのう优化，优化 .outerWidth(true) 和わ .outerHeight(true) 对负边距的てき处理，焦点しょうてん修おさむ复。

子こ项目

以下いか项目均ひとし是ぜ源げん自じ于Interface插件

jQuery UI

更さら多た信しん息いき：jQuery UI

基もと于jQuery的てき用よう户界面めん库，包括ほうかつ拖放、缩放、对话框かまち、标签页等多た个组件けん。

jQuery Tools

jQuery Tools是ぜ一個第三方的套件，基き於jQuery。包括ほうかつ了りょう标签页、表おもて單たん驗けん證しょう、滑すべり鼠ねずみ滾たぎ輪わ事件じけん等とう多た个组件けん。

jQuery Mobile

基もと於jQuery的てき手て機き網もう頁ぺーじ製作せいさく工具こうぐ，jQuery Mobile的てき網もう站上包含ほうがん了りょう網もう頁ぺーじ的てき設計せっけい工具こうぐ、主題しゅだい設計せっけい工具こうぐ。另外jQuery Mobile的てきjs插件包含ほうがん了りょう換かわ頁ぺーじ、事件じけん等とう的てき多項たこう功こう能のう。

参まいり阅

• jQuery UI

競きおい品ひん

• Prototype JavaScript框かまち架か
• MooTools

相關そうかん書籍しょせき

英文えいぶん

• Learning jQuery, ISBN 1-84719-250-5
• jQuery in Action, ISBN 1-933988-35-5
• Pro JavaScript Techniques, ISBN 1-59059-727-3

中ちゅう文ぶん

• 锋利的てきjQuery , ISBN 978-7-115-20701-2
• 網あみ頁ぺーじ設計せっけい？愛あい上じょうjQuery, ISBN 978-986-6850-84-4
• Learning jQuery中ちゅう文ぶん版ばん，ISBN 978-986-6761-60-7
• jQuery UI & Plugins, ISBN 978-986-6551-11-6
• 你不能ふのう錯過的てき jQuery 指南しなん ISBN 9789572244173

外部がいぶ連結れんけつ

• jQuery官かん方かた网站（页面存そん档备份，存そん于互联网档案あん馆）
• jQuery UI官かん方かた网站（页面存そん档备份，存そん于互联网档案あん馆）
• jQuery - Google Code （页面存そん档备份，存そん于互联网档案あん馆）（各かく版本はんぽんJQuery的てき下か載の處しょ）
• YouTube上じょう的てきjQuery（2008年ねん4月がつ3日にち，Google Tech Talks）
• Github上うえ的てきjQuery 原始げんし碼 （页面存そん档备份，存そん于互联网档案あん馆）