Element.getElementsByTagName()

在此页

句法
范例
规范
浏览器兼容性
相关话题

Element.getElementsByTagName() method returns a live HTMLCollection of elements with the given tag name . All descendants of the specified element are searched, but not the element itself. The returned list is live , which means it updates itself with the DOM tree automatically. Therefore, there is no need to call Element.getElementsByTagName() with the same element and arguments repeatedly if the DOM changes in between calls.

When called on an HTML element in an HTML document, getElementsByTagName lower-cases the argument before searching for it. This is undesirable when trying to match camel-cased SVG elements (such as <linearGradient> ) in an HTML document. Instead, use Element.getElementsByTagNameNS() , which preserves the capitalization of the tag name.

Element.getElementsByTagName 类似于 Document.getElementsByTagName() , except that it only searches for elements that are descendants of the specified element.

句法

elements = element.getElementsByTagName(tagName)

元素 是 live HTMLCollection of elements with a matching tag name, in the order they appear. If no elements are found, the HTMLCollection is empty.
element is the element from where the search starts. Only the element's descendants are included, not the element itself.
tagName is the qualified name to look for. The special string "*" represents all elements. For compatibility with XHTML, lower-case should be used.

范例

// Check the status of each data cell in a table
const table = document.getElementById('forecast-table');
const cells = table.getElementsByTagName('td');
for (let cell of cells) {
  let status = cell.getAttribute('data-status');
  if (status === 'open') {
    // Grab the data
  }
}

规范

规范	状态	注释
DOM The definition of 'Element.getElementsByTagName()' in that specification.	实时标准	Changed the return value from `NodeList` to `HTMLCollection`
DOM (文档对象模型) 3 级核心规范 The definition of 'Element.getElementsByTagName()' in that specification.	过时	无变化自 DOM (文档对象模型) 级别 2 核心规范
DOM (文档对象模型) 级别 2 核心规范 The definition of 'Element.getElementsByTagName()' in that specification.	过时	无变化自 DOM (文档对象模型) 1 级规范
DOM (文档对象模型) 1 级规范 The definition of 'Element.getElementsByTagName()' in that specification.	过时	初始定义

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`getElementsByTagName`	Chrome 1 1 Initially, this method was returning a `NodeList` ; it was then changed to reflect the spec change.	Edge 12	Firefox 1 1 Prior to Firefox 19, this method was returning a `NodeList` ; it was then changed to reflect the change in the spec.	IE 5.5	Opera 8 8 Initially, this method was returning a `NodeList` ; it was then changed to reflect the spec change.	Safari 6 6 Initially, this method was returning a `NodeList` ; it was then changed to reflect the spec change.	WebView Android 1 1 Initially, this method was returning a `NodeList` ; it was then changed to reflect the spec change.	Chrome Android 18 18 Initially, this method was returning a `NodeList` ; it was then changed to reflect the spec change.	Firefox Android 4 4 Prior to Firefox 19, this method was returning a `NodeList` ; it was then changed to reflect the change in the spec.	Opera Android 10.1	Safari iOS 6 6 Initially, this method was returning a `NodeList` ; it was then changed to reflect the spec change.	Samsung Internet Android 1.0 1.0 Initially, this method was returning a `NodeList` ; it was then changed to reflect the spec change.
getElementsByTagName(*)	Chrome 1	Edge 12	Firefox Yes	IE 6	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android Yes Yes Prior to Firefox 19, this method was returning a `NodeList` ; it was then changed to reflect the change in the spec.	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes

图例

完整支持

元数据

最后修改： Mar 18, 2019

在此页

句法

范例

规范

浏览器兼容性

图例

相关话题