$(Element).getElementsByAttribute(attrName,attrValue)

查找指定属性值的元素。

参数

Element

必选项。页面元素ID(字符串型)或者是文档节点(对象)。

attrName

必选项。元素的属性名，字符型。

attrValue

必选项。元素的属性值，类型不限。

返回值

所有属性值符合条件的元素数组。

描述

在Element节点下查找带有指定属性名与属性值的元素，Element可以是当前文档 document。该方法是利用 getElementsByTagName("*") 实现的，由于 * 通配符匹配范围比较大，在循环中尽量避免使用此方法。

示例

<div id="box">
   <h1 customAttr="title">标题</h1>
   <ul>
       <li>文字</li>
       <li customAttr="title">张三</li>
       <li customAttr="title">李四</li>
   </ul>
</div>
<input type="button" value="获取customAttr" onclick="alert( $('box').getElementsByAttribute('customAttr','title').length )" /> // 3 (标题、张三、李四)