当前位置: 首页 > 中文手册 > jQuery.html() 函数详解

jQuery.html() 函数详解

html()函数用于设置或返回当前jQuery对象所匹配的DOM元素内的html内容

该函数的用途相当于设置或获取DOM元素的innerHTML属性值。

该函数属于jQuery对象(实例)。

语法

jQueryObject.html( [ htmlString ] )

参数

参数描述
htmlString可选/String/Function类型用于设置的html字符串。

如果没有指定htmlString参数,则表示获取第一个匹配元素的html内容;如果指定了htmlString参数,则表示设置所有匹配元素的html内容。

jQuery 1.4 新增支持:参数htmlString可以为函数。html()将根据匹配的所有元素遍历执行该函数,函数中的this将指向对应的DOM元素。

html()还会为函数传入两个参数:第一个参数就是该元素在匹配元素中的索引,第二个参数就是该元素当前的html内容。函数的返回值就是需要为该元素设置的html内容。

如果参数htmlString不是字符串或函数类型,则会被转换为字符串类型( toString() )。如果参数为nullundefined,则将其视作空字符串("")。

返回值

html()函数的返回值是String/jQuery类型,返回值的实际类型取决于html()函数所执行的操作。

如果html()函数执行的是设置操作,将返回当前jQuery对象本身。如果执行的是获取操作,将返回第一个匹配元素的html内容,该值为字符串类型。

示例&说明

以下面这段HTML代码为例:

<div id="n1">
	<p id="n2">Hello</p>
	<p id="n3">
		CodePlayer
		<span id="n4">专注于编程开发技术分享</span>
		<span id="n5"></span>
	</p>
</div>

我们编写如下jQuery代码:

var $n2 = $("#n2");
alert( $n2.html() ); // Hello
// 设置n2的html内容
$n2.html( '<strong>Hello World</strong>' );

var $n3 = $("#n3");
alert( $n3.html() );
/*
CodePlayer
<span id="n4">专注于编程开发技术分享</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;	
});

运行代码

104 4
我们认为: 用户的主要目的,是为了获取有用的信息,而不是来点击广告的。因此本站将竭力做好内容,并将广告和内容进行分离,确保所有广告不会影响到用户的正常阅读体验。用户仅凭个人意愿和兴趣爱好点击广告。
我们坚信:只有给用户带来价值,用户才会给我们以回报。
CodePlayer技术交流群1CodePlayer技术交流群1

帮朋友打一个硬广告:

P2P网贷系统(Java版本) 新年低价大促销,多年P2P技术积累,系统功能完善(可按需定制,可支持第三方存管、银行存管),架构稳定灵活、性能优异、二次开发快速简单。 另可提供二次开发、安装部署、售后维护、安全培训等一条龙服务。

外行看热闹,内行看门道。可以自信地认为,在系统设计上,比市面上的晓风、迪蒙、方维、绿麻雀、国融信、金和盛等P2P系统要好。
深圳地区支持自带技术人员现场考察源代码、了解主要技术架构,货比三家,再决定是否购买。

也可推荐他人购买,一旦完全成交,推荐人可获得实际售价 10% 的返现。
有意向者,详情请 点击这里 联系,工作时间立即回复。