From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../web/api/document/getelementsbyname/index.html | 99 ++++++++++++++++++++++ 1 file changed, 99 insertions(+) create mode 100644 files/ja/web/api/document/getelementsbyname/index.html (limited to 'files/ja/web/api/document/getelementsbyname') diff --git a/files/ja/web/api/document/getelementsbyname/index.html b/files/ja/web/api/document/getelementsbyname/index.html new file mode 100644 index 0000000000..69a10b1b88 --- /dev/null +++ b/files/ja/web/api/document/getelementsbyname/index.html @@ -0,0 +1,99 @@ +--- +title: Document.getElementsByName() +slug: Web/API/Document/getElementsByName +tags: + - API + - DOM + - Document + - HTML + - Method + - Reference + - getElementByName + - メソッド +translation_of: Web/API/Document/getElementsByName +--- +
{{APIRef("DOM")}}
+ +

{{domxref("Document")}} オブジェクトの getElementsByName() メソッドは、文書内で指定した {{domxref("element.name","name")}} を持つ要素の {{domxref("NodeList")}} コレクションを返します。

+ +

構文

+ +
var elements = document.getElementsByName(name);
+
+ + + +

+ +
<!DOCTYPE html>
+<html lang="en">
+<title>document.getElementsByName の使用例</title>
+
+<input type="hidden" name="up">
+<input type="hidden" name="down">
+
+<script>
+  var up_names = document.getElementsByName("up");
+  console.log(up_names[0].tagName); // "INPUT" と表示
+</script>
+</html>
+
+ +

メモ

+ +

{{domxref("element.name","name")}} 属性は、(X)HTML 文書にのみ適用可能です。

+ +

返却された {{domxref("NodeList")}} コレクションには、 {{htmlelement("meta")}} や {{htmlelement("object")}} など、それに name 属性にまったく対応していない要素も含め、指定された name を持つすべての要素が含まれます。

+ +
+

getElementsByName メソッドは、 IE10 以前では動作が異なります。この場合、 getElementsByName() は指定された id 属性を持つ要素も返します。 name および id で同じ文字列を使用しないように注意してください。

+
+ +
+

getElementsByName メソッドは IE では動作が異なります。この場合、 getElementsByName()name 属性を許容しない要素 (<span> など) を返しません。

+
+ +
+

IE および Edge では、 {{domxref("NodeList")}} ではなく {{domxref("HTMLCollection")}} を返します。

+
+ +

仕様書

+ + + + + + + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('HTML WHATWG', '#dom-document-getelementsbyname', "Document.getElementsByName()")}}{{ Spec2('HTML WHATWG') }} 
{{SpecName("DOM2 HTML", "html.html#ID-71555259", "Document.getElementsByName()")}}{{Spec2("DOM2 HTML")}}初回定義
+ +

ブラウザーの対応

+ + + +

{{Compat("api.Document.getElementsByName")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf