Document: getElementsByName() メソッド
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2018年1月.
getElementsByName() は Document オブジェクトのメソッドで、文書内で指定した name を持つ要素の NodeList コレクションを返します。
構文
js
getElementsByName(name) 引数
name-
探している要素の
name属性の値です。
返値
生きた NodeList コレクション、つまり文書内で同じ name を持った新しい要素が追加されたり削除されたりすると自動的に更新されるものです。
例
html
<!doctype html> <html lang="ja"> <head> <title>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); // "INPUT" と表示 メモ
name 属性は、(X)HTML 文書にのみ適用可能です。
返却された NodeList コレクションには、 <meta> や <object> など、それに name 属性にまったく対応していない要素も含め、指定された name を持つすべての要素が含まれます。
仕様書
| Specification |
|---|
| HTML # dom-document-getelementsbyname-dev |
ブラウザーの互換性
Loading…
関連情報
document.getElementById(): 固有のidを持つ要素への参照を返すdocument.getElementsByTagName(): 同じタグ名の要素への参照を返すdocument.querySelector():'div.myclass'のような CSS セレクターによって要素への参照を返す