[翻译]jQuer API/1.1.1/DOM/Attributes(zz)
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"