jQuery API

jQuery 是一個快速、精簡且功能豐富的 JavaScript 函式庫。它讓 HTML 文件的遍歷和操作、事件處理、動畫和 Ajax 等功能變得更簡單,並提供一個易於使用的 API,適用於多種瀏覽器。如果您是 jQuery 新手,我們建議您查看 jQuery 學習中心

如果您要更新到較新版本的 jQuery,請務必閱讀我們部落格 (https://blog.jquery.com/) 上發布的版本說明。如果您使用的是 1.9 之前的版本,您也應該查看 1.9 升級指南

請注意,這是 jQuery 核心 API 文件。其他專案的 API 文件位於其他位置


.add()

建立一個新的 jQuery 物件,其中包含新增到已配對元素集合的元素。

callbacks.has()

判斷清單是否有附加任何回呼函式。如果提供回呼函式作為引數,判斷它是否在清單中。

.closest()

針對集合中的每個元素,取得第一個符合選擇器的元素,方法是測試元素本身並向上遍歷其在 DOM 樹中的祖先。

.css()

取得已匹配元素集合中第一個元素的計算樣式屬性值,或為每個已匹配元素設定一個或多個 CSS 屬性。

.data()

儲存與已匹配元素關聯的任意資料,或傳回已匹配元素集合中第一個元素的命名資料儲存庫中的值。

.end()

結束目前鏈中的最新篩選操作,並將符合的元素集合返回至其先前狀態。

.even()

將匹配元素的集合縮減至集合中從零開始編號的偶數元素。

.filter()

將符合選擇器或通過函數測試的元素縮減到匹配的元素集合。

.find()

取得目前匹配的元素集合中每個元素的子孫,並透過選擇器、jQuery 物件或元素進行篩選。

.finish()

停止目前執行的動畫,移除所有排隊的動畫,並完成所有匹配元素的動畫。

.has()

將匹配的元素組縮小到具有與選擇器或 DOM 元素匹配的後代元素。

.innerHeight()

取得已配對元素集中第一個元素的目前計算內部高度(包括內距但不包括邊框)或設定每個已配對元素的內部高度。

.innerWidth()

取得已配對元素集中第一個元素的目前計算內部寬度(包括內距但不包括邊框)或設定每個已配對元素的內部寬度。

.is()

根據選擇器、元素或 jQuery 物件檢查目前已配對的元素集,如果這些元素中至少有一個符合指定的參數,則傳回 true。

jQuery()

傳回已配對元素的集合,這些元素可以根據傳遞的參數在 DOM 中找到,或透過傳遞 HTML 字串建立。

jQuery.cssHooks

直接掛鉤 jQuery 以覆寫如何擷取或設定特定 CSS 屬性,標準化 CSS 屬性命名,或建立自訂屬性。

jQuery.cssNumber

包含所有可能在沒有單位的情況下使用的 CSS 屬性的物件。.css() 方法使用此物件查看是否可以將 px 附加到無單位的數值。

jQuery.Deferred()

傳回可串接公用程式物件的工廠函式,其中包含方法,可將多個回呼註冊到回呼佇列、呼叫回呼佇列,以及轉送任何同步或非同步函式的成功或失敗狀態。

jQuery.each()

通用反覆運算器函式,可順暢地反覆運算物件和陣列。陣列和具有長度屬性的類陣列物件(例如函式的引數物件)會依據數字索引從 0 到長度-1 反覆運算。其他物件會透過其命名屬性反覆運算。

jQuery.param()

建立一個陣列、純物件或 jQuery 物件的序列化表示,適用於 URL 查詢字串或 Ajax 要求中。如果傳遞一個 jQuery 物件,它應該包含具有名稱/值屬性的輸入元素。

jQuery.uniqueSort()

在陣列或類陣列的 DOM 元素中就地排序,並移除重複的元素。請注意,這僅適用於 DOM 元素陣列/類陣列,不適用於字串或數字。

jQuery.when()

提供一種方式,根據零個或多個 Thenable 物件(通常表示非同步事件的 Deferred 物件)來執行回呼函式。

.map()

將目前符合的集合中的每個元素傳遞給函數,產生包含回傳值的新的 jQuery 物件。

.next()

取得符合的元素集合中每個元素緊接在後的同層元素。如果提供選擇器,則僅在符合該選擇器時才會擷取下一個同層元素。

.nextAll()

取得符合元素集合中每個元素的所有後續同層元素,可選擇透過選擇器進行篩選。

.nextUntil()

取得每個元素的所有後續同層元素,直到但不包含與傳遞的選擇器、DOM 節點或 jQuery 物件相符的元素。

.odd()

將符合元素的集合縮減為集合中的奇數元素,從 0 開始編號。

.outerHeight()

取得匹配元素集合中第一個元素的目前計算的外高度(包含內距、邊框,以及選擇性的外距),或設定每個匹配元素的外高度。

.outerWidth()

取得匹配元素集合中第一個元素的目前計算的外寬度(包含內距、邊框,以及選擇性的外距),或設定每個匹配元素的外寬度。

.parentsUntil()

取得目前相符元素集合中每個元素的祖先,直到與選擇器、DOM 節點或 jQuery 物件相符的元素,但不包含該元素。

.prev()

取得相符元素集合中每個元素緊鄰的前一個同層元素。如果提供選擇器,則僅在該同層元素與選擇器相符時才擷取。

.prevAll()

取得相符元素集合中每個元素的所有前一個同層元素,可選擇使用選擇器進行篩選,並以文件反向順序排列。

.prevUntil()

取得每個元素的所有前一個同層元素,直到與選擇器、DOM 節點或 jQuery 物件相符的元素,但不包含該元素。

.promise()

傳回一個 Promise 物件,用於觀察與集合相關的某種類型的所有動作(無論是否已排隊)完成時的情況。

.text()

取得匹配元素集合中每個元素的合併文字內容(包括其子代),或設定匹配元素的文字內容。

.uniqueSort()

在原地對 DOM 元素的 jQuery 物件進行排序,並移除重複的元素。請注意,這只適用於由 DOM 元素組成的 jQuery 物件,而不適用於字串或數字。