.getElementsByName()
(X)HTMLドキュメント内から、指定されたname属性を持つ要素のリストを返します。
文法
elements = document.getElementsByName(name);
| 引数 | 説明 |
|---|---|
| name | 要素のname属性の値を指定します。 |
| 戻り値 | |
| elements | 要素のHTMLCollectionが返ります。 |
例
<!DOCTYPE html>
<html lang="en">
<head>
...
</head>
<body>
<form name="up"><input type="text"></form>
<form name="down"><input type="text"></form>
<script>
var up_forms = document.getElementsByName("up");
alert(up_forms[0].tagName); //"FORM"を出力
</script>
</body>
</html>
注意事項
name属性は、(X)HTMLドキュメントでのみ適用可能です。
このメソッドは、<meta>、<object>のような、name属性をサポートしない要素であっても、
name属性が指定されている要素であれば、それを全て返します。
document.getElementsByName()は、
指定された値をname属性に持つ全ての要素のHTMLCollectionを返します。
仕様
© 2017 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
このページは、ページトップのURL先のMozilla Developer Network(以下、MDN)のコンテンツを翻訳した内容を基に構成されています。 構成について異なる点も含まれますので、下記の項目を確認し、必要に応じて元のコンテンツをご確認ください。 もし、誤訳などの間違いを見つけましたら、 @tomofまで教えていただければ幸いです。
- 特定のブラウザに特化しすぎている情報やあまりにも古い情報、 または試験的に導入されているようなAPIや機能については、省略していることがあります。
- 例やデモについて、実際にページ内で動作させる関係で一部ソースコードを変更している場合や、 その例で使用しているコンテンツの単語や文章などを日本人向けに変更しいてる場合があります。
- MDNの更新頻度が高いため、元のコンテンツと比べ情報が古くなっている可能性があります。
- "訳注:"などの断わりを入れた上で、日本人向けの情報の追記を行っている事があります。