DOM の紹介
=======

**ドキュメントオブジェクトモデル** (Document Object Model, *DOM*) は、ウェブ上の文書のコンテンツと構造からなるオブジェクトのデータ表現です。このガイドでは、簡単に DOM を紹介します。 DOM がどのようにメモリー内で HTML 文書を表現するか、どのように API を使用してウェブコンテンツやアプリケーションを作成するのかを見てみます。

DOM とは
------

ドキュメントオブジェクトモデル (DOM) はウェブ文書のためのプログラミングインターフェイスです。ページを表現するため、プログラムが文書構造、スタイル、内容を変更することができます。 DOM は文書をノードとオブジェクトで表現します。そうやって、プログラミング言語をページに接続することができます。

ウェブページは、ブラウザーのウィンドウに表示したり、 HTML ソースとして表示したりすることが可能な文書です。どちらの場合も同じ文書であり、ドキュメントオブジェクトモデル (DOM) で操作することができます。 DOM はウェブページの完全なオブジェクト指向の表現で、 JavaScript のようなスクリプト言語から変更することができます。

例えば、 DOM はこのコードスニペット内にある `querySelectorAll` メソッドが、文書内にあるすべての `<p>` 要素のリストを返さなければならないと定義しています。


```js
const paragraphs = document.querySelectorAll("p");
// paragraphs[0] は最初の <p> 要素
// paragraphs[1] は 2 番目の <p> 要素、など
alert(paragraphs[0].nodeName);
```


ウェブページを操作したり、作成したりするために用意されているすべてのプロパティ、メソッド、イベントは、オブジェクトにまとめられています。例えば、文書自身を表現する `document` オブジェクトや、 HTML のテーブルにアクセスするための特別な `HTMLTableElement` DOM インターフェイスを実装した `table` オブジェクト、などがあります。

 現在の DOM は協調して動作する複数 API によって構築されています。
 コア DOM は、文書やその中のオブジェクトを基礎的に記述するオブジェクトを定義しています。
 これは必要に応じて DOM に新しい機能や能力を追加する他の API によって拡張されます。
 例えば、 HTML DOM API (en-US) はコア DOM に HTML 文書の表現の対応を、 SVG API は SVG 文書の表現の対応を追加しています。

DOM と JavaScript
----------------

ほぼすべての例と同様に、上の短い例は JavaScript です。つまり、 JavaScript で*書かれて*いますが、しかし DOM を*使用*してウェブページとその要素にアクセスしています。 DOM はプログラミング言語ではありませんが、これがないと、 JavaScript 言語はウェブページ、 HTML 文書、 SVG 文書、およびその構成部品のモデルや記法を持っていません。文書内のすべての要素 — 全体としての文書、 head、文書内の表、表の見出し、表のセル内のテキスト — は、その文書のドキュメントオブジェクトモデルの一部ですので、 DOM と JavaScript のようなスクリプト言語を通してそれらすべてにアクセスし、操作することができます。

 DOM は JavaScript 言語の一部ではなく、ウェブサイトを構築するために使用される Web API の 1 つです。
 JavaScript は他のコンテキストで使われることもあります。
 例えば、 Node.js はコンピュータ上で JavaScript プログラムを実行しますが、異なる API のセットを提供しており、 DOM API は Node.js ランタイムのコア部分にはなりません。

 DOM は、特定のプログラミング言語から独立し、文書の構造表現を単一の一貫した API から利用できるように設計されています。
 ほとんどのウェブ開発者が JavaScript でしか DOM を使用しないとしても、この Python の例が示すように、 DOM の実装はどの言語でも構築することができます。


```python
# Python DOM example
import xml.dom.minidom as m
doc = m.parse(r"C:\Projects\Py\chap1.xml")
doc.nodeName # DOM property of document object
p_list = doc.getElementsByTagName("para")
```


ウェブで JavaScript を書くためにどのような技術が使われるのかについての詳細は、 JavaScript 技術概要をご覧ください。

DOM へのアクセス
----------

 DOM を使い始めるのに、特別なものは必要ありません。
 ブラウザーで実行されるプログラムである*スクリプト*と呼ばれるものの中から、 JavaScript で直接 API を使用するのです。

スクリプトを作成すると、インラインの `<script>` 要素であろうと、ウェブページに含まれていようと、すぐに `document` や `window` オブジェクトの API を使って、文書自体やウェブページ内の様々な要素（文書の子孫要素）を操作し始めることができるようになるのです。 DOM プログラミングは、次の例のように、 `console.log()` 関数を使ってコンソールにメッセージを表示させるような簡単なものであってもかまいません。


```html
<body onload="console.log('ホームページへようこそ!');">
  …
</body>
```


一般に、ページの構造（HTML で記述）と DOM の操作（JavaScript で記述）を混在させることは推奨されないため、ここでは JavaScript 部分をまとめ、 HTML とは切り離して記述することにします。

例えば、次の関数は、新しい h1 要素を生成し、その要素にテキストを追加し、文書ツリーに追加します。


```html
<html lang="en">
  <head>
    <script>
 // この関数は文書が読み込まれた時に実行される
 window.onload = () => {
 // create a couple of elements in an otherwise empty HTML page
 const heading = document.createElement("h1");
 const headingText = document.createTextNode("Big Head!");
 heading.appendChild(headingText);
 document.body.appendChild(heading);
 };
 </script>
  </head>
  <body></body>
</html>
```

基本的なデータ型
--------

このページでは、様々なオブジェクトと型をなるべく簡単な方法で説明します。しかし、API に渡される、注意しなければならないデータ型はたくさんあります。

**メモ:** DOM を使用するコードの大部分は HTML 文書の操作を中心としているため、DOM 内のノードを**要素**と呼ぶのが一般的ですが、厳密にはすべてのノードが要素というわけではありません。

以下の表はこれらのデータの種類を簡単に説明しています。

| データ型 (インターフェイス) | 説明 |
| --- | --- |
| `Document` | メンバーが `document` 型のオブジェクトを返すときは（例えば、要素の `ownerDocument` 属性はそれが属する `document` を返します）、このオブジェクトはルートの `document` 要素自身になります。 DOM `document` リファレンスの章では `document` オブジェクトを説明しています。 |
| `Node` | 文書内にあるすべてのオブジェクトは何らかの種類のノードです。 HTML 文書では、オブジェクトは要素ノードだけでなく、テキストノードや属性ノードもあります。 |
| `Element` | `element` 型は `node` に基づいています。これは要素、すなわち DOM API のメンバーから返される `element` 型のノードを表します。例えば `document.createElement()` メソッドは `node` へのオブジェクト参照を返すというより、このメソッドは単に DOM によって生成された `element` を返すと言えます。
 `element` オブジェクトは DOM の `Element` インターフェイスと、もっと基本的な `Node` インターフェイスも実装しており、両方がこの参照に含まれます。 HTML 文書では、要素はさらに HTML DOM API の `HTMLElement` インターフェイスや、特定の種類の要素における能力を記述するためのその他のインターフェイス（例えば `<table>` 要素における `HTMLTableElement`）によって更に拡張されています。
  |
| `NodeList` | `nodeList` は要素の配列で、例えば `document.querySelectorAll()` で返されるものなどです。 `nodeList` の中の項目は、添字を使って以下の 2 通りの方法で取得できます。
 * list.item(1)
* list[1]

この二つの方法は等価です。最初の方法では、 `item()` は `nodeList` オブジェクトの一つの関数です。後者の方は、一般的な配列の構文を使い、リスト中の二つ目の項目を取得しています。
  |
| `Attr` | `attribute` が（`createAttribute()` メソッドなどの）メンバーから返されたとき、属性のための特別な（ただし、小さな）インターフェイスを実装したオブジェクトの参照です。属性は要素のような DOM のノードですが、さほど使われません。 |
| `NamedNodeMap` | `namedNodeMap` は配列のようですが、名前または添字によって項目にアクセスできますが、後者は項目がリスト中に特定の順番で並んでいる訳ではないので、列挙するのに便利であるだけです。このために `namedNodeMap` には `item()` メソッドがあり、 `namedNodeMap` に項目を追加したり、削除したりすることができます。 |

注意すべき用語の使い方がいくつかあります。例えば、ある `Attr` ノードを参照するのに単に `attribute` と呼んだり、 DOM ノードの配列を参照するのに `nodeList` と呼んだりします。このような用語は文書を通して紹介され使用されているのが分かるでしょう。

DOM インタフェース
-----------

このガイドは、 DOM 階層構造を操作するために利用できるオブジェクトと、実際の*もの*について触れます。どのように動作するかを理解する上で、混乱を催すかもしれない点がたくさんあります。例えば、 HTML の `form` 要素を表すオブジェクトには、 `name` プロパティが `HTMLFormElement` インターフェイスにある一方、 `className` プロパティが `HTMLElement` インターフェイスにあります。どちらにしても、求めるプロパティはその form オブジェクトの中にあります。

しかし、 DOM で実装されているオブジェクトとインターフェイスの関係は複雑なので、この節では、 DOM の仕様での実際のインターフェイスとそれがどのように利用できるかについて少し説明しようと思います。

### インターフェイスとオブジェクト

多くのオブジェクトは複数のインターフェイスを継承しています。例えば、 table オブジェクトでは、特別な `HTMLTableElement` インターフェイスを実装しており、そのインターフェイスは `createCaption` や `insertRow` などのメソッドを含んでいます。しかし、 `table` は HTML の要素でもあるので、 DOM の `Element` リファレンスの章で説明している `Element` インターフェイスも実装しています。さらには、 HTML の要素は、 DOM を考慮する限り、ウェブページや XML ページのオブジェクトモデルを作りあげるノードのツリー内にあるノードもであるので、 table オブジェクトはより基本的な `Node` インターフェイスを、 `Element` から継承して実装しています。

次の例のように、 `table` オブジェクトの参照を入手したときは、おそらく無意識に、このオブジェクトの三つのインターフェイスをごく普通に交互に使います。


```js
const table = document.getElementById("table");
const tableAttrs = table.attributes; // Node/Element インターフェイス
for (let i = 0; i < tableAttrs.length; i++) {
  // HTMLTableElement インターフェイス: border 属性
  if (tableAttrs[i].nodeName.toLowerCase() === "border") {
    table.border = "1";
  }
}
// HTMLTableElement インターフェイス: summary 属性
table.summary = "note: increased border";
```

### DOM の中で核となるインターフェイス

この節では、 DOM の中で最もよく使われるインターフェイスを列挙します。API がここで何をしているか記述するのではなく、DOM の中で非常に良く使われる関数や属性をちょっと示すのが狙いです。これらよく使われる API はこの本の最後の DOM の例の章のより長い例の中で使われています。

`document` と `window` オブジェクトが一般的に DOM プログラミングの中で最もよく使われます。簡単に言うと、 `window` オブジェクトはブラウザーのようなものを表現し、 `document` オブジェクトは文書のルート自身です。 `Element` は一般的な `Node` インターフェイスを継承していて、あわせてこの 2 つのインターフェイスはここの要素で使われる多くの関数と属性を提供します。前節での `table` オブジェクトの例のように、これの要素はそれぞれが持つデータを扱うための特定のインターフェイスを持っている場合があります。

以下は、 DOM を使うウェブや XML ページのスクリプトでよく使われる API の簡単な一覧です。

* `document.querySelector()`
* `document.querySelectorAll()`
* `document.createElement()`
* `Element.innerHTML`
* `Element.setAttribute()`
* `Element.getAttribute()`
* `EventTarget.addEventListener()`
* `HTMLElement.style`
* `Node.appendChild()`
* `window.onload`
* `window.scrollTo()`
例
-

### テキストコンテンツの設定

この例では、 `<div>` 要素に `<textarea>` と 2 つの `<button>` 要素が入っています。ユーザーが最初のボタンをクリックすると、 `<textarea>` にテキストを設定します。ユーザーが 2 つ目のボタンをクリックすると、そのテキストを消去します。使用しているものは次の通りです。

* `Document.querySelector()` で `<textarea>` とボタンにアクセスする
* `EventTarget.addEventListener()` でボタンのクリックを待ち受けする
* `Node.textContent` でテキストを設定したり消去したりする

#### HTML


```html
<div class="container">
  <textarea class="story"></textarea>
  <button id="set-text" type="button">テキストコンテンツを設定</button>
  <button id="clear-text" type="button">テキストコンテンツを消去</button>
</div>
```


#### CSS


```css
.container {
  display: flex;
  gap: 0.5rem;
  flex-direction: column;
}

button {
  width: 200px;
}
```


#### JavaScript


```js
const story = document.body.querySelector(".story");

const setText = document.body.querySelector("#set-text");
setText.addEventListener("click", () => {
  story.textContent = "暗くて嵐のような夜でした...";
});

const clearText = document.body.querySelector("#clear-text");
clearText.addEventListener("click", () => {
  story.textContent = "";
});
```


#### 結果

### 子要素の追加

この例では、 `<div>` 要素に `<div>` と 2 つの `<button>` 要素が入っています。ユーザーが最初のボタンをクリックすると、新しい要素を作成し、 `<div>` の子要素として追加します。ユーザーが 2 つ目のボタンをクリックしたら、子要素を除去します。使用しているものは次の通りです。

* `Document.querySelector()` で `<div>` とボタンにアクセスする
* `EventTarget.addEventListener()` でボタンのクリックを待ち受けする
* `Document.createElement` で要素を作成する
* `Node.appendChild()` で子要素を追加する
* `Node.removeChild()` で子要素を除去する

#### HTML


```html
<div class="container">
  <div class="parent">親</div>
  <button id="add-child" type="button">子を追加</button>
  <button id="remove-child" type="button">子を除去</button>
</div>
```


#### CSS


```css
.container {
  display: flex;
  gap: 0.5rem;
  flex-direction: column;
}

button {
  width: 100px;
}

div.parent {
  border: 1px solid black;
  padding: 5px;
  width: 100px;
  height: 100px;
}

div.child {
  border: 1px solid red;
  margin: 10px;
  padding: 5px;
  width: 80px;
  height: 60px;
  box-sizing: border-box;
}
```


#### JavaScript


```js
const parent = document.body.querySelector(".parent");

const addChild = document.body.querySelector("#add-child");
addChild.addEventListener("click", () => {
  // テキストノード「親」の他に、まだ子ノードがない場合のみ、
  // 子ノードを追加します。
  if (parent.childNodes.length > 1) {
    return;
  }
  const child = document.createElement("div");
  child.classList.add("child");
  child.textContent = "子";
  parent.appendChild(child);
});

const removeChild = document.body.querySelector("#remove-child");
removeChild.addEventListener("click", () => {
  const child = document.body.querySelector(".child");
  parent.removeChild(child);
});
```


#### 結果

仕様書
---

| Specification |
| --- |
| DOM Standard  |