jQuery 3.2.1 文檔是 jQuery JavaScript 庫的最新版本。它是一套廣泛使用的 JavaScript 工具,可在網頁中快捷、簡便地操作 HTML 元素。jQuery 是一個小巧卻功能強大的庫,用于開發跨瀏覽器的 Web 應用程序。
jQuery 3.2.1 版本相較于其前一個版本進行了多項改進。其中最重要的是內置了一個 JavaScript Promise 實現,這意味著開發者可以在代碼中使用 Promise,顯著提高了性能和靈活性。
此版本還增加了一些新的方法和功能。例如可以使用 $.when() 方法一次傳入多個 Promise 對象,或使用 $.catch() 如同標準 Promise API 中的 .catch() 方法,來捕捉異常并進行處理。此外,$.Deferred() 和 $.Promise() 方法用于更加靈活地自定義 Promise 鏈。
// 使用 $.when() 方法 $.when($.ajax("api/1.json"), $.ajax("api/2.json")).done(function(result1, result2){ console.log(result1); console.log(result2); }).fail(function(jqXHR, textStatus, errorThrown) { console.log(textStatus); }); // 使用 $.catch() 方法 $.ajax("api/xxx.json").catch(function(jqXHR, textStatus, errorThrown) { console.log(textStatus); }); // 自定義 Promise 鏈 var dfd = $.Deferred(); var promise = dfd.promise(); promise.then(function() { console.log('step 1'); }).then(function() { console.log('step 2'); }); dfd.resolve();
除了 Promise 相關的改進之外,此版本的 jQuery 還對選擇器性能進行了優化,提高了其處理速度。另外,與哈希路由有關的相關方法(如 $.param.fragment() 和 $.bbq.pushState()),現在也已從 jQuery BBQ 插件中移植到了 jQuery 核心庫中,在代碼中可以直接使用。
總之,jQuery 3.2.1 版本的文檔提供了完整的 API 參考,并且包含了許多示例和代碼片段,為開發者提供了更好的使用和理解 jQuery 的方式。