Document インターフェイスはブラウザーに読み込まれたウェブページを表し、 DOM ツリーであるウェブページのコンテンツへのエントリーポイントとして働きます。 DOM ツリーは <body> や <table> など、多数の要素を持ちます。これはページの URL を取得したり文書で新たな要素を作成するなど、文書全体に関わる機能を提供します。
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25 121,20 121,30 111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25 236,20 236,30 226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/Document" target="_top"><rect x="266" y="1" width="80" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="306" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Document</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
Document インターフェイスは、あらゆる種類の文書に対して共通のプロパティやメソッドを提供します。また、文書の種類 (例: HTML、XML、SVG など) に応じて、より大規模な API を使用できます。コンテンツタイプ "text/html" で提供される HTML 文書では、 HTMLDocument インターフェイスも実装します。一方 XML や SVG 文書では、 XMLDocument インターフェイスを実装します。
コンストラクター
Document()- 新しい
Documentオブジェクトを作成します。
プロパティ
このインターフェイスは、 Node インターフェイスおよび EventTarget インターフェイスのプロパティも継承しています。
Document.anchors読取専用- 文書内のすべてのアンカーのリストを返します。
Document.body- 現在の文書の
<body>または<frameset>ノードを返します。 Document.characterSet読取専用- 文書に適用されている文字セットを返します。
Document.compatMode読取専用- 文書が Quirks モードと Strict モードのどちらで描画されているかを示します。
Document.contentType読取専用- 現在の文書の MIME ヘッダーから Content-Type を返します。
Document.doctype読取専用- 現在の文書の文書型宣言 (DTD) を返します。
Document.documentElement読取専用- 文書の直接の子である
Elementを返します。 HTML 文書では、これは通常は文書の<html>要素を表すHTMLElementオブジェクトになります。 Document.documentURI読取専用- 文書の場所を文字列で返します。
Document.embeds読取専用- 現在の文書に含まれる、埋め込まれた
<embed>要素のリストを返します。 Document.fonts- 現在の文書の
FontFaceSetインターフェイスを返します。 Document.forms読取専用- 現在の文書の
<form>要素のリストを返します。 Document.head読取専用- 現在の文書の
<head>要素を返します。 Document.hidden読取専用- このページが非表示と見なされているかどうかを論理値で返します。
Document.images読取専用- 現在の文書の画像のリストを返します。
Document.implementation読取専用- 現在の文書に関連付けられた DOM 実装を返します。
Document.lastStyleSheetSet読取専用- 直前に有効であったスタイルシートセットの名称を返します。
selectedStyleSheetSetに値を設定してスタイルシートを変更するまで、この値はnullになります。 Document.links読取専用- 文書内のすべてのハイパーリンクのリストを返します。
Document.mozSyntheticDocument- 単独の画像、動画、オーディオファイルなど、文書が Synthetic である場合に限り
trueとなるBooleanを返します。 Document.plugins読取専用- 利用可能なプラグインのリストを返します。
Document.featurePolicy読取専用- 特定の文書に適用する機能ポリシーを見るための簡単な API を提供する
FeaturePolicyインターフェイスを返します。 Document.preferredStyleSheetSet読取専用- ページの作者によって設定された、優先的なスタイルシートを返します。
Document.scripts読取専用- 文書内のすべての
<script>要素を返します。 Document.scrollingElement読取専用- 文書をスクロールする
Elementへの参照を返します。 Document.selectedStyleSheetSet- 現在どのスタイルシートセットを使用しているかを返します。
Document.styleSheetSets読取専用- 文書で使用できるスタイルシートセットのリストを返します。
Document.timeline読取専用- タイムラインを
DocumentTimelineの特別なインスタンスで返します。これはページの読み込み時に自動的に生成されます。 Document.undoManager読取専用- …
Document.visibilityState読取専用- 文書の可視性を表す
stringを返します。visible,hidden,prerender,unloadedのいずれかの値になります。
Document インターフェイスは、 ParentNode インターフェイスから派生しています。
ParentNode.childElementCount読取専用- オブジェクトが持つ子の数を表す
unsigned long値を返す。 ParentNode.children読取専用- この
ParentNodeの子であるすべてのElement型のオブジェクトを含む実際のHTMLCollectionを返す。要素ではないノードは省きます。 ParentNode.firstElementChild読取専用- この
ParentNodeの最初の子であるElementを返す。存在しない場合はnullを返す。 ParentNode.lastElementChild読取専用- この
ParentNodeの最後の子であるElementを返す。存在しない場合はnullを返す。
HTML 文書向けの拡張
HTML 文書用の Document インターフェイスは HTMLDocument インターフェイスから継承する、あるいは HTML5 文書向けに拡張されています。
Document.cookie- 文書のクッキーをセミコロンで区切られたリストで返すか、1 つのクッキーを設定します。
Document.defaultView読取専用- window オブジェクトへの参照を返します。
Document.designMode- 文書全体を編集可能かを取得 / 設定します。
Document.dir読取専用- 文書の書字方向 (rtl/ltr) を取得 / 設定します。
Document.domain- 現在の文書のドメインを取得 / 設定します。
Document.lastModified読取専用- 文書の最終更新日を返します。
Document.location読取専用- 現在の文書の URI を返します。
Document.readyState読取専用- 文書の読み込み状況を表す文字列を返します。
Document.referrer読取専用- このページへリンクしたページの URI を返します。
Document.title- 現在の文書のタイトルを設定または取得します。
Document.URL読取専用- 現在の文書の URL を含む文字列を返します。
DocumentOrShadowRoot からインクルードしたプロパティ
Document インターフェイスは、 DocumentOrShadowRoot ミックスインで定義された以下のプロパティを含んでいます。これらは現在 Chrome のみ実装しています。ほかのブラウザーはいまだに、 Document インターフェイスに直接実装しています。
DocumentOrShadowRoot.activeElement読取専用- フォーカスを持つシャドウツリーがある
Elementを返します。 Document.fullscreenElement読取専用- 文書で現在全画面モードになっている要素です。
DocumentOrShadowRoot.pointerLockElement読取専用- マウスポインターをロックしているときに、mouse イベントのターゲットとして設定された要素を返します。ロックが未実施、ロックが解除済み、あるいは別の文書がターゲットである場合は
nullになります。 DocumentOrShadowRoot.styleSheets読取専用- 文書へ明示的にリンクまたは埋め込まれているスタイルシートの
CSSStyleSheetオブジェクトの、StyleSheetListを返します。
イベントハンドラー
Document.onafterscriptexecuteafterscriptexecuteイベント用のイベント制御コードを表します。Document.onbeforescriptexecutebeforescriptexecuteイベント用のイベント制御コードを表します。Document.oncopycopyイベント用のイベント制御コードを表します。Document.oncutcutイベント用のイベント制御コードを表します。Document.onfullscreenchangefullscreenchangeイベントが発生したときに呼び出すコードを表すEventHandlerです。Document.onfullscreenerrorfullscreenerrorイベントが発生したときに呼び出すコードを表すEventHandlerです。Document.onpastepasteイベント用のイベント制御コードを表します。Document.onreadystatechangereadystatechangeイベント用のイベント制御コードを表します。Document.onselectionchangeselectionchangeイベントが発生したときに呼び出すコードを表すEventHandlerです。Document.onvisibilitychangevisibilitychangeイベントが発生したときに呼び出すコードを表すEventHandlerです。
Document インターフェイスは、GlobalEventHandlers インターフェイスから派生しています。
このインターフェイスには、以下のイベントハンドラー以外のプロパティはありません。
イベントハンドラー
以下のイベントハンドラーは GlobalEventHandlers ミックスインで定義されており、 HTMLElement, Document, Window、さらに Web Worker 向けには WorkerGlobalScope が実装しています。
GlobalEventHandlers.onabortEventHandlerで、abortイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onanimationcancelEventHandlerで、 CSS アニメーションがキャンセルされたことを示すanimationcancelイベントが送信されたときに呼び出されます。GlobalEventHandlers.onanimationendEventHandlerで、 CSS アニメーションの再生が停止したことを示す、animationendイベントが送信されたときに呼び出されます。GlobalEventHandlers.onanimationiterationEventHandlerで、 CSS アニメーションのアニメーションシーケンスが新たなな繰り返しに入ったことを示す、animationiterationイベントが送信されたときに呼び出されます。GlobalEventHandlers.onanimationstartEventHandlerで、 CSS アニメーションの再生が開始したことを示す、animationstartイベントが送信されたときに呼び出されます。GlobalEventHandlers.onauxclickEventHandlerで、入力デバイスで非プライマリーボタン (例えばマウスの中ボタン) が押下されたことを示す、auxclickイベントが送信されたときに呼び出されます。GlobalEventHandlers.onblurEventHandlerで、blurイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onerrorEventHandlerで、errorイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onfocusEventHandlerで、focusイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.oncancelEventHandlerで、cancelイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.oncanplayEventHandlerで、canplayイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.oncanplaythroughEventHandlerで、canplaythroughイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onchangeEventHandlerで、changeイベントが発生した時にときび出すコードを表します。GlobalEventHandlers.onclickEventHandlerで、clickイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.oncloseEventHandlerで、closeイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.oncontextmenuEventHandlerで、contextmenuイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.oncuechangeEventHandlerで、cuechangeイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ondblclickEventHandlerで、dblclickイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ondragEventHandlerで、dragイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ondragendEventHandlerで、dragendイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ondragenterEventHandlerで、dragenterイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ondragexitEventHandlerで、dragexitイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ondragleaveEventHandlerで、dragleaveイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ondragoverEventHandlerで、dragoverイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ondragstartEventHandlerで、dragstartイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ondropEventHandlerで、dropイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ondurationchangeEventHandlerで、durationchangeイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onemptiedEventHandlerで、emptiedイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onendedEventHandlerで、endedイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onformdataEventHandlerで、フォームデータが構築されたことを表す入力リストの後で発生するformdataイベントの処理をします。GlobalEventHandlers.ongotpointercaptureEventHandlerで、gotpointercaptureイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.oninputEventHandlerで、inputイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.oninvalidEventHandlerで、invalidイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onkeydownEventHandlerで、keydownイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onkeypressEventHandlerで、keypressイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onkeyupEventHandlerで、keyupイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onloadEventHandlerで、loadイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onloadeddataEventHandlerで、loadeddataイベントが発生したときに呼び出すコードをします。GlobalEventHandlers.onloadedmetadataEventHandlerで、loadedmetadataイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onloadendEventHandlerで、loadendイベントが発生した (リソースの読み込みの進行が停止した) ときに呼び出すコードを表します。GlobalEventHandlers.onloadstartEventHandlerで、loadstartイベントが発生した (リソースの読み込みを開始した) ときに呼び出すコードを表します。GlobalEventHandlers.onlostpointercaptureEventHandlerで、lostpointercaptureイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onmousedownEventHandlerで、mousedownイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onmouseenterEventHandlerで、mouseenterイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onmouseleaveEventHandlerで、mouseleaveイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onmousemoveEventHandlerで、mousemoveイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onmouseoutEventHandlerで、mouseoutイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onmouseoverEventHandlerで、mouseoverイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onmouseupEventHandlerで、mouseupイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onmousewheelEventHandlerで、mousewheelイベントが発生したときに呼び出すコードを表します。廃止予定です。 代わりにonwheelを使ってください。GlobalEventHandlers.onwheelEventHandlerで、wheelイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onpauseEventHandlerで、pauseイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onplayEventHandlerで、playイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onplayingEventHandlerで、playingイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onpointerdownEventHandlerで、pointerdownイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onpointermoveEventHandlerで、pointermoveイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onpointerupEventHandlerで、pointerupイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onpointercancelEventHandlerで、pointercancelイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onpointeroverEventHandlerで、pointeroverイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onpointeroutEventHandlerで、pointeroutイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onpointerenterEventHandlerで、pointerenterイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onpointerleaveEventHandlerで、pointerleaveイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onpointerlockchangeEventHandlerで、pointerlockchangeイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onpointerlockerrorEventHandlerで、pointerlockerrorイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onprogressEventHandlerで、progressイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onratechangeEventHandlerで、ratechangeイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onresetEventHandlerで、resetイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onresizeEventHandlerで、resizeイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onscrollEventHandlerで、scrollイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onseekedEventHandlerで、seekedイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onseekingEventHandlerで、seekingイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onselectEventHandlerで、selectイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onselectstartEventHandlerで、selectstartイベントが発生した (ユーザーがウェブページで新たにテキスト選択を開始した) ときに呼び出すコードを表します。GlobalEventHandlers.onselectionchangeEventHandlerで、selectionchangeイベントが発生した (ウェブページで選択されたテキストが替わった) ときに呼び出すコードを表します。GlobalEventHandlers.onshowEventHandlerで、showイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onsortEventHandlerで、sortイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onstalledEventHandlerで、stalledイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onsubmitEventHandlerで、submitイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onsuspendEventHandlerで、suspendイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ontimeupdateEventHandlerで、timeupdateイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.onvolumechangeEventHandlerで、volumechangeイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ontouchcancelEventHandlerで、touchcancelイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ontouchendEventHandlerで、touchendイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ontouchmoveEventHandlerで、touchmoveイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ontouchstartEventHandlerで、touchstartイベントが発生したときに呼び出すコードを表します。GlobalEventHandlers.ontransitioncancelEventHandlerで、 CSS トランジションがキャンセルされたことを示す、transitioncancelイベントが送信されたときに呼び出されます。GlobalEventHandlers.ontransitionendEventHandlerで、 CSS トランジションの再生が停止したことを示す、transitionendイベントが送信されたときに呼び出されます。GlobalEventHandlers.ontransitionrunEventHandlerで、transitionrunイベントが送信されたときに呼び出され、 CSS トランジションが実行されていることを示しますが、開始されているとは限りません。GlobalEventHandlers.ontransitionstartEventHandlerで、transitionstartイベントが送信されたときに呼び出され、 CSS トランジションが遷移を開始したことを示します。GlobalEventHandlers.onwaitingEventHandlerで、waitingイベントが発生したときに呼び出すコードを表します。
非推奨のプロパティ
Document.alinkColor- 文書本文内のアクティブなリンクの色を取得または設定します。
Document.all- 文書内のすべての要素にアクセスできます。文書ノードを起点とする
HTMLAllCollectionを返します。これは古い標準外のプロパティですので、使用しないようにしてください。 Document.applets読取専用- 文書内にあるアプレットのリスト (出現順) を返します。
Document.bgColor- 現在の文書の背景色を取得または設定します。
Document.charset読取専用Document.characterSetの別名です。代わりにDocument.characterSetを使用してください。Document.domConfigDOMConfigurationオブジェクトを返すはずです。Document.fgColor- 現在の文書の前景色または文字色を取得 / 設定します。
Document.fullscreen- 文書が 全画面モード であるときに、
trueになります。 Document.height- 現在の文書の高さを取得 / 設定します。
Document.inputEncoding読取専用Document.characterSetの別名です。代わりにDocument.characterSetを使用してください。Document.linkColor- document 内のハイパーリンクの色を取得 / 設定します。
Document.rootElementDocument.documentElementと同様ですが、<svg>ルート要素専用です。こちらのプロパティを代わりに使用してください。Document.vlinkColor- 訪問済みのハイパーリンクの色を取得/設定します。
Document.width- 現在の文書の幅を返します。
Document.xmlEncoding- XML 宣言によって決められたエンコーディングを返します。
Document.xmlStandaloneGecko 10 で廃止- XML 宣言で文書がスタンドアロンである (例: DTD の外部パートが文書のコンテンツに影響する) 場合に
trueを、そうでない場合にfalseを返します。 Document.xmlVersionGecko 10 で廃止- XML 宣言で指定されたバージョン番号、または宣言が省略されている場合に
"1.0"を返します。
メソッド
このインターフェイスは、Node インターフェイスおよび EventTarget インターフェイスのメソッドを継承します。
Document.adoptNode()- 外部文書からノードを取り込みます。
Document.captureEvents()Window.captureEventsをご覧ください。Document.caretRangeFromPoint()- 指定した座標にある文書の断片の
Rangeオブジェクトを取得します。 Document.createAttribute()- 新しい
Attrオブジェクトを生成して、返します。 Document.createAttributeNS()- 指定した名前空間に新しい属性ノードを生成して、返します。
Document.createCDATASection()- 新しい CDATA ノードを生成して、返します。
Document.createComment()- 新しいコメントノードを生成して、返します。
Document.createDocumentFragment()- 新しい文書断片を生成します。
Document.createElement()- 指定したタグ名で新しい要素を生成します。
Document.createElementNS()- 指定したタグ名およびネームスペース URI で、新しい要素を生成します。
Document.createEntityReference()- 新しい Entity Reference オブジェクトを生成して、返します。
Document.createEvent()- Event オブジェクトを生成します。
Document.createNodeIterator()NodeIteratorオブジェクトを生成します。Document.createProcessingInstruction()- 新しい
ProcessingInstructionオブジェクトを生成します。 Document.createRange()Rangeオブジェクトを生成します。Document.createTextNode()- テキストノードを生成します。
Document.createTouch()Touchオブジェクトを生成します。Document.createTouchList()TouchListオブジェクトを生成します。Document.createTreeWalker()TreeWalkerオブジェクトを生成します。Document.enableStyleSheetsForSet()- 指定したスタイルシートセットのスタイルシートを有効化します。
Document.exitPointerLock()- Pointer Lock を解放します。
Document.getAnimations()- 現在実行中であるすべての
Animationオブジェクトの配列を返します。この対象要素は、documentの子孫要素です。 Document.getElementsByClassName()- (引数で) 与えられたクラス名を持つ要素のリストを返します。
Document.getElementsByTagName()- (引数で) 与えられたタグ名を持つ要素のリストを返します。
Document.getElementsByTagNameNS()- (引数で) 与えられたタグ名と名前空間を持つ要素のリストを返します。
Document.hasStorageAccess()- 文書が自分自身のストレージにアクセスしたかどうかを示す真偽値を解決する
Promiseを返します。 Document.importNode()- 外部文書のノードの複製を返します。
Document.normalizeDocument()- エンティティの置換や、テキストノードの正規化などを行います。
Document.releaseCapture()- この文書内の要素でマウスキャプチャーを行っている場合に、マウスキャプチャーを解放します。
Document.releaseEvents()Window.releaseEvents()をご覧ください。Document.requestStorageAccess()- 自分自身のストレージへのアクセスが許可された場合は解決し、拒否された場合は拒否される
Promiseを返します。 Document.routeEvent()Gecko 24 で廃止Window.routeEvent()をご覧ください。Document.mozSetImageElement()- 指定した ID を持つ要素の背景画像として使用する要素を変更できます。
Document インターフェイスは、 ParentNode インターフェイスから継承しています。
document.getElementById(String id)- 特定の id を持つ要素へのオブジェクト参照を返します。
Document.querySelector()- 指定したセレクターに一致する、文書内で最初の要素ノードを返します。
Document.querySelectorAll()- 指定したセレクターに一致する、文書内のすべての要素ノードのリストを返します。
Document インターフェイスは、XPathEvaluator インターフェイスによって拡張されています。
Document.createExpression()- (繰り返し) 評価に使用できる
XPathExpressionをコンパイルします。 Document.createNSResolver()XPathNSResolverオブジェクトを生成します。Document.evaluate()- XPath 表現を評価します。
HTML 文書向けの拡張
HTML 文書用の Document インターフェイスは HTMLDocument インターフェイスから継承する、あるいは HTML5 文書向けに拡張されています。
Document.clear()- 最近の Firefox や Internet Explorer を含む大部分の現行ブラウザーは、何も行いません。
Document.close()- 書き込み用の文書ストリームを閉じます。
Document.execCommand()- 編集可能な文書で、フォーマットコマンドを実行します。
Document.getElementsByName()- (引数で) 与えられた名前 (name) を持つ要素のリストを返します。
Document.hasFocus()- 指定した文書内にフォーカスがある場合に、
trueを返します。 Document.open()- 書き込み用の文書ストリームを開きます。
Document.queryCommandEnabled()- 現在の領域でフォーマットコマンドを実行できる場合に、 true を返します。
Document.queryCommandIndeterm()- 現在の領域でフォーマットコマンドの状態が不確定である場合に true を返します。
Document.queryCommandState()- 現在の領域でフォーマットコマンドを実行した場合に true を返します。
Document.queryCommandSupported()- 現在の領域でフォーマットコマンドをサポートしている場合に、true を返します。
Document.queryCommandValue()- 指定したフォーマットコマンドについて、現在の領域における値を返します。
Document.write()- 文書にテキストを書き込みます。
Document.writeln()- 文書にテキスト行を書き込みます。
DocumentOrShadowRoot から組み入れられたメソッド
Document インターフェイスは、DocumentOrShadowRoot ミックスインで定義された以下のメソッドを含んでいます。これらは現在 Chrome のみ実装しています。ほかのブラウザーはいまだに、 Document インターフェイスに実装しています。
DocumentOrShadowRoot.getSelection()- ユーザーが現在選択しているテキスト範囲、または現在のキャレットの位置を表す
Selectionオブジェクトを返します。 DocumentOrShadowRoot.elementFromPoint()- 指定した座標で最前面にある要素を返します。
DocumentOrShadowRoot.elementsFromPoint()- 指定した座標に存在するすべての要素の配列を返します。
DocumentOrShadowRoot.caretPositionFromPoint()- キャレットがある DOM ノードと、ノード内でキャレットあがある文字のオフセットを持つ
CaretPositionオブジェクトを返します。
イベント
これらのイベントを待ち受けするには、 addEventListener() を使用するか、本インターフェイスの onイベント名 プロパティへイベントリスナーを代入するかしてください。
scroll- 文書のビューまたは要素がスクロールしたときに発行されます。
onscrollプロパティからも利用できます。 visibilitychange- タブの内容の表示・非表示の状態が切り替わった時に発行されます。
onvisibilitychangeプロパティからも利用できます。 wheel- ユーザーがポインティングデバイス (通常はマウス) のホイールボタンを回転した時に発行されます。
onwheelプロパティからも利用できます。
アニメーションイベント
animationcancel- アニメーションが予期せず中断された時に発行されます。
onanimationcancelプロパティからも利用できます。 animationend- アニメーションが正常に完了したときに発行されます。
onanimationendプロパティからも利用できます。 animationiteration- アニメーションの1周期が完了したときに発行されます。
onanimationiterationプロパティからも利用できます。 animationstart- アニメーションが始まった時に発行されます。
onanimationstartプロパティからも利用できます。
クリップボードイベント
ドラッグ＆ドロップイベント
drag- 要素またはテキストの選択範囲をユーザーがドラッグしている間、数百ミリ秒ごとに発行されます。
ondragプロパティからも利用できます。 dragend- ドラッグ操作が終了したとき (マウスボタンを離したときやエスケープキーを押したとき) に発行されます。
ondragendプロパティからも利用できます。 dragenter- ドラッグ中の要素またはテキストの選択範囲が妥当なドロップ対象に入ったときに発行されます。
ondragenterプロパティからも利用できます。 dragexit- 要素がドラッグ操作の直接的な選択対象でなくなったときに発行されます。
ondragexitプロパティからも利用できます。 dragleave- ドラッグ中の要素またはテキストの選択範囲が妥当なドロップ対象から外れたときに発行されます。
ondragleaveプロパティからも利用できます。 dragover- 要素またはテキストの選択範囲が妥当なドロップ対象の上をドラッグされているときに (数ミリ秒ごとに) 発行されます。
ondragoverプロパティからも利用できます。 dragstart- ユーザーが要素またはテキストの選択範囲のドラッグを開始したときに発行されます。
ondragstartプロパティからも利用できます。 drop- 要素またはテキストの選択範囲が妥当なドロップ対象にドロップされたときに発行されます。
ondropプロパティからも利用できます。
全画面イベント
fullscreenchangeDocumentが全画面モードへ移行したとき、または解除されたときに発行されます。
onfullscreenchangeプロパティからも利用できます。fullscreenerror- 全画面モードへ切り替えようとしたとき、または解除しようとしたときにエラーが発生した場合に発行されます。
onfullscreenerrorプロパティからも利用できます。 -
キーボードイベント
keydown- キーが押されたときに発行されます。
onkeydownプロパティからも利用できます。 keypress- 文字値を生成するキーが押下されたときに発行されます。
onkeypressプロパティからも利用できます。 keyup- キーを離したときに発行されます。
onkeyupプロパティからも利用できます。
ロード＆アンロードイベント
DOMContentLoaded- 文書が完全に読み込まれて解釈されたときに、スタイルシート、画像、サブフレームの読み込みが完了するのを待たずに発行されます。
readystatechange- 文書の
readyState属性が変更されたときに発行されます。onreadystatechangeプロパティからも利用できます。
ポインターイベント
gotpointercapturesetPointerCapture()を使用して要素がポインターをキャプチャしたときに発行されます。
ongotpointercaptureプロパティからも利用できます。lostpointercapture- キャプチャされたポインターが解放されたときに発行されます。
onlostpointercaptureプロパティからも利用できます。 pointercancel- ポインターイベントがキャンセルされたときに発行されます。
onpointercancelプロパティからも利用できます。 pointerdown- ポインターがアクティブになったときに発行されます。
onpointerdownプロパティからも利用できます。 pointerenter- ポインターが要素やその子孫のヒットテスト境界の中へ移動したときに発行されます。
onpointerenterプロパティからも利用できます。 pointerleave- ポインターが要素のヒットテスト境界の外へ移動したときに発行されます。
onpointerleaveプロパティからも利用できます。 pointerlockchange- ポインターがロックまたはアンロックされたときに発行されます。
onpointerlockchangeプロパティからも利用できます。 pointerlockerror- ポインターをロックしようとして失敗したときに発行されます。
onpointerlockerrorプロパティからも利用できます。 pointermove- ポインターの座標が変化したときに発行されます。
onpointermoveプロパティからも利用できます。 pointerout- ポインターが (訳あって) 要素のヒットテスト境界の外へ移動したときに発行されます。
onpointeroutプロパティからも利用できます。 pointerover- ポインターが要素のヒットテスト境界の中へ移動したときに発行されます。
onpointeroverプロパティからも利用できます。 pointerup- ポインターがアクティブではなくなったときに発行されます。
onpointerupproperty.
選択イベント
selectionchange- 文書でのテキスト選択範囲が変化したときに発行されます。
onselectionchangeプロパティからも利用できます。 selectstart- ユーザーが新しい選択を開始したときに発行されます。
onselectstartプロパティからも利用できます。
タッチイベント
touchcancel- 1 つ以上のタッチ点が実装固有の方法で中断された場合に発行されます (例えば、作成されたタッチ点が多すぎた場合など)。
ontouchcancelプロパティからも利用できます。 touchend- 1つ以上のタッチ点がタッチ面から取り除かれたときに発行されます。
ontouchendプロパティからも利用できます。 touchmove- 1つ以上のタッチ点がタッチ面に沿って移動したときに発行されます。
ontouchmoveプロパティからも利用できます。 touchstart- 1つ以上のタッチ点がタッチ面に配置されたときに発行されます。
ontouchstartプロパティからも利用できます。
トランジションイベント
transitioncancel- CSS トランジションがキャンセルされたときに発行されます。
ontransitioncancelプロパティからも利用できます。 transitionend- CSS トランジションが完了したときに発行されます。
ontransitionendプロパティからも利用できます。 transitionrun- CSS トランジションが初めて作成されたときに発行されます。
ontransitionrunプロパティからも利用できます。 transitionstart- Fired when a CSS トランジションが実際に開始されたときに発行されます。
ontransitionstartプロパティからも利用できます。
標準外の拡張
非標準
この機能は標準ではなく、標準化の予定もありません。公開されているウェブサイトには使用しないでください。ユーザーによっては使用できないことがあります。実装ごとに大きな差があることもあり、将来は振る舞いが変わるかもしれません。
Firefox のメモ
Mozilla は、 XUL コンテンツ限定の標準外プロパティを定義しています。
Document.currentScript- 現在実行中の
<script>要素を返します。 Document.documentURIObject- (Mozilla アドオン限定!) 文書の URI を表す
nsIURIオブジェクトを返します。このプロパティは特権付き (UniversalXPConnect 権限) の JavaScript コード内に限り、特別な意味を持ちます。 Document.popupNode- ポップアップを表示させたノードを返します。
Document.tooltipNode- 現行のツールチップのターゲットであるノードを返します。
Mozilla では、標準外のメソッドも定義しています。
Document.execCommandShowHelp()Gecko 14 で廃止- このメソッドは何も行わずに例外が発生することから、 Gecko 14.0 (Firefox 14.0 / Thunderbird 14.0 / SeaMonkey 2.11) で削除しました。
Document.getBoxObjectFor()- 代わりに
Element.getBoundingClientRect()メソッドを使用してください。 Document.loadOverlay()Gecko 61 で廃止- XUL overlay を動的に読み込みます。これは XUL 文書のみで動作します。
Document.queryCommandText()Gecko 14 で廃止- このメソッドは何も行わずに例外が発生することから、Gecko 14.0 (Firefox 14.0 / Thunderbird 14.0 / SeaMonkey 2.11) で削除しました。
Internet Explorer の注意
Microsoft は、標準外のプロパティを定義しています。
Document.fileSize*- 文書の長さをバイト単位で返します。 Internet Explorer 11 より、このプロパティには対応していません。MSDN をご覧ください。
Internet Explorer は、 Node インターフェイス由来のメソッドをすべて Document インターフェイスで対応しているわけではありません。
Document.contains- 回避策として、
document.body.contains()を使用できます。
仕様書
| 仕様書 | 状態 | 備考 |
|---|---|---|
| DOM Document の定義 |
現行の標準 | DOM 3 の後継になる予定 |
| HTML Living Standard Document の定義 |
現行の標準 | HTMLDocument インターフェイスを Document の拡張に変更 |
| CSS Object Model (CSSOM) View Module Document の定義 |
草案 | Document インターフェイスを拡張 |
| Pointer Lock Document の定義 |
勧告候補 | Document インターフェイスを拡張 |
| Page Visibility (Second Edition) Document の定義 |
勧告 | Document インターフェイスを拡張し、 visibilityState および hidden 属性と onvisibilitychange イベントリスナーを追加 |
| Selection API Document の定義 |
草案 | getSelection(), onselectstart, onselectionchange を追加 |
| DOM4 Document の定義 |
廃止された | DOM 3 の後継 |
| Document Object Model (DOM) Level 3 Core Specification Document の定義 |
廃止された | DOM 2 の後継 |
| Document Object Model (DOM) Level 3 XPath Specification XPathEvaluator の定義 |
勧告 | document を拡張する XPathEvaluator インターフェイスを定義 |
| Document Object Model (DOM) Level 2 Core Specification Document の定義 |
廃止された | DOM 1 の後継 |
| Document Object Model (DOM) Level 1 Specification Document の定義 |
廃止された | インターフェイスの初回定義 |
ブラウザーの互換性
BCD tables only load in the browser
このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。