mozilla
Your Search Results

    inIDOMUtils

    This article is in need of a technical review.

    DOM utility functions.
    Inherits from: nsISupports Last changed in Gecko 22.0 (Firefox 22.0 / Thunderbird 22.0 / SeaMonkey 2.19)

    Implemented by: @mozilla.org/inspector/dom-utils;1 as a service:

    var inIDOMUtils = Components.classes["@mozilla.org/inspector/dom-utils;1"]
                      .getService(Components.interfaces.inIDOMUtils);
    

    Method overview

    void addPseudoClassLock(in nsIDOMElement aElement, in DOMString aPseudoClass);
    void clearPseudoClassLocks(in nsIDOMElement aElement);
    [implicit_jscontext] jsval colorNameToRGB(in DOMString aColorName);
    nsIArray getBindingURLs(in nsIDOMElement aElement);
    nsIDOMNodeList getChildrenForNode(in nsIDOMNode aNode, in boolean aShowingAnonymousContent);
    unsigned long long getContentState(in nsIDOMElement aElement);
    void getCSSPropertyNames([optional] in unsigned long aFlags, [optional] out unsigned long aCount, [retval, array, size_is(aCount)] out wstring aProps); Requires Gecko 22.0
    nsISupportsArray getCSSStyleRules(in nsIDOMElement aElement, [optional] in DOMString aPseudo);
    nsIDOMNode getParentForNode(in nsIDOMNode aNode, in boolean aShowingAnonymousContent);
    unsigned long getRuleLine(in nsIDOMCSSStyleRule aRule);
    unsigned long getRuleColumn(in nsIDOMCSSStyleRule aRule);
    unsigned long getSelectorCount(in nsIDOMCSSStyleRule aRule);
    AString getSelectorText(in nsIDOMCSSStyleRule aRule, in unsigned long aSelectorIndex);
    unsigned long long getSpecificity(in nsIDOMCSSStyleRule aRule, in unsigned long aSelectorIndex);
    nsIDOMFontFaceList getUsedFontFaces(in nsIDOMRange aRange);
    bool hasPseudoClassLock(in nsIDOMElement aElement, in DOMString aPseudoClass);
    boolean isIgnorableWhitespace(in nsIDOMCharacterData aDataNode);
    bool isInheritedProperty(in AString aPropertyName);
    void parseStyleSheet(in nsIDOMCSSStyleSheet aSheet, in DOMString aInput);
    void removePseudoClassLock(in nsIDOMElement aElement, in DOMString aPseudoClass);
    AString rgbToColorName(in octet aR, in octet aG, in octet aB);
    bool selectorMatchesElement(in nsIDOMElement aElement, in nsIDOMCSSStyleRule aRule, in unsigned long aSelectorIndex, [optional] in DOMString aPseudo);
    void setContentState(in nsIDOMElement aElement, in unsigned long long aState);

    Constants

    Constant Value Description
    EXCLUDE_SHORTHANDS (1<<0) Requires Gecko 22.0
    INCLUDE_ALIASES (1<<1) Requires Gecko 22.0

    Content state flags

    The content state flags are used in a bitmask.

    Value State
    1 :active
    2 :focus
    4 :hover
    8 :-moz-drag-over
    16 :target
    1<<29 :-moz-focusring

    Methods

    getBindingURLs()

    Returns an array of nsIURI objects representing the current XML binding for the specified element.

    nsIArray getBindingURLs(
      in nsIDOMElement aElement
    );
    
    Parameters
    aElement
    A DOM Element to retrieve the bindings of.
    Return value

    An array of nsIURI objects representing the current XBL binding (if any) for the element and its hierarchy of base bindings.

    Requires Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4)

    getChildrenForNode()

    Returns a list of DOM nodes that are children of the specified node.

    nsIDOMNodeList getChildrenForNode(
      in nsIDOMNode aNode,
      in boolean aShowingAnonymousContent
    );
    
    Parameters
    aNode
    A DOM Node for which to retrieve the style nodes.
    aShowingAnonymousContent
    Whether you are interested in the XBL flattened tree.
    Return value

    A DOM NodeList of the child nodes. If you have requested anonymous content, then if the element has an XBL binding then this will be the binding's anonymous nodes, otherwise if the element is itself an anonymous node containing an insertion point then this will be a list combining the element's explicit children from its binding parent's anonymous nodes and any children inserted as a result of the insertion point.

    getContentState()

    A bit mask of the supported content state flags, which are listed in Content state flags.

    unsigned long long getContentState(
      in nsIDOMElement aElement
    );
    
    Parameters
    aElement
    A DOM Element to retrieve the content states of.
    Return value

    A bitmask of one of the 6 supported content state flags specified in Content state flags.

    Requires Gecko 22.0 (Firefox 22.0 / Thunderbird 22.0 / SeaMonkey 2.19)

    getCSSPropertyNames()

    Get a list of all our supported property names

    void getCSSPropertyNames(
      in unsigned long aFlags, Optional
      out unsigned long aCount, Optional
      [retval, array, size_is(aCount)] out wstring aProps
    );
    
    Parameters
    aFlags Optional
    Shorthands can be excluded or property aliases included. See constants.
    aCount Optional
    Count
    aProps
    Properties

    getCSSStyleRules()

    Returns an array of the CSS style rules on the specified element.

    nsISupportsArray getCSSStyleRules(
      in nsIDOMElement aElement,
      in DOMString aPseudo Optional
    );
    
    Parameters
    aElement
    A DOM element to retrieve the style rules of.
    aPseudo Optional
    A pseudo element, such as before.
    Return value

    An nsISupportsArray containing all the style rules that currently apply to the element, in ascending order of weight.

    getParentForNode()

    Returns the parent of the specified node.

    nsIDOMNode getParentForNode(
      in nsIDOMNode aNode,
      in boolean aShowingAnonymousContent
    );
    
    Parameters
    aNode
    The node to return the parent of.
    aShowingAnonymousContent
    Whether you are interested in the XBL flattened tree.
    Return value

    Returns the parent of a node. The parent of a document node is the frame/iframe containing that document. If you have requested anonymous content and the element's parent has an XBL binding then the element containing the insertion point is returned instead.

    getRuleLine()

    Returns the line number of the specified CSS style rule in its source file.

    unsigned long getRuleLine(
      in nsIDOMCSSStyleRule aRule
    );
    
    Parameters
    aRule
    The style rule to retrieve the line number of.
    Return value

    The line number of the style rule; the URL of the rule can be obtained from its parent style sheet object.

    getRuleColumn()

    Returns the column number of the specified CSS style rule in its source file.

    unsigned long getRuleColumn(
      in nsIDOMCSSStyleRule aRule
    );
    
    Parameters
    aRule
    The style rule to retrieve the column number of.
    Return value

    The column number of the style rule; the URL of the rule can be obtained from its parent style sheet object.

    Requires Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4)

    getUsedFontFaces()

    Returns a list of the fonts specified using @font-face in the specified portion of the document.

    nsIDOMFontFaceList getUsedFontFaces(
      in nsIDOMRange aRange
    );
    
    Parameters
    aRange
    The DOM range to retrieve the font faces of.
    Return value

    An nsIDOMFontFaceList object listing all the font faces used by the text in the range.

    isIgnorableWhitespace()

    Determines if the specified text node contains only ignorable whitespace characters.

    boolean isIgnorableWhitespace(
      in nsIDOMCharacterData aDataNode
    );
    
    Parameters
    aDataNode
    A DOM CharacterData node; that is, a text node.
    Return value

    true if the node only contains insignificant whitespace. In particular, this will be false if certain CSS white-space styles are in effect.

    isInheritedProperty()

    Determines if the specified string names a CSS property that is inherited by default.

    boolean isInheritedProperty(
      in AString aPropertyName
    );
    
    Parameters
    aPropertyName
    The name of the CSS property.
    Return value

    true if the property is inherited, otherwise false.

    Requires Gecko 15.0 (Firefox 15.0 / Thunderbird 15.0 / SeaMonkey 2.12)

    parseStyleSheet()

    Parse CSS and update the style sheet in place.

    void parseStyleSheet(
      in nsIDOMCSSStyleSheet aSheet,
      in DOMString aInput
    );
    
    Parameters
    aSheet
    A DOMCSSStyleSheet.
    aInput
    A DOMString. The new source string for the style sheet.
    Return value

    void

    setContentState()

    Sets the given element as the current owner of the specified state, and removes that state from the previous owner.

    void setContentState(
      in nsIDOMElement aElement,
      in unsigned long long aState
    );
    
    Parameters
    aElement
    The element to set the content state of.
    aState
    The content state to set. This must be one (and only one) of the values listed in Content state flags.

    selectorMatchesElement()

    Checks if a given selector from a style rule matches an element.

    bool selectorMatchesElement (
      in nsIDOMElement aElement,
      in nsIDOMCSSStyleRule aRule,
      in unsigned long aSelectorIndex,
      in DOMString aPseudo Optional
    )
    
    Parameters
    aElement
    The element to check the selector against.
    aRule
    The style rule containing the selector.
    aSelectorIndex
    The index of the selector.
    aPseudo Optional Requires Gecko 33.0
    A string specifying the pseudo-element to match. May be omitted when checking the regular elements.

    addPseudoClassLock()

    Makes the element take on style properties that would apply if the element had the given pseudo-classes.

    void addPseudoClassLock(
      in nsIDOMElement aElement,
      in DOMString aPseudoClass
    );
    
    Parameters
    aElement
    The element to set the pseudo-class lock on.
    aPseudoClass
    The pseudo-class to set. e.g. ":hover".

    removePseudoClassLock()

    Removes a pseudo-class lock from the element.

    void removePseudoClassLock(
      in nsIDOMElement aElement,
      in DOMString aPseudoClass
    );
    
    Parameters
    aElement
    The element to remove the pseudo-class lock from.
    aPseudoClass
    The pseudo-class to remove the lock of. e.g. ":hover".

    hasPseudoClassLock()

    Checks whether the element element has a particular pseudo-class lock applied.

    boolean hasPseudoClassLock(
      in nsIDOMElement aElement,
      in DOMString aPseudoClass
    );
    
    Parameters
    aElement
    The element to test.
    aPseudoClass
    The pseudo-class lock to test for existence, e.g. ":hover".
    Return value

    true if lock exists, false otherwise

    clearPseudoClassLocks()

    Removes any pseudo-class locks from the element.

    void clearPseudoClassLocks(
      in nsIDOMElement aElement
    );
    
    Parameters
    aElement
    The element to remove the pseudo-class locks from.

    See also

    Document Tags and Contributors

    Contributors to this page: Sheppy, bgrins, fscholz, trevorh, kscarfone, Sebastianz, harth, Neil
    Last updated by: bgrins,