MDN may have intermittent access issues April 18 13:00 - April 19 01:00 UTC. See whistlepig.mozilla.org for all notifications.

mozilla
Your Search Results

    nsIDOMNSHTMLDocument

    This interface defines methods and properties supported by Gecko on the document object that are not part of DOM Level 2.
    Inherits from: nsISupports Last changed in Gecko 6.0 (Firefox 6.0 / Thunderbird 6.0 / SeaMonkey 2.3)

    Method overview

    void captureEvents(in long eventFlags);
    void clear();
    boolean execCommand(in DOMString commandID, in boolean doShowUI, in DOMString value);
    boolean execCommandShowHelp(in DOMString commandID); Obsolete since Gecko 14.0
    DOMString getSelection();
    nsIDOMDocument open(in ACString aContentType, in boolean aReplace);
    boolean queryCommandEnabled(in DOMString commandID);
    boolean queryCommandIndeterm(in DOMString commandID);
    boolean queryCommandState(in DOMString commandID);
    boolean queryCommandSupported(in DOMString commandID);
    DOMString queryCommandText(in DOMString commandID); Obsolete since Gecko 14.0
    DOMString queryCommandValue(in DOMString commandID);
    void releaseEvents(in long eventFlags);
    void routeEvent(in nsIDOMEvent evt);
    void write(); Obsolete since Gecko 2.0
    void writeln(); Obsolete since Gecko 2.0

    Attributes

    Attribute Type Description
    alinkColor DOMString Same as body.aLink
    bgColor DOMString Same as body.bgColor
    compatMode DOMString Returns "BackCompat" if the document is in Quirks mode or "CSS1Compat" if the document is in Full Standards or Almost Standards mode. Read only.
    designMode DOMString Set to "on" or "off" to enable or disable editing for the entire document at once. Roughly equivalent to body.contentEditable
    domain DOMString Initially the host name of the document's URL, but may be changed to the parent (but not top-level) domain in order to facilitate data exchange between documents from different sites in the same domain.
    embeds nsIDOMHTMLCollection Equivalent to getElementsByTagName("embed") Read only.
    fgColor DOMString Same as body.text
    head nsIDOMHTMLHeadElement Returns the first child element of the HTML element that is a HEAD element, or null if there is no HTML or HEAD element. Read only.
    height long The height of the body element. Read only. Obsolete since Gecko 6.0
    linkColor DOMString Same as body.link
    plugins nsIDOMHTMLCollection Same as embeds for compatibility with Netscape 4.x Read only.
    vlinkColor DOMString Same as body.vLink
    width long The width of the body element. Read only. Obsolete since Gecko 6.0

    Methods

    captureEvents()

    Provided for compatibility with Netscape 4.x, but does not actually do anything.

    void captureEvents(
      in long eventFlags
    );
    
    Parameters
    eventFlags
     

    clear()

    Used to reset a document to blank, but deprecated since Gecko 1.0 and provided for compatibility with Netscape 4.x; use open() and close() instead.

    void clear();
    
    Parameters

    None.

    execCommand()

    boolean execCommand(
      in DOMString commandID,
      in boolean doShowUI,
      in DOMString value
    );
    
    Parameters
    commandID
    The name of the command to execute. See Rich-Text Editing in Mozilla for a list of supported commands.
    doShowUI
    This is not implemented in Gecko.
    value
    Some commands require an argument. You can pass null for those commands that do not need an argument.
    Return value

    true if the command was recognized, false otherwise.

    Obsolete since Gecko 14.0 (Firefox 14.0 / Thunderbird 14.0 / SeaMonkey 2.11)

    execCommandShowHelp()

    This method never did anything but throw an exception, and was removed entirely in Gecko 14.0 (Firefox 14.0 / Thunderbird 14.0 / SeaMonkey 2.11).

    boolean execCommandShowHelp(
      in DOMString commandID
    );
    
    Parameters
    commandID
    The name of the command.
    Return value

    This method is not supported and always throws an exception.

    getSelection()

    DOMString getSelection();
    
    Parameters

    None.

    Return value

    The text of the current selection, the same as window.getSelection.toString().

    open()

    nsIDOMDocument open(
      in ACString aContentType, 
      in boolean aReplace 
    );
    
    Parameters
    aContentType
    The content type of the new document. If the type is not supported by the HTML content sink, trying to write to the document will probably throw.
    aReplace
    Whether the document should replace the existing document in session history.
    Return value

    The new document.

    queryCommandEnabled()

    boolean queryCommandEnabled(
      in DOMString commandID
    );
    
    Parameters
    commandID
    The name of the command to query.
    Return value

    Returns true if the command is supported and enabled, false otherwise.

    queryCommandIndeterm()

    boolean queryCommandIndeterm(
      in DOMString commandID
    );
    
    Parameters
    commandID
    The name of the command to query.
    Return value

    For stateful commands, returns true if the command is in an indeterminate state, false otherwise. For instance, if there is a selection and part of the selected text is bold, then then bold command is in an indeterminate state.

    queryCommandState()

    boolean queryCommandState(
      in DOMString commandID
    );
    
    Parameters
    commandID
    The name of the command to query.
    Return value

    For stateful commands, returns true if the command has is active, false otherwise.

    queryCommandSupported()

    boolean queryCommandSupported(
      in DOMString commandID
    );
    
    Parameters
    commandID
    The name of the command to query.
    Return value

    Returns true if the command is supported on the current range, false otherwise.

    Obsolete since Gecko 14.0 (Firefox 14.0 / Thunderbird 14.0 / SeaMonkey 2.11)

    queryCommandText()

    This method never did anything but throw an exception, and was removed entirely in Gecko 14.0 (Firefox 14.0 / Thunderbird 14.0 / SeaMonkey 2.11).

    DOMString queryCommandText(
      in DOMString commandID
    );
    
    Parameters
    commandID
    The name of the command to query.
    Return value

    This method is not supported and always throws an exception.

    queryCommandValue()

    DOMString queryCommandValue(
      in DOMString commandID
    );
    
    Parameters
    commandID
    The name of the command to query.
    Return value

    The value of the command. For the gethtml command, the current selection is returned as an HTML source fragment.

    releaseEvents()

    Provided for compatibility with Netscape 4.x, but does not actually do anything.

    void releaseEvents(
      in long eventFlags
    );
    
    Parameters
    eventFlags
     

    routeEvent()

    Provided for compatibility with Netscape 4.x, but does not actually do anything.

    void routeEvent(
      in nsIDOMEvent evt
    );
    
    Parameters
    evt
     

    Obsolete since Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

    write()

    void write(
      [optional] in DOMString text
    );
    
    Parameters
    text
    The string to write to the document.

    Obsolete since Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

    writeln()

    void writeln(
      [optional] in DOMString text
    );
    
    Parameters
    text
    The string to write to the document. A newline is automatically appended.

    Implemented by

    Classes that implement this interface:

    Document Tags and Contributors

    Contributors to this page: Sheppy, fscholz, Nickolay, trevorh, Manu, Ms2ger, Neil
    Last updated by: Sheppy,