jQuery.html() 方法
jQuery.html() 方法
定义和用法
html()
函数用于设置或返回当前jQuery对象所匹配的DOM元素内的html内容。
该函数的用途相当于设置或获取DOM元素的innerHTML
属性值。
该函数属于jQuery
对象(实例)。
语法
参数
参数 | 描述 |
---|---|
htmlString | 可选/String/Function类型 用于设置的html字符串。 |
如果没有指定htmlString
参数,则表示获取第一个匹配元素的html内容;如果指定了htmlString
参数,则表示设置所有匹配元素的html内容。
jQuery 1.4 新增支持:参数htmlString
可以为函数。html()
将根据匹配的所有元素遍历执行该函数,函数中的this
将指向对应的DOM元素。
html()
还会为函数传入两个参数:第一个参数就是该元素在匹配元素中的索引,第二个参数就是该元素当前的html内容。函数的返回值就是需要为该元素设置的html内容。
如果参数htmlString
不是字符串或函数类型,则会被转换为字符串类型( toString() )。如果参数为null
或undefined
,则将其视作空字符串("")。
返回值
html()
函数的返回值是String/jQuery类型,返回值的实际类型取决于html()
函数所执行的操作。
如果html()
函数执行的是设置操作,将返回当前jQuery对象本身。如果执行的是获取操作,将返回第一个匹配元素的html内容,该值为字符串类型。
实例
实例
以下面这段代码为例:
<p id="n2">Hello</p>
<p id="n3">
W3Cschool
<span id="n4">学技术,从W3Cschool开始!</span>
<span id="n5"></span>
</p>
</div>
/* jQuery代码 */
<script>
var $n2 = $("#n2");
alert( $n2.html() ); // Hello
// 设置n2的html内容
$n2.html( '<strong>Hello W3Cschool</strong>' );
var $n3 = $("#n3");
alert( $n3.html() );
/*
CodePlayer
<span id="n4">学技术,从W3Cschool开始!</span>
<span id="n5"></span>
*/
// 清空所有span元素的html内容(将html内容设为"")
$("span").html( "" );
// 将所有p元素的html内容改为"第<em>N</em>个p元素,id为this.id"
// 这里的N表示该元素在所有匹配元素中的序号(1、2、3……)
// this.id是该元素的id属性值
$("p").html( function(index, currentHtml){
// 函数内的this指向当前迭代的p元素
return "第<em>" + (index + 1) + "</em>个p元素,id为" + this.id;
});
</script>
尝试一下 »
点击 "尝试一下" 按钮查看在线实例
更多建议: