備忘録的プログラミングリファレンス

getElementsByTagName() メソッド

document.getElementsByTagName()
Element.getElementsByTagName()

 getElementsByTagName() メソッドは、引数で指定されたタグ名の Element の配列を取得する Document インターフェイスElement インターフェイスのメソッドです。

 返り値は、該当する全てのエレメントをリスト HTMLCollection オブジェクトで返します。そのため、getElementsByTagName() と複数指定です。

getElementsByTagName() メソッド
var elements_ = document.getElementsByTagName("p");
console.log( elements_ );

 getElementsByTagName() メソッドで取得した Element の配列から個々のエレメントを取得する方法は、インデックスから取得するか、name または id 属性から取得する、for 関数で該当するエレメントを取得するがあります。

getElementsByTagName()メソッド インデックスから取得する
var elements_ = document.getElementsByTagName("p");
console.log( elements_[0] );
getElementsByTagName()メソッド name または id 属性から取得する
var elements_ = document.getElementsByTagName("p");
console.log( elements_.namedItem('example') );
getElementsByTagName()メソッド for 関数で取得する
var elements_ = document.getElementsByTagName("p");
for (let i = 0; i < elements_.length; i++){
		console.log( elements_[i] );
}

 name または id 属性から取得する方法は、該当する最初のエレメントを返します。

 セレクターでインスタンスを取得するには querySelector() メソッドが利用できます。

Document と Element の違い

 Document.getElementsByTagName() の場合は、webページを構成するエレメントの中で該当する タグ 名をもつエレメントの配列を返します。

 Element.getElementsByTagName() の場合では、その包括するエレメント内から該当する タグ 名をもつエレメントの配列を返します。

- ad -

Document.getElementsByTagName() メソッド

document.getElementsByTagName()

 Document.getElementsByTagName() メソッドは、Document オブジェクト以下の該当するタグエレメント名をもつ Element オブジェクトの配列を取得するメソッドです。

 返り値は、HTMLElement オブジェクトのリストである HTMLCollection オブジェクトです。

Document以下の該当するタグ名のエレメントのリストを取得
var elements_ = document.getElementsByTagName("p");

詳しくは Example を参照してください

 Document.getElementsByTagName() の場合は、webページを構成するエレメントの中で該当する タグ 名をもつエレメントの配列を返します。

 セレクターでインスタンスを取得するには querySelector()メソッドが利用できます。

Syntax

Example Syntax

返り値はHTMLCollection、Elementインスタンスの配列です。

HTMLCollection = Document.getElementsByTagName("p");

引数(Parameter Values)

Value摘要
name大文字と小文字を区別します

返り値(Return Values)

Type摘要
HTMLCollectionElementの配列

Example

- ad -

Element.getElementsByTagName() メソッド

Element.getElementsByTagName()

 Element.getElementsByTagName() メソッドは、該当するタグエレメント名をもつ Element オブジェクトの配列を取得するメソッドです。 指定されたElement オブジェクト以下の子孫エレメントが対象です。

 返り値は、HTMLElement オブジェクトのリストである HTMLCollection オブジェクトです。

getElementsByTagName()メソッド例
var elements_ = element.getElementsByTagName("p");

詳しくは Example を参照してください

 Element.getElementsByTagName() の場合では、その包括するエレメント内から該当する タグ 名をもつエレメントの配列を返します。

 セレクターでインスタンスを取得するには querySelector()メソッドが利用できます。

Syntax

Example Syntax

返り値はHTMLCollection、Elementインスタンスの配列です。

HTMLCollection = Element.getElementsByTagName("name");

引数(Parameter Values)

Value摘要
name大文字と小文字を区別します

返り値(Return Values)

Type摘要
HTMLCollectionElementの配列

Example

- ad -

関連メソッド

 似た機能をもつメソッドに以下があります。

getElementsByClassName()
クラス名が引数。Documentインターフェイス、Elementインターフェイスのメソッド。
getElementById()
id値が引数。Documentインターフェイスのメソッド。
getElementsByName()
name値が引数。Documentインターフェイス、Elementインターフェイスのメソッド。
getElementsByTagName()
エレメント名が引数。Documentインターフェイス、Elementインターフェイスのメソッド。
getElementsByTagNameNS()
エレメント名と名前空間が引数。Documentインターフェイス、Elementインターフェイスのメソッド。
querySelector()
セレクターを引数にして該当するエレメントを取得。Documentインターフェイスのメソッド。
querySelectorAll()
セレクターを引数にして該当するエレメントのリストを取得。Documentインターフェイス、Elementインターフェイスのメソッド。

- ad -