jQuery 核心 - jQuery() 方法 · W3School jQuery 參考手冊

# jQuery 核心 - jQuery() 方法 ## 實例找出所有屬于 div 元素的子元素的 p 元素，然后設置其邊框屬性： ``` $("div > p").css("border", "1px solid gray"); ``` ## 定義和用法 jQuery() 方法接受一個字符串，其中包含了用于匹配元素集合的 CSS 選擇器。 jQuery() 函數有三種語法： ### 語法 1 接受一個字符串，其中包含了用于匹配元素集合的 CSS 選擇器： ``` jQuery(_selector_, [_context_]) ``` [詳細用法](#syntax1) ### 語法 2 使用原始 HTML 的字符串來創建 DOM 元素： ``` jQuery(_html_,[_ownerDocument_]) ``` [詳細用法](#syntax2) ### 語法 3 綁定一個在 DOM 文檔載入完成后執行的函數： ``` jQuery( callback ) ``` [詳細用法](#syntax3) ## jQuery( selector, [ context ] ) 該語法有以下幾種用法： ### 用法 1 ：設置選擇器環境 #### 語法 ``` jQuery(_selector_, [_context_]) ``` 默認情況下，選擇器從文檔根部對 DOM 進行搜索。不過，可以為 $() 設置可選的 context 參數。例如，如果我們希望在一個 callback 中搜索一個元素，可以限定下面的搜索： #### 實例 ``` $("div.foo").click(function() { $("span", this).addClass("bar"); }); ``` 由于我們已經將 span 選擇器限定到 this 這個環境中，只有被點擊元素中的 span 會得到附加的 class。在內部，選擇器環境是通過 .find() 方法實現的，因此 $("span", this) 等價于 $(this).find("span")。 jQuery 的核心功能都是通過這個函數實現的。jQuery中的一切都基于這個函數，或者說都是在以某種方式使用這個函數。這個函數最基本的用法就是向它傳遞一個表達式（通常由 CSS 選擇器組成），然后根據這個表達式來查找所有匹配的元素。默認情況下, 如果沒有指定 context 參數，$() 將在當前的 HTML document 中查找 DOM 元素；如果指定了 context 參數，如一個 DOM 元素集或 jQuery 對象，那就會在這個 context 中查找。在 jQuery 1.3.2 以后，其返回的元素順序等同于在 context 中出現的先后順序。 ### 用法 2 ：使用 DOM 元素 #### 語法 ``` jQuery(_element_) ``` 該函數允許我們通過使用以其他方式找到的 DOM 元素來創建 jQuery 對象。該功能通常的用法是，對已經通過 this 關鍵字傳遞到 callback 函數的元素調用 jQuery 的方法： #### 實例 ``` $("div.foo").click(function() { $(this).slideUp(); }); ``` 此例會在元素被點擊時使用滑動動畫對其進行隱藏。由于處理程序接受的 this 關鍵詞中的被點擊項目是純的 DOM 元素，因此在對其調用 jQuery 的方法之前，必須用 jQuery 對象包裝該元素。這個函數也可以接收 XML 文檔和 Window 對象（雖然它們不是 DOM 元素）作為有效的參數。當 XML 數據從 Ajax 調用中返回后，我們可以使用 $() 函數通過 jQuery 對象包裝該數據。一旦完成，我們就可以使用 .find() 和其他 DOM 遍歷方法來取回 XML 結構中單個元素。 ### 用法 3 ：克隆 jQuery 對象 #### 語法 ``` jQuery(_jQuery object_) ``` 當以參數的形式向 $() 函數傳遞 jQuery 對象后，會創建一個該對象的副本。與初始對象一樣，新的 jQuery 對象引用相同的 DOM 元素。 ### 用法 4 ：返回空的集合 #### 語法 ``` jQuery() ``` 對于 jQuery 1.4，調用無參數的 jQuery() 方法會返回空的 jQuery 集合。在之前版本的 jQuery 中，這樣會返回包含 document 節點的集合。 ## jQuery( html, [ ownerDocument ] ) 該語法有以下幾種用法： ### 用法 1 ：創建新的元素 #### 語法 ``` jQuery(_html_,[_ownerDocument_]) ``` 你可以傳遞一個手寫的 HTML 字符串，或者由某些模板引擎或插件創建的字符串，也可以是通過 AJAX 加載過來的字符串。但是在你創建 input 元素的時會有限制，可以參考第二個示例。當然這個字符串可以包含斜杠 (比如一個圖像地址)，還有反斜杠。當你創建單個元素時，請使用閉合標簽或 XHTML 格式。例如，創建一個 span ，可以用 $("<span/>") 或 $("<span></span>") ，但不推薦 $("<span>")。在 jQuery 中，這個語法等同于 $(document.createElement("span"))。如果以參數的形式將字符串傳遞給 $()，jQuery 會檢查字符串是否是 HTML （比如，字符串某些位置存在標簽）。如果不是，則把字符串解釋為選擇器表達式，請見上面的講解。但如果字符串是 HTML 片段，則 jQuery 試圖創建由該 HTML 片段描述的 DOM 元素。然后會創建并返回一個引用這些 DOM 元素的 jQuery 對象： #### 實例 ``` $("<p id="test">My <em>new</em> text</p>").appendTo("body"); ``` 如果 HTML 片段比不含屬性的簡單標簽更復雜，如同上面例子中的 HTML，那么元素實際的創建過程是由瀏覽器的 innerHTML 機制完成的。具體地講，jQuery 會創建新的 <div> 元素，然后為傳入的 HTML 片段設置元素的 innerHTML 屬性。當參數只是簡單的標簽，比如$("<img />") 或 $("<a></a>")，jQuery 會通過內生的 JavaScript createElement() 函數來創建元素。要確保跨平臺兼容性，片段的結構必須良好。能夠包含其他元素的標簽必須成對出現（帶有關閉標簽）： ``` $("<a href="http://jquery.com"></a>"); ``` 不過，jQuery 也允許類似 XML 的標簽語法： ``` $("<a/>"); ``` 無法包含其他元素的標簽可以關閉，也可以不關閉： ``` $("<img />"); $("<input>"); ``` ### 用法 2 ：設置屬性和事件 #### 語法 ``` jQuery(_html_,_props_) ``` 對于 jQuery 1.4，我們可以向第二個參數傳遞一個屬性映射。該參數接受能夠傳遞給 .attr() 方法的屬性的超集。此外，可以傳遞任意的事件類型，并可以調用下面的 jQuery 方法：val, css, html, text, data, width, height, or offset. 注意，Internet Explorer 不允許你創建 input 元素并改變其類型；您必須使用例如 "<input type="checkbox" />" 來規定類型。 #### 實例創建一個 <input> 元素，同時設定 type 屬性、屬性值，以及一些事件。 ``` $("<input>", { type: "text", val: "Test", focusin: function() { $(this).addClass("active"); }, focusout: function() { $(this).removeClass("active"); } }).appendTo("form"); ``` ## jQuery( callback ) 允許你綁定一個在 DOM 文檔載入完成后執行的函數。該函數的作用如同 $(document).ready() 一樣，只不過用這個函數時，需要把頁面中所有需要在 DOM 加載完成時執行的其他 $() 操作符都包裝到其中來。盡管從技術上來說，這個函數是可鏈接的，但真正以這種方式鏈接的情況并不多。 ### 例子當DOM加載完成后，執行其中的函數： ``` $(function(){ // 文檔就緒 }); ```