HTMLDocument
は HTML 階層のルートであり内容全体を保持する。加えて階層へのアクセスを提供し、文書から若干の情報にアクセスするためのいくつかの 簡便 メソッドも提供する。
次のプロパティは非推奨であり、 BODY
要素の相当するプロパティが望ましい:
Note: DOM Level 2 では, メソッド getElementById
は Document
インターフェイスに移動し、そこから継承される。
URL
DOMString
型, 読取専用
anchors
HTMLCollection
型, 読取専用
name
属性の値を持つ文書内のアンカー (A
) 要素全てのコレクション。
Note: 後方互換上の理由で、返されるアンカーの集合には name
属性を持つアンカーだけが含まれ、 id
属性を持つものは含まれない。 [XHTML 1.0] の場合は, name
属性 (セクション 4.10 参照) は何の意味ももたず、古いユーザーエージェントのためだけに存在することに注意: 代わりに id
属性が使用される。ユーザは代わりに [DOM Level 2 Traversal] が提供するイテレータのメカニズムを選ぶべきである。
applets
HTMLCollection
型, 読取専用
OBJECT
要素と APPLET
(非推奨) 要素の全てのコレクション。body
BODY
の内容をもつ文書では, BODY
要素を返す。フレームセット文書では、最も外側の FRAMESET
要素を返す。domain
DOMString
型, 読取専用
null
。forms
HTMLCollection
型, 読取専用
images
HTMLCollection
型, 読取専用
IMG
要素全てのコレクション。後方互換のため、振る舞いは IMG
要素に限定される。
Note: [HTML 4.01] で示唆されるように, 画像の包含に、著者は OBJECT
要素か IMG
要素を使用できる。それゆえ、文書内画像の検索にはこのプロパティを用いず、 HTML 4.01 の getElementsByTagName
や XHTML 1.0 の getElementsByTagNameNS
を用いることを推奨する。
links
HTMLCollection
型, 読取専用
href
属性の値を持つ AREA
要素とアンカー (A
) 要素全てのコレクション。referrer
DOMString
型, 読取専用
title
TITLE
要素で指定される、文書のタイトル。close
( )open()
で開かれた文書ストリームを閉じ、レンダリングを強制する。
(無し)
getElementsByName
( elementName )open
( )書きだすために文書ストリームを開く。対象に既に文書が存在している場合は、それをクリアする。
Note: このメソッドと次のメソッドは、文書の構造モデルの追加または置換に解析前の HTML 文字列を用いることをユーザに許可する。執筆時において、同様の機能を持つ HTML, XHTML 両文書のための代替のメソッドが考案されていた ([DOM Level 3 Load and Save] 参照)。
(無し)
write
( text )open()
で開かれた文書ストリームにテキストの文字列を書き出す。関数が生成する文書は DTD に沿ったものであるとは限らず、それゆえ文書の文脈に不正な結果をもたらすかもしれないことに注意。
(無し)
writeln
( text )open()
で開かれた文書ストリームに改行文字の続くテキストの文字列を書き出す。 関数が生成する文書は DTD に沿ったものであるとは限らず、それゆえ文書の文脈に不正な結果をもたらすかもしれないことに注意。
(無し)
interface HTMLDocument : Document { attribute DOMString title; readonly attribute DOMString referrer; readonly attribute DOMString domain; readonly attribute DOMString URL; attribute HTMLElement body; readonly attribute HTMLCollection images; readonly attribute HTMLCollection applets; readonly attribute HTMLCollection links; readonly attribute HTMLCollection forms; readonly attribute HTMLCollection anchors; attribute DOMString cookie; // raises(DOMException) on setting void open(); void close(); void write(in DOMString text); void writeln(in DOMString text); NodeList getElementsByName(in DOMString elementName); };