jQuery源码-dom操作之jQuery.fn.text

简介:

写在前面

jQuery.fn.text在jQuery是个使用频率比较高的接口,它的作用无非是设置/获取dom节点的内容文本,下文会通过几个简单的例子来说明.text()接口的使用,以及最后会对源码进行分析。这几个接口本身不复杂,理解了textContent属性基本就迎刃而解,妨碍理解的我觉得反而是jQuery.access这样的神级方法。遇到jQuery.access,理解它的作用是设置/读取属性即可。

简单例子

jQuery官方文档是我们永远的好伙伴,可猛戳 http://api.jquery.com/text/,从官方说明来看,有以下几种用法。直接上例子

读取的例子

首先假设页面有这么段html

<div id="node_1">hello</div>
<div id="node_2">a<span>b</span>c</div>

代码如下:

console.log($('#node_1').text());  // 输出 hello
console.log($('#node_2').text());  // abc

从上面可以看出,$(selector).text()返回的是:$(selector)选中的所有节点的所有后代节点的文本内容拼接起来后,要点如下:

1. $(selector)选中的所有节点的集合,假设为A

2. A的所有后代节点,假设为B

3. B的文本内容合起来,就是返回结果

ps:实际返回的结果比上面所说的稍微复杂一点,下面再展开

设置的例子

设置的例子也比较简单,同样假设页面有如下HTML

<div id="node_1">hello</div>
<div id="node_2">a<span>b</span>c</div>

设置例子1

代码如下:

$('node_1').text('hello');
$('node_2').text('world');

原来的HTML变成下面这样子,也就是说,$(node).text( str )操作分有两个表现:

1. node原有子节点被全部删除

2. node的文本内容被设置为str

<div id="node_1">hello</div>
<div id="node_2">world</div>

设置例子二:

紧接例子一,再看下面这段代码,注意点:

1. index为当前处理的元素e在选中集合中的位置,0开始

2. text为e的文本节点

$('div').text(function(index, text){
    return text + index;
});

结果如下:

<div id="node_1">hello0</div>
<div id="node_2">world1</div>

源码分析

textContent这个属性,对 jQuery.fn.text() 接口的理解很关键,如果不熟悉的童鞋可以参考下笔者前几天在MDN翻译的相关页面 Node.textContent

首先是jQuery.fn.text的源码,可见内容是通过jQuery.text、jQuery.access(神一样的方法)实现的:

复制代码
text: function( value ) {
        return jQuery.access( this, function( value ) {
            return value === undefined ?
                jQuery.text( this ) :
                this.empty().append( ( this[0] && this[0].ownerDocument || document ).createTextNode( value ) );
        }, null, value, arguments.length );
    }
复制代码

源码分析:设置text

设置text的源码比较简单,从左往右念就是:

1、清空节点原本的内容

2、通过createTextNode方法创建一个text节点(参数为传入的value)

3、将text节点插入node里去

this.empty().append( ( this[0] && this[0].ownerDocument || document ).createTextNode( value ) );

源码分析:获取text

接下来是jQuery.text(),其实是Sizzle.getText

jQuery.text = Sizzle.getText;

再看Sizzle.getText,代码不算复杂,归纳起来就几点:

1、如果elem为文本节点(TEXT_NODE),那么取elem.nodeValue

2、如果elem为元素节点(ELEMENT_NODE)、文档节点(DOCUMENT_NODE)、文档碎片节点(DOCUMENT_NODE),那么

  2.1 元素节点:取elem.textContent

  2.2 文档节点、文档碎片节点:逐层遍历子节点,获取 textContent 后进行拼接

3、PROCESSING_INSTRUCTION_NODE、COMMENT_NODE被排除在外

复制代码
getText = Sizzle.getText = function( elem ) {
    var node,
        ret = "",
        i = 0,
        nodeType = elem.nodeType;

    if ( !nodeType ) {
        // If no nodeType, this is expected to be an array
        for ( ; (node = elem[i]); i++ ) {
            // Do not traverse comment nodes
            ret += getText( node );
        }
    } else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) {
// 备注:nodeType === 1 为元素节点,9 为document节点,11为document fragment节点
// Use textContent for elements // innerText usage removed for consistency of new lines (see #11153) if ( typeof elem.textContent === "string" ) { return elem.textContent; } else { // Traverse its children for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { ret += getText( elem ); } } } else if ( nodeType === 3 || nodeType === 4 ) {
// nodeType === 3为TEXT_NODE,4为CDATA_SECTION_NODE
return elem.nodeValue; } // Do not include comment or processing instruction nodes return ret; };
复制代码

写在后面

jQuery.fn.text 、jQuery.text 其实并不复杂,理解了textContent属性基本就迎刃而解,妨碍理解的我觉得反而是jQuery.access这样的神级方法。遇到jQuery.access,理解它的作用是设置/读取属性即可。

 


相关文章
|
26天前
|
JavaScript 前端开发
使用jQuery操作DOM元素
使用jQuery操作DOM元素
16 1
|
26天前
|
JavaScript 前端开发
JavaScript操作DOM元素
JavaScript操作DOM元素
11 1
|
1天前
|
存储 JavaScript 前端开发
JavaScript DOM 操作:解释一下 cookie、sessionStorage 和 localStorage 的区别。
Cookie是服务器发送至客户端的文本信息,会随每个请求发送回服务器,适合控制会话状态但可能暴露隐私。SessionStorage仅在当前会话中存储数据,关闭浏览器后清除,适合临时存储如登录状态。LocalStorage则持久保存数据,即使关闭浏览器也不会清除,适用于存储长期设置。三种方式各有侧重,应按需求选择。
8 0
|
1天前
|
JavaScript 前端开发 安全
JavaScript DOM 操作:解释一下浏览器的同源策略。
**同源策略**是浏览器安全基石,它阻止脚本跨不同协议、域名或端口访问资源,防止恶意行为。例如,HTTP页面无法直接用JS获取HTTPS页面内容。**CORS**允许跨域请求,但需服务器配合设置,通过`document.domain`属性可配置,但仍受限于服务器配置。
9 4
N..
|
22天前
|
JavaScript 前端开发 容器
jQuery中的DOM操作
jQuery中的DOM操作
N..
10 1
|
27天前
|
前端开发 JavaScript Java
第四章使用jQuery操作DOM元素
第四章使用jQuery操作DOM元素
9 0
|
27天前
|
JavaScript
jQuery操作DOM元素案例
jQuery操作DOM元素案例
10 0
|
8月前
|
XML JavaScript 前端开发
jQuery 的 DOM 操作
jQuery 的 DOM 操作
51 0
|
8月前
|
JavaScript 前端开发
jQuery 的 DOM 操作- 中
jQuery 的 DOM 操作- 中
30 0
|
8月前
|
JavaScript
jQuery 的 DOM 操作-上
jQuery 的 DOM 操作-上
44 0