files/ja/web/api/nodelist/length/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

---
title: NodeList.length
slug: Web/API/NodeList/length
tags:
  - API
  - DOM
  - Gecko
  - プロパティ
  - リファレンス
translation_of: Web/API/NodeList/length
---
<div>{{APIRef("DOM")}}</div>

<h2 id="Summary" name="Summary">概要</h2>

<p><code>length</code> は <code>NodeList</code> 内の item の数を返します。</p>

<h2 id="Syntax" name="Syntax">構文</h2>

<pre class="brush: js"><em>numItems</em> = <em>nodeList</em>.length
</pre>

<ul>
 <li><code>numItems</code> は <code>NodeList</code> 内の item 数に相当する整数値 (integer) です。</li>
</ul>

<h2 id="Example" name="Example">例</h2>

<pre class="brush: js">// 文書内のすべての段落
var items = document.getElementsByTagName("p");
// リスト中のすべてのアイテムに対して実行し、
// HTML の文字列として要素全体を追加
var gross = "";
for (var i = 0; i &lt; items.length; i++) {
  gross += items[i].innerHTML;
}
// gross には HTML のすべての段落が入ります
</pre>

<h2 id="Notes" name="Notes">メモ</h2>

<p>参照内のこのページの場所に関わらず、 <code>length</code> は <a href="/ja/docs/Web/API/element">Element</a> ではなく、 <code>NodeList</code> のプロパティです。 NodeList オブジェクトは <a href="/ja/docs/Web/API/document/getElementsByTagName">document.getElementsByTagName</a> を始めとして、いくつもの DOM メソッドから返されます。</p>

<p><code>length</code> は DOM プログラミングでとても有名なプロパティです。リストの長さを検査したり (存在するかどうかを確認)、上記の例に見られるように、ループの反復子して使用するのが普通です。</p>

<h2 id="Specification" name="Specification">仕様書</h2>

<p><a class="external" href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-203510337">length</a></p>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2>

<p class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力したいのであれば、 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</p>

<p>{{Compat("api.NodeList.length")}}</p>