document.getElementsByName

概要

指定した name 属性値を持つ (X)HTML 文書内の要素のリストを返します。

構文

elements = document.getElementsByName(name) 
  • elements : 要素の HTMLCollection
  • name : 要素の name 属性の値

<!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");
w(up_forms[0].tagName); // returns "FORM"
</script>
</body>
</html>

注記

name 属性は (X)HTML 文書にのみ適用可能です。 このメソッドは<meta><object>といったname属性をもつ全ての要素を対象としますが、仕様上name属性を全くサポートしていない要素であっても、nameが付与されていれば結果に含めて返されます。

document.getElementsByName() は、指定された値をname属性に持つ全ての要素からなるHTMLCollectionを返します。

仕様書

Document Tags and Contributors

Contributors to this page: ethertank, Hfjapancom, Marsf, s_fujimoto, Mgjbot
最終更新者: s_fujimoto,