- /**
- * @expression CSS 選擇器
- * @context 查找的上下文
- * @return jQuery Object
- */
- function jQuery(expression, [context]);
這個函數接收一個包含 CSS 選擇器的字符串,然後用這個字符串去匹配一組元素。
jQuery 的核心功能都是通過這個函數實現的。jQuery中的一切都基於這個函數,或者說都是在以某種方式使用這個函數。這個函數最基本的用法就是向它傳遞一個表達式(通常由 CSS 選擇器組成),然後根據這個表達式來查找所有匹配的元素。
默認情況下, 如果沒有指定 context 參數,$() 將在當前的 HTML 文檔中查找 DOM 元素;如果指定了 context 參數,如一個 DOM 元素集或 jQuery 對象,那就會在這個 context 中查找。
默認情況下,如果沒有指定context參數,$() 將在當前的 HTML 文檔中查找 DOM 元素;如果指定了 context 參數,如一個 DOM 元素集或 jQuery 對象,那就會在這個 context 中查找。
● jQuery(html)
- /**
- * @html 用於動態創建 DOM 元素的 HTML 標記字符串
- * @return jQuery Object
- */
- function jQuery(html);
根據提供的原始 HTML 標記字符串,動態創建由 jQuery 對象包裝的 DOM 元素。
你可以傳遞一個手寫的 HTML 字符串,或者由某些模板引擎或插件創建的字符串,也可以是通過 AJAX 加載過來的字符串。但是在你創建 input 元素的時會有限制,可以參考示例。當然這個字符串可以包含斜槓 (比如一個圖像地址),還有反斜槓。當你創建單個元素時,請使用閉合標籤或 XHTML 格式。例如,創建一個 span,可以用 $("<span/>") 或 $("<span></span>"),但不推薦 $("<span>")。
- // 在 IE 中無效
- $("<input>").attr("type", "checkbox");
- // 在 IE 中有效
- $("<input type='checkbox'>");
● jQuery(elements)
- /**
- * @elements(Element, Array<Element>) 用於封裝成 jQuery 對象的 DOM 元素
- * @return jQuery Object
- */
- function jQuery(elements);
將一個或多個 DOM 元素轉化爲jQuery對象。這個函數也可以接收 XML 文檔和 Window 對象(雖然它們不是 DOM 元素)作爲有效的參數。
● jQuery(callback)
- /**
- * @callback(Function) 當 DOM 加載完成後(僅僅是 DOM 樹形成)要執行的函數
- * @return jQuery Object
- */
- function jQuery(callback);
$(document).ready() 的簡寫。
允許你綁定一個在 DOM 文檔載入完成後執行的函數。這個函數的作用如同 $(document).ready() 一樣,只不過用這個函數時,需要把頁面中所有需要在 DOM 加載完成時執行的 $() 操作符都包裝到其中來。從技術上來說,這個函數是可鏈接的 - 但真正以這種方式鏈接的情況並不多。
你可以在一個頁面中使用任意多個 $(document).ready 事件。