検索: getElement* と querySelector*

要素が互いに近いとき、DOM ナビゲーションプロパティは優れています。仮にそうではなければどうしますか？ページの任意のページはどうすれば取得できるでしょうか？

そのための追加の検索メソッドがあります。

document.getElementById もしくは単に id

もし要素が id 属性を持っている場合、その id の名前のグローバル変数があります。

次にように、その要素にアクセスするためにそれを使うことができます。:

<div id="elem">
  <div id="elem-content">Element</div>
</div>

<script>
  alert(elem); // DOM-element with id="elem"
  alert(window.elem); // このようなグローバル変数へのアクセスもできます

  // elem-content の場合は少し複雑です
  // ダッシュを含んでいるため、変数名になれません
  alert(window['elem-content']); // ...しかし、角括弧 [...] を使うことでアクセス可能です
</script>

同じ名前の変数を私達自身で宣言しない限り、アクセスできます:

<div id="elem"></div>

<script>
  let elem = 5;

  alert(elem); // 変数は要素を上書きします
</script>

この振る舞いは仕様書で説明されていますが、主に互換性のためにサポートされています。ブラウザは JS と DOM の名前空間を混在させることで私達を助けようとします。非常にシンプルなスクリプトに対しては適していますが、名前の衝突が起きる可能性があります。また、JS を見て、ビューの中のHTMLを見なかった場合、変数がどこから来たのかが明白ではありません。

より良い代替の方法は特別なメソッド document.getElementById(id) を使うことです。

例:

<div id="elem">
  <div id="elem-content">Element</div>
</div>

<script>
  let elem = document.getElementById('elem');

  elem.style.background = 'red';
</script>

このチュートリアルでは、要素を直接参照するために id を頻繁に使います。が、それは物事を短く保つためだけです。実際には、document.getElementById が好ましい方法です。

id は一意でなければなりません。与えられた id の要素はドキュメント上で1つだけ存在することができます。

もし同じ id を持つ複数の要素がある場合、対応するメソッドの振る舞いは予測できないものになります。ブラウザはランダムにそれらのうちの1つを返すかもしれません。なので、ルールを心にとめ、id を一意に保ってください。

document オブジェクトに対してのみ呼び出すことができるメソッド getElementById です。これはドキュメント全体から指定された id を探します。

getElementsBy*

ノードを探す他のメソッドもあります:

elem.getElementsByTagName(tag) は指定されたタグの要素を探し、そのコレクションを返します。tag パラメータは “任意のタグ” としてアスタリスク "*" にできます。

例:

          // ドキュメント上のすべての div を取得
let divs = document.getElementsByTagName('div');
        

このメソッドは任意の DOM 要素のコンテキストで呼び出し可能です。

テーブルの中のすべての input を見つけましょう:

<table id="table">
  <tr>
    <td>Your age:</td>

    <td>
      <label>
        <input type="radio" name="age" value="young" checked> less than 18
      </label>
      <label>
        <input type="radio" name="age" value="mature"> from 18 to 50
      </label>
      <label>
        <input type="radio" name="age" value="senior"> more than 60
      </label>
    </td>
  </tr>
</table>

<script>
  let inputs = table.getElementsByTagName('input');

  for (let input of inputs) {
    alert( input.value + ': ' + input.checked );
  }
</script>

初心者の開発者は文字 "s" を忘れることがあります。つまり、getElementsByTagName の代わりに getElementByTagName を呼び出そうとします。

"s" 文字は getElementById にはありません。これは、単一の要素を返すためです。しかし、getElementsByTagName は要素の集合を返します。したがって "s" がつきます。

別に広く知られている初心者の間違いはこのように書くことです:

          // 動作しません
document.getElementsByTagName('input').value = 5;
        

これは動作しません。なぜならそれは入力のコレクションを取り、その中の要素ではなくコレクションに値を代入するためです。

コレクションを反復するか、数値で要素を取得するかを行い、それから代入する必要があります。:

          // 動作します(input がある場合)
document.getElementsByTagName('input')[0].value = 5;
        

この種類のほとんど使われないメソッドもあります:

elem.getElementsByClassName(className) は指定された CSS クラスを持つ要素を返します。要素は他のクラスも持っている可能性があります。
document.getElementsByName(name) は指定された name 属性を持つ要素をドキュメント全体で返します。歴史的な理由から存在しますが、極稀にしか使われません。ここでは、完全性のためだけに言及します。

例:

<form name="my-form">
  <div class="article">Article</div>
  <div class="long article">Long article</div>
</form>

<script>
  // name 属性で見つける
  let form = document.getElementsByName('my-form')[0];

  // form の内側で　class で見つける
  let articles = form.getElementsByClassName('article');
  alert(articles.length); // 2, class "article" を持つ要素が2つ見つかります。
</script>

querySelectorAll

今度は重い大砲に進みます。

elem.querySelectorAll(css) の呼び出しは、指定された CSS セレクタにマッチする elem 内のすべての要素を返します。これは最もよく使われ、強力なメソッドです。

ここでは最後の子要素であるすべての <li> 要素を探します:

<ul>
  <li>The</li>
  <li>test</li>
</ul>
<ul>
  <li>has</li>
  <li>passed</li>
</ul>
<script>
  let elements = document.querySelectorAll('ul > li:last-child');

  for (let elem of elements) {
    alert(elem.innerHTML); // "test", "passed"
  }
</script>

任意の CSS セレクタを使うことができるので、このメソッドは確かに強力です。

:hover や :active のような CSS セレクタの擬似クラスもサポートされています。例えば、document.querySelectorAll(':hover') はポインタが現在の要素を含むコレクションを返します（入れ子の順序で: 最も外側の <html>から最もネストされたものまで）。

querySelector

elem.querySelector(css) への呼び出しは指定された CSS セレクタの最初の要素を返します。

つまり、elem.querySelectorAll(css)[0] と同じ結果になりますが、後者は すべての 要素を探し1つをピックアップする一方、elem.querySelector は単に1つだけを探します。なので、書くのがより速く短いです。

matches

以前のメソッドは DOM を検索していました。

elem.matches(css) は何も探しません。それは単に elem が与えられた CSS セレクタに一致するかをチェックします。それは true または false を返します。

このメソッドは、要素(配列か何か)を反復処理し、私たちが興味のあるものをフィルタリングしようとするときに便利です。

例えば:

<a href="http://example.com/file.zip">...</a>
<a href="http://ya.ru">...</a>

<script>
  // document.body.children の代わりに任意のコレクションが可能です
  for (let elem of document.body.children) {
    if (elem.matches('a[href$="zip"]')) {
      alert("The archive reference: " + elem.href );
    }
  }
</script>

closest

与えられた要素の直接上にあるすべての要素は、祖先と呼ばれます。

言い換えると、祖先は: 親、親の親、その親などです。祖先は共に要素から頂点までの親の連鎖を形成します。

メソッド elem.closest(css) は CSS セレクタにマッチする最も近い祖先を見ます。elem 自身も検索に含まれています。

つまり、メソッド closest は要素から上に進み、各親をチェックします。もしセレクタにマッチしたら、検索を止め、その祖先が返却されます。

例:

<h1>Contents</h1>

<div class="contents">
  <ul class="book">
    <li class="chapter">Chapter 1</li>
    <li class="chapter">Chapter 1</li>
  </ul>
</div>

<script>
  let chapter = document.querySelector('.chapter'); // LI

  alert(chapter.closest('.book')); // UL
  alert(chapter.closest('.contents')); // DIV

  alert(chapter.closest('h1')); // null (h1 は祖先ではないので)
</script>

Live collections

すべての "getElementsBy*" メソッドは ライブの コレクションを返します。このようなコレクションは常にドキュメントの現在の状態を反映し、変更があったとき “自動更新” されます。

下の例では、2つのスクリプトがあります。

最初のスクリプトは <div> のコレクションへの参照を生成します。今のところ、その長さは 1 です。
2つ目のスクリプトはブラウザが1つ以上の <div> に会った後に実行するので、その長さは 2 です。

<div>First div</div>

<script>
  let divs = document.getElementsByTagName('div');
  alert(divs.length); // 1
</script>

<div>Second div</div>

<script>
  alert(divs.length); // 2
</script>

対象的に、querySelectorAll は 静的な コレクションです。これは固定要素配列です。

我々が代わりにこれを使った場合、両方のスクリプトは 1 を出力します:

<div>First div</div>

<script>
  let divs = document.querySelectorAll('div');
  alert(divs.length); // 1
</script>

<div>Second div</div>

<script>
  alert(divs.length); // 1
</script>

今その違いを簡単に見ることができます。静的なコレクションは、ドキュメント上に新たな div の登場の後も増加しませんでした。

ここでは要素の追加がコレクションにどう影響するかを示すために別々のスクリプトを使いましたが、任意の DOM 操作がそれらに影響します。すぐ後にそれらについてより見ていきます。

サマリ

DOM でノードを検索するための6つの主なメソッドがあります:

メソッド	何で検索するか	要素上で呼ぶことが可能?	ライブ?
`getElementById`	`id`	-	-
`getElementsByName`	`name`	-	✔
`getElementsByTagName`	タグまたは `'*'`	✔	✔
`getElementsByClassName`	class	✔	✔
`querySelector`	CSSセレクタ	✔	-
`querySelectorAll`	CSSセレクタ	✔	-

メソッド getElementById と getElementsByName はドキュメントのコンテキストの場合にだけ呼び出すことができることに注意してください: document.getElementById(...)。要素上ではできません: elem.getElementById(...) はエラーになります。

他のメソッドは、要素上でも呼び出し可能です。例えば、 elem.querySelectorAll(...) elem の内側を検索します(DOM サブツリーの中)。

それ以外に:

elem が指定された CSS セレクタに一致するかをチェックする elem.matches(css) があります。
指定された CSS セレクタに一致する最も近い祖先を探すための elem.closest(css) があります。elem 自身もまたチェックされます。

また、親子の関係を調べるもう一つの方法をここで言及しましょう:

elemA.contains(elemB) は elemB が elemA の中にある(elemA の子孫)または elemA==elemB の場合 true を返します。

タスク

要素を検索する

ここに、テーブルとフォームを持つドキュメントがあります。

どうやって見つけますか?

id="age-table" を持つテーブル.
テーブル内のすべての label 要素(3つ存在するはずです)
そのテーブル内の最初の td (“Age” という言葉を持つ)
名前が search の form
そのフォーム内の最初の input
そのフォーム内の最後の input

別のウィンドウでtable.htmlを開き、ブラウザツールを使ってください。

多くの方法があります。

これはそのいくつかです。:

          // 1. id="age-table" を持つテーブル
let table = document.getElementById('age-table')

// 2. テーブル内のすべての label 要素
table.getElementsByTagName('label')
// or
document.querySelectorAll('#age-table label')

// 3. そのテーブル内の最初の td (“Age” という言葉を持つ).
table.rows[0].cells[0]
// or
table.getElementsByTagName('td')[0]
// or
table.querySelector('td')

// 4. 名前が search の form.
// name="search" を持つ要素が1つと想定しています
let form = document.getElementsByName('search')[0]
// or, form をつけ具体的に
document.querySelector('form[name="search"]')

// 5. フォーム内の最初の input
form.getElementsByTagName('input')
// or
form.querySelector('input')

// 6. フォーム内の最後の input
// それ用の直接のクエリはありません
let inputs = form.querySelectorAll('input') // 全検索
inputs[inputs.length-1] // 最後を取る
        

子孫を数える

ネストされた ul/li として構造化されたツリーがあります。

それぞれの <li> に対し、次のものを表示するコードを書いてください:

その中のテキストが何か(サブツリーなし)
ネストされた <li> の数 – 深くネストされたものも含むすべての子孫

新しいウィンドウでデモ

タスクのためのサンドボックスを開く

<li> のループを作りましょう:

          for (let li of document.querySelector('li')) {
  ...
}
        

このループでは、各 li の中のテキストを取得する必要があります。最初の子ノードから直接それを読むことができ、それはテキストノードです。

          for (let li of document.querySelector('li')) {
  let title = li.firstChild.data;

  // titleは他のノードの前の <li> のテキストです
}
        

そして、子孫の数は li.getElementsByTagName('li') で取得できます。

サンドボックスで解答を開く

チュートリアルマップ

コメントをする前に読んでください…