jQuery 學習八(屬性)

●  attr(name) 

/**
 * 取得第一個匹配元素的屬性值。通過這個方法可以方便地從第一個匹配元素中獲取一個屬性的值。
 * 如果元素沒有相應屬性，則返回 undefined。
 *
 * @name(String) 屬性名稱
 * @return Object
 * @owner jQuery Object
 */
function attr(name);

// 例子：返回文檔中第一個圖像的src屬性值。
<img src="test1.jpg" />
<img src="test2.jpg" />

$("img").attr("src") -> test1.jpg

    ●  attr(key, value) 

/**
 * 爲所有匹配的元素設置一個屬性值。
 *
 * @key(String) 屬性名稱
 * @value(Object) 屬性值
 * @return jQuery Object
 * @owner jQuery Object
 */
function attr(key, value);

// 例子：爲所有圖像設置 src 屬性。
<img />
<img />

$("img").attr("src", "test.jpg") -> [ <img src= "test.jpg" /> , <img src= "test.jpg" /> ]

    ●  attr(properties) 

/**
 * 將一個 "名/值" 形式的對象設置爲所有匹配元素的屬性。
 *
 * 這是一種在所有匹配元素中批量設置很多屬性的最佳方式。 注意，如果你要設置對象的class屬性，你必須
 * 使用 "className" 作爲屬性名。或者你可以直接使用 .addClass( class ) 和 .removeClass( class )。
 *
 * @properties(Map) 作爲屬性的 "名/值對" 對象
 * @return jQuery Object
 * @owner jQuery Object
 */
function attr(properties);

// 例子：爲所有圖像設置 src 和 alt 屬性。
<img />

$("img").attr({ src: "test.jpg", alt: "Test Image" })  ->
    [ <img src= "test.jpg"  alt:="Test Image" /> ]

    ●  attr(key, fn) 

/**
 * 爲所有匹配的元素設置一個計算的屬性值。
 * 不提供值，而是提供一個函數，由這個函數的返回值作爲屬性值。
 *
 * @key(String) 屬性名稱
 * @fn(Function) 用於計算屬性值的函數，作用域爲當前 DOM 元素，函數簽名：Function(index)
 *               @index 當前 DOM 元素的索引值
 * @return jQuery Object
 * @owner jQuery Object
 */
function attr(key, fn);

// 例子：把 src 屬性的值設置爲 title 屬性的值。
<img src="test.jpg" />

$("img").attr("title", function() { return this.src })  ->
    <img src="test.jpg" title="test.jpg" />

    ●  removeAttr(name) 

/**
 * 從每一個匹配的元素中刪除一個屬性。
 *
 * @name(String) 要刪除的屬性名
 * @return jQuery Object
 * @owner jQuery Object
 */
function removeAttr(name);

// 例子：將文檔中圖像的 src 屬性刪除。
<img src="test.jpg" />

$("img").removeAttr("src")  -> <img  />

    ●  addClass(class) 

/**
 * 爲每個匹配的元素添加指定的類名。
 *
 * @class(String) 一個或多個要添加到元素中的 CSS 類名，使用空格分開
 * @return jQuery Object
 * @owner jQuery Object
 */
function addClass(class);

// 例子：爲匹配的元素加上 "selected highlight" 類。
<p>Hello</p>

$("p").addClass("selected highlight")  -> [ <p class="selected highlight">Hello</p> ]

    ●  removeClass(class) 

/**
 * 爲從所有匹配的元素中刪除全部或者指定的類。
 *
 * @class(String) (可選) 一個或多個要刪除的 CSS 類名，使用空格分開
 * @return jQuery Object
 * @owner jQuery Object
 */
function removeClass(class);

// 例子一：從匹配的元素中刪除 "selected" 類。
<p class="selected first">Hello</p>

$("p").removeClass("selected") -> [ <p>Hello</p> ]

// 例子二：刪除匹配元素的所有類。
<p class="selected first">Hello</p>

$("p").removeClass()  -> [ <p>Hello</p> ]

    ●  toggleClass(class) 

/**
 * 如果存在（不存在）就刪除（添加）一個類。
 *
 * @class(String) CSS 類名
 * @return jQuery Object
 * @owner jQuery Object
 */
function toggleClass(class);

// 例子：爲匹配的元素切換 "selected" 類。
<p>Hello</p><p class="selected">Hello Again</p>

$("p").toggleClass("selected") -> [ <p class="selected">Hello</p>, <p>Hello Again</p> ]

    ●  html() 

/**
 * 取得第一個匹配元素的 html 內容(innerHTML)。這個函數不能用於 XML 文檔。但可以用於 XHTML 文檔。
 *
 * @return String html 內容
 * @owner jQuery Object
 */
function html();

// 例子：取得 div 的內容。
<div><p>Hello</p></div>

$("div").html() -> <p>Hello</p>

    ●  html(val) 

/**
 * 設置每一個匹配元素的 html 內容。這個函數不能用於 XML 文檔。但可以用於 XHTML 文檔。
 *
 * @val(String) 用於設定 HTML 內容的值
 * @return jQuery Object
 * @owner jQuery Object
 */
function html(val);

// 例子：爲 div 設置內容。
<div></div>

$("div").html("<p>Hello Again</p>") -> [ <div><p>Hello Again</p></div> ]

    ●  text() 

/**
 * 取得所有匹配元素的內容(innerText)。
 * 結果是由所有匹配元素包含的文本內容組合起來的文本。這個方法對 HTML 和 XML 文檔都有效。
 *
 * @return String 返回的內容
 * @owner jQuery Object
 */
function text();

// 例子：取得 div 的內容。
<div><p>Hello</p></div>

$("div").text() -> Hello

    ●  text(val) 

/**
 * 取得所有匹配元素的內容。
 *
 * @val(String) 用於設置元素內容的文本
 * @return jQuery Object
 * @owner jQuery Object
 */
function text(val);

// 例子：爲 p 設置內容。
<p>Test Paragraph.</p>

$("p").text("<b>Some</b> new text.") -> [ <p>&lt;b&gt;Some&lt;/b&gt; new text.</p> ]

    ●  val() 

/**
 * 獲得第一個匹配元素的當前值。
 * 在 jQuery 1.2 中,可以返回任意元素的值了。包括 select。如果多選，將返回一個數組，其包含所選的值。
 *
 * @return String/Array<String> 返回的值
 * @owner jQuery Object
 */
function val();

// 例子：獲得單個 select 的值和多選 select 的值。
<select id="single">
  <option>Single</option>
  <option>Single2</option>
</select>
<select id="multiple" multiple="multiple">
  <option selected="selected" value="ppp">Multiple</option>
  <option>Multiple2</option>
  <option selected="selected" value="qqq">Multiple3</option>
</select>

$("#single").val() -> Single
$("#multiple").val() -> ["ppp", "qqq"]

    ●  val(val) 

/**
 * 設置每一個匹配元素的值。
 *
 * @val(String) 要設置的值
 * @return jQuery Object
 * @owner jQuery Object
 */
function val(val);

// 例子：設定文本框的值。
<input type="text" />

$("input").val("hello world!");

    ●  val(val) 

/**
 * check, select, radio 等都能使用爲之賦值。
 *
 * @val(String/Array<String>) 用於 check/select 的值
 * @return jQuery Object
 * @owner jQuery Object
 */
function val(val);

// 例子：設定一個 select 和一個多選的 select 的值。
<select id="single">
  <option>Single</option>
  <option>Single2</option>
</select>
<select id="multiple" multiple="multiple">
  <option value="ppp">Multiple</option>
  <option>Multiple2</option>
  <option value="qqq">Multiple3</option>
</select><br/>
<input type="checkbox" value="check1" /> check1
<input type="checkbox" value="check2" /> check2
<input type="radio" value="radio1" /> radio1
<input type="radio" value="radio2" /> radio2

$("#single").val("Single2");
$("#multiple").val(["ppp", "qqq"]);
$("input").val(["check2", "radio1"]);