Document Interface
Each web page loaded in the browser has its own document object. This object serves as an entry point to the web page's content (the DOM tree, including elements such as <body>
and <table>
) and provides functionality global to the document (such as obtaining the page's URL and creating new elements in the document).
A document object can be obtained from various APIs:
- Most commonly, you work with the document the script is running in by using
document
in document's scripts. (The same document can also be referred to aswindow.document
.) - The document of an iframe via the iframe's
contentDocument
property. - The
responseXML
of anXMLHttpRequest
object. - The document, that given node or element belongs to, can be retrieved using the node's
ownerDocument
property. - ...and more.
Depending on the kind of the document (e.g. HTML or XML) different APIs may be available on the document object. This theoretical availability of APIs is usually described in terms of implementing interfaces defined in the relevant W3C DOM specifications:
- All document objects implement the DOM Core
Document
andNode
interfaces, meaning that the "core" properties and methods are available for all kinds of documents. - In addition to the generalized DOM Core document interface, HTML documents also implement the
HTMLDocument
interface, which is a more specialized interface for dealing with HTML documents (e.g., document.cookie, document.alinkColor). - XUL documents (available to Mozilla add-on and application developers) implement their own additions to the core Document functionality.
Methods or properties listed here that are part of a more specialized interface have an asterisk (*) next to them and have additional information in the Availability column.
Note that some APIs listed below are not available in all browsers for various reasons:
- Obsolete: on its way of being removed from supporting browsers.
- Non-standard: either an experimental feature not (yet?) agreed upon by all vendors, or a feature targeted specifically at the code running in a specific browser (e.g. Mozilla has a few DOM APIs created for its add-ons and application development).
- Part of a completed or an emerging standard, but not (yet?) implemented in all browsers or implemented in the newest versions of the browsers.
Detailed browser compatibility tables are located at the pages describing each property or method.
Extends
Subinterfaces
Methods
Code CDATASection createCDATASection(String data) #
CDATASection createCDATASection(String data);
Code DocumentFragment createDocumentFragment() #
DocumentFragment createDocumentFragment();
Code Touch createTouch(Window window, EventTarget target, int identifier, int pageX, int pageY, int screenX, int screenY, int webkitRadiusX, int webkitRadiusY, num webkitRotationAngle, num webkitForce) #
Touch createTouch(Window window, EventTarget target, int identifier, int pageX, int pageY, int screenX, int screenY, int webkitRadiusX, int webkitRadiusY, num webkitRotationAngle, num webkitForce);
Code Element elementFromPoint(int x, int y) #
Element elementFromPoint(int x, int y);
Code CanvasRenderingContext getCSSCanvasContext(String contextId, String name, int width, int height) #
CanvasRenderingContext getCSSCanvasContext(String contextId, String name, int width, int height);
Code DocumentEvents get on() #
DocumentEvents get on();
Code void webkitCancelFullScreen() #
void webkitCancelFullScreen();
Code void webkitExitFullscreen() #
void webkitExitFullscreen();
Code void webkitExitPointerLock() #
void webkitExitPointerLock();
Code Element $dom_createElement(String tagName) #
Element $dom_createElement(String tagName);
Code Element $dom_createElementNS(String namespaceURI, String qualifiedName) #
Element $dom_createElementNS(String namespaceURI, String qualifiedName);
Code Event $dom_createEvent(String eventType) #
Event $dom_createEvent(String eventType);
Code Text $dom_createTextNode(String data) #
Text $dom_createTextNode(String data);
Code Element $dom_getElementById(String elementId) #
Element $dom_getElementById(String elementId);
Code NodeList $dom_getElementsByClassName(String tagname) #
NodeList $dom_getElementsByClassName(String tagname);
Code NodeList $dom_getElementsByName(String elementName) #
NodeList $dom_getElementsByName(String elementName);
Code NodeList $dom_getElementsByTagName(String tagname) #
NodeList $dom_getElementsByTagName(String tagname);
Code Element $dom_querySelector(String selectors) #
Element $dom_querySelector(String selectors);
Code NodeList $dom_querySelectorAll(String selectors) #
NodeList $dom_querySelectorAll(String selectors);
Fields
Code String cookie #
String cookie;
Code final Element documentElement #
final Element documentElement;
Code final HeadElement head #
final HeadElement head;
Code final String lastModified #
final String lastModified;
Code final String referrer #
final String referrer;
Code final StyleSheetList styleSheets #
final StyleSheetList styleSheets;
Code final bool webkitFullScreenKeyboardInputAllowed #
final bool webkitFullScreenKeyboardInputAllowed;
This page includes content from the Mozilla Foundation that is graciously licensed under a Creative Commons: Attribution-Sharealike license. Mozilla has no other association with Dart or dartlang.org. We encourage you to improve the web by contributing to The Mozilla Developer Network.