文件:getElementsByName() 方法

Baseline 已廣泛支援

此功能已非常成熟,可在許多裝置和瀏覽器版本上執行。自 2018 年 1 月起,它已在所有瀏覽器中可用。

getElementsByName() 方法是 Document 物件的一個方法,它返回一個 NodeList 集合,包含文件中具有給定 name 屬性的元素。

語法

js
getElementsByName(name)

引數

name

我們要查詢的元素(或元素集)的 name 屬性的值。

返回值

一個即時的 NodeList 集合,這意味著當具有相同 name 的新元素被新增到文件或從文件中移除時,它會自動更新。

示例

html
<!doctype html>
<html lang="en">
  <head>
    <title>Example: using document.getElementsByName</title>
  </head>
  <body>
    <input type="hidden" name="up" />
    <input type="hidden" name="down" />
  </body>
</html>
js
const up_names = document.getElementsByName("up");
console.log(up_names[0].tagName); // displays "INPUT"

注意

name 屬性只能在 (X)HTML 文件中使用。

返回的 NodeList 集合包含具有給定 name所有元素,例如 <meta><object>,甚至那些根本不支援 name 屬性的元素。

規範

規範
HTML
# dom-document-getelementsbyname-dev

瀏覽器相容性

另見