JavaScript DOM学习第四章 getElementByTagNames

getElementByTagNames(注意是复数的names)会获得一些tag的元素,然后按照他们的顺序保存在一个数组中。这非常的有用,比如在上一章的TOCScript中,就需要获得整个文章里面的所有的H3和H4。
我非常希望在node原型中加入这个功能,但是在IE和Safari里面不行。所以只能把他当做一个普通函数。

使用
getElementByTagNames有两个参数:
1、一个用逗号分隔的tag名称字符串。
2、一个可选的开始元素。如果存在则在该元素的子元素中查找这些tag,如果不存在则在整个文档中查找。
这个函数根据要求的tag名称返回一个数组(而不是节点列表),按照他们在源代码中的出现顺序排列。对于这个排序需要浏览器支持sourceIndex或者compareDocumentPosition。如果都不支持(Safari)那么就按照调用getElementByTagNames()函数时候的tag名称的顺序。
实例1

代码如下:

var headerList = getElementsByTagNames('h1,h2,h3,h4');

现在headerList就是文档里包含H1-H4的数组,按照他们出现的顺序排序。
实例2

代码如下:

var element = document.getElementById('test'); 
var formFieldList = getElementsByTagNames('input,select,textarea',element);

现在formFieldList就是包含在ID为test的元素下的所有子元素中的input,select,TEXTAREA的数组,并且按照他们出现的书序排列。

代码如下:

function getElementsByTagNames(list,obj) { 
    if (!obj) var obj = document; 
    var tagNames = list.split(','); 
    var resultArray = new Array(); 
    for (var i=0;i<tagNames.length;i++) { 
        var tags = obj.getElementsByTagName(tagNames[i]); 
        for (var j=0;j<tags.length;j++) { 
            resultArray.push(tags[j]); 
        } 
    } 
    var testNode = resultArray[0]; 
    if (!testNode) return []; 
    if (testNode.sourceIndex) { 
        resultArray.sort(function (a,b) { 
                return a.sourceIndex - b.sourceIndex; 
        }); 
    } 
    else if (testNode.compareDocumentPosition) { 
        resultArray.sort(function (a,b) { 
                return 3 - (a.compareDocumentPosition(b) & 6); 
        }); 
    } 
    return resultArray; 
}

解释

代码如下:

function getElementsByTagNames(list,obj) 
{ 
if (!obj)var obj = document;

首先定义开始元素obj,如果没有给出,那么默认就是document。

代码如下:

var tagNames = list.split(','); 
var resultArray = new Array();

将这些tag名称以逗号分割。用一个数组来保存结果。

代码如下:

for (var i=0;i<tagNames.length;i++) { 
var tags = obj.getElementsByTagName(tagNames[i]); 
for (var j=0;j<tags.length;j++) { 
resultArray.push(tags[j]); 
} 
}

现在我们遍历所有的tag名称,就用最简单的getElementByTagName()方法,然后把结果传入resultArray。这里的一个要点是,因为getElementByTagName返回的是节点列表,所以我就不能使用array.concat()来建立新的数组。把元素一个一个的压入是我能找到的最好的办法。

我们得到了一个所需的tag名称的元素的指针数组存储在resultArray中,但是这些元素还是按照我们所给的tag的顺序排列的。我们需要再排个序。

代码如下:

var testNode = resultArray[0];

现在我们开始排序。我们需要知道浏览器是否支持sourceIndex或者compareDocumentPosition,然后我们对于我们的得到的原始数据做一些检测

代码如下:

if (!testNode) return [];

如果这里没有第一个节点(也就是说结果里并没有我们需要的元素),就返回一个空数组。



背景:array.sort()
array.sort()方法有一个可选函数的参数。这个函数用来比较两个元素(通常称为a和b)。如果第一个应该在前那么这个函数就返回一个负数,如果第二个应该在前那么就返回一个正值。

sourceIndex
如果浏览器支持sourceIndex,我们就根据元素的sourceIndex来排序。sourceIndex是微软的一个非常有用的扩展,可以用来知道元素在源代码中的索引值。页面种的第一个元素(<HTML>)的索引值就是0,第二个(<head>)就是1,等等。sourceIndex也是getElementByTagName(*)中的元素的索引值。

代码如下:

if (testNode.sourceIndex) { 
resultArray.sort(function (a,b) { 
return a.sourceIndex - b.sourceIndex; 
}); 
}

我们用第一个元素的sourceIndex值减去第二个元素的sourceIndex,如果是负值,那么第一个元素就排在前面,如果是正值,那么第二个元素排在前面。这就是sort()需要的。现在resultArray中的元素就是根据他们在文档中的位置来排序的。

compareDocumentPosition
如果浏览器支持compareDocumentPosition,那么就用这个办法来排序。compareDocumentPosition是level3的核心方法,他可以比较两个节点在文档中的位置,然后返回一个值:

1 没有找到

2 在前

4 在后

8 包含

16 被包含

比如,如果一个标签被包含并且在另一个标签的后面,那么就返回16+4=20。

代码如下:

else if (testNode.compareDocumentPosition) { 
resultArray.sort(function (a,b) { 
return 3 - (a.compareDocumentPosition(b) & 6); 
}); 
}

我们只对compareDocumentPosition的值中的2、4感兴趣:在前或者在后。所以我们将结果和6进行与运算,这样结果就会是2或者4(当然结果不能是6,因为一个元素不能即在一个元素之前又在一个元素之后)

如果b在a之后则返回4,但是sort()需要一个负数。如果b在a之前则返回2,但是sort()需要一个正数。为了给sort()一个正确的结果我把他们用3来减。这样就得到1或者-1,这样sort()就能对元素进行正确的排序,resultArray中的元素也按照他们在文档种的出现顺序排列。

代码如下:

return resultArray; 
}

然后我们返回resultArray给调用它的函数。记住如果浏览器不支持sourceIndex或者compareDocumentPosition数组就没有排序。

翻译地址:http://www.quirksmode.org/dom/getElementsByTagNames.html
转载请保留以下信息
作者:北玉(tw:@rehawk)

相关推荐