[翻译]jQuer API/1.1.1/DOM/Attributes

 

addClass( class )

---

给匹配的每个元素添加指定的CSS class(es)。

返回: jQuery
参数:

• class (String): 要给元素添加的一个或多个CSS classes

例子:

 $("p").addClass("selected")

执行前:

 <p>Hello</p>

结果:

 [ <p class="selected">Hello</p> ]

例子:

 $("p").addClass("selected highlight")

执行前:

 <p>Hello</p>

结果:

 [ <p class="selected highlight">Hello</p> ]

attr( name )

---

访问第一个匹配元素的属性。这个方法使得检索第一个匹配元素的属性值更加容易。

返回: Object
参数:

• name (String): 要访问的属性名称

例子:

返回文档中第一个image的src属性值。

 $("img").attr("src");

执行前:

 <img src="test.jpg"/>

结果:

 test.jpg

attr( properties )

---

将key/value对象赋给匹配元素的属性。

这个方法适合于给匹配元素的大量属性设置值。

返回: jQuery
参数:

• properties (Map): Key/value pairs to set as object properties.

例子:

设置所有image的src和alt属性。

 $("img").attr({ src: "test.jpg", alt: "Test Image" });

执行前:

 <img/>

结果:

 <img src="test.jpg" alt="Test Image"/>

attr( key, value )

---

给所有匹配元素的单个属性设置一个通过计算得出来的值。

通过执行一个函数，将返回值赋给属性。

返回: jQuery
参数:

• key (String): 需要设置的属性名称。
• value (Function): 一个函数，将此函数的返回值赋属性。范围：当前元素，参数：当前元素的索引号。

例子:

将src属性值设置到title属性。

 $("img").attr("title", function() { return this.src });

执行前:

 <img src="test.jpg" />

结果:

 <img src="test.jpg" title="test.jpg" />

例子:

Enumerate title attribute.

 $("img").attr("title", function(index) { return this.title + (i + 1); });

执行前:

 <img title="pic" /><img title="pic" /><img title="pic" />

结果:

 <img title="pic1" /><img title="pic2" /><img title="pic3" />

 

html()

---

取得第一个匹配元素的html内容。此方法在XML文档中无效。

返回: String
例子:

 $("div").html();

执行前:

 <div><input/></div>

结果:

 <input/>

html( val )

---

将html内容赋给每个匹配的元素设置。此属性在XML文档中无效。

返回: jQuery
参数:

• val (String): Set the html contents to the specified value.

例子:

 $("div").html("<b>new stuff</b>");

执行前:

 <div><input/></div>

结果:

 <div><b>new stuff</b></div>

removeAttr( name )

---

从所有匹配元素中移除指定属性。

返回: jQuery
参数:

• name (String): 要移除的属性。

例子:

 $("input").removeAttr("disabled")

执行前:

 <input disabled="disabled"/>

结果:

 <input/>

removeClass( class )

---

移除匹配元素指定的CSS class。

Return value: jQuery
Parameters:

• class (String): (可选)要从元素中移除的一个或多个CSS classes。

Example:

 $("p").removeClass()

Before:

 <p class="selected">Hello</p>

Result:

 [ <p>Hello</p> ]

Example:

 $("p").removeClass("selected")

Before:

 <p class="selected first">Hello</p>

Result:

 [ <p class="first">Hello</p> ]

Example:

 $("p").removeClass("selected highlight")

Before:

 <p class="highlight selected first">Hello</p>

Result:

 [ <p class="first">Hello</p> ]

text()

---

取得所有匹配元素的文本内容。返回的结果是所有匹配元素的文本内容连接起来的字符串。此方法可以在HTML和XML文档中使用。

Return value: String
Example:

取得所有段落的链接文本。

 $("p").text();

Before:

 <p><b>Test</b> Paragraph.</p><p>Paraparagraph</p>

Result:

 Test Paragraph.Paraparagraph

text( val )

---

给所有匹配的元素设置文本内容。

他html()类似，但会经过HTML编码（替换 "<"和 ">"为HTML转义符）。

Return value: String
Parameters:

• val (String): 将要设置给元素的文本值。

Example:

给所有段落设置文本内容。

 $("p").text("<b>Some</b> new text.");

Before:

 <p>Test Paragraph.</p>

Result:

 <p><b>Some</b> new text.</p>

Example:

给所有段落设置文本内容。

 $("p").text("<b>Some</b> new text.", true);

Before:

 <p>Test Paragraph.</p>

Result:

 <p>Some new text.</p>

toggleClass( class )

---

如果匹配元素没有指定的CSS Class则给它们设置，否则移除指定CSS Class。

Return value: jQuery
Parameters:

• class (String): 一个 CSS class。

Example:

 $("p").toggleClass("selected")

Before:

 <p>Hello</p><p class="selected">Hello Again</p>

Result:

 [ <p class="selected">Hello</p>, <p>Hello Again</p> ]

val()

---

取得第一个匹配元素的当前值。

Return value: String
Example:

 $("input").val();

Before:

 <input type="text" value="some text"/>

Result:

 "some text"

val( val )

给每个匹配的元素设置值。

Return value: jQuery
Parameters:

• val (String): 新值。

---

Example:

 $("input").val("test");

Before:

 <input type="text" value="some text"/>

Result:

 <input type="text" value="test"/>

无常翻译：http://wuchang.cnblogs.com
wuChang@guet.edu.cn
QQ: 3263262

Retrieved from "http://www.docs.jquery.com/API/1.1.1/DOM/Attributes"