The Tor Browser / file revision

 /* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */

 /* This Source Code Form is subject to the terms of the Mozilla Public

  * License, v. 2.0. If a copy of the MPL was not distributed with this file,

  * You can obtain one at http://mozilla.org/MPL/2.0/.

  *

  * The origin of this IDL file is

  * http://dom.spec.whatwg.org/#element and

  * http://domparsing.spec.whatwg.org/ and

  * http://dev.w3.org/csswg/cssom-view/ and

  * http://www.w3.org/TR/selectors-api/

  *

  * Copyright © 2012 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C

  * liability, trademark and document use rules apply.

  */

 interface Element : Node {

 /*

   We haven't moved these from Node to Element like the spec wants.

   [Throws]

   readonly attribute DOMString? namespaceURI;

   readonly attribute DOMString? prefix;

   readonly attribute DOMString localName;

 */

   // Not [Constant] because it depends on which document we're in

   [Pure]

   readonly attribute DOMString tagName;

   [Pure]

            attribute DOMString id;

 /*

   FIXME Bug 810677 Move className from HTMLElement to Element

            attribute DOMString className;

 */

   [Constant]

   readonly attribute DOMTokenList? classList;

   [SameObject]

   readonly attribute MozNamedAttrMap attributes;

   [Pure]

   DOMString? getAttribute(DOMString name);

   [Pure]

   DOMString? getAttributeNS(DOMString? namespace, DOMString localName);

   [Throws]

   void setAttribute(DOMString name, DOMString value);

   [Throws]

   void setAttributeNS(DOMString? namespace, DOMString name, DOMString value);

   [Throws]

   void removeAttribute(DOMString name);

   [Throws]

   void removeAttributeNS(DOMString? namespace, DOMString localName);

   [Pure]

   boolean hasAttribute(DOMString name);

   [Pure]

   boolean hasAttributeNS(DOMString? namespace, DOMString localName);

   [Pure]

   HTMLCollection getElementsByTagName(DOMString localName);

   [Throws, Pure]

   HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);

   [Pure]

   HTMLCollection getElementsByClassName(DOMString classNames);

   /**

    * The ratio of font-size-inflated text font size to computed font

    * size for this element. This will query the element for its primary frame,

    * and then use this to get font size inflation information about the frame.

    * This will be 1.0 if font size inflation is not enabled, and -1.0 if an

    * error occurred during the retrieval of the font size inflation.

    *

    * @note The font size inflation ratio that is returned is actually the

    *       font size inflation data for the element's _primary frame_, not the

    *       element itself, but for most purposes, this should be sufficient.

    */

   [ChromeOnly]

   readonly attribute float fontSizeInflation;

   // Mozilla specific stuff

   [Pure]

            attribute EventHandler onwheel;

   // Selectors API

   /**

    * Returns whether this element would be selected by the given selector

    * string.

    *

    * See <http://dev.w3.org/2006/webapi/selectors-api2/#matchesselector>

    */

   [Throws, Pure]

   boolean mozMatchesSelector(DOMString selector);

   // Pointer events methods.

   [Throws, Pref="dom.w3c_pointer_events.enabled"]

   void setPointerCapture(long pointerId);

   [Throws, Pref="dom.w3c_pointer_events.enabled"]

   void releasePointerCapture(long pointerId);

   // Proprietary extensions

   /**

    * Set this during a mousedown event to grab and retarget all mouse events

    * to this element until the mouse button is released or releaseCapture is

    * called. If retargetToElement is true, then all events are targetted at

    * this element. If false, events can also fire at descendants of this

    * element.

    * 

    */

   void setCapture(optional boolean retargetToElement = false);

   /**

    * If this element has captured the mouse, release the capture. If another

    * element has captured the mouse, this method has no effect.

    */

   void releaseCapture();

   // Mozilla extensions

   /**

    * Requests that this element be made the full-screen element, as per the DOM

    * full-screen api.

    *

    * @see <https://wiki.mozilla.org/index.php?title=Gecko:FullScreenAPI>

    */

   void mozRequestFullScreen();

   /**

    * Requests that this element be made the pointer-locked element, as per the DOM

    * pointer lock api.

    *

    * @see <http://dvcs.w3.org/hg/pointerlock/raw-file/default/index.html>

    */

   void mozRequestPointerLock();

   // Obsolete methods.

   Attr? getAttributeNode(DOMString name);

   [Throws]

   Attr? setAttributeNode(Attr newAttr);

   [Throws]

   Attr? removeAttributeNode(Attr oldAttr);

   Attr? getAttributeNodeNS(DOMString? namespaceURI, DOMString localName);

   [Throws]

   Attr? setAttributeNodeNS(Attr newAttr);

   [ChromeOnly]

   /**

    * Scrolls the element by (dx, dy) CSS pixels without doing any

    * layout flushing.

    */

   boolean scrollByNoFlush(long dx, long dy);

 };

 // http://dev.w3.org/csswg/cssom-view/#extensions-to-the-element-interface

 partial interface Element {

   DOMRectList getClientRects();

   DOMRect getBoundingClientRect();

   // scrolling

   void scrollIntoView();

   void scrollIntoView(boolean top);

   // None of the CSSOM attributes are [Pure], because they flush

            attribute long scrollTop;   // scroll on setting

            attribute long scrollLeft;  // scroll on setting

   readonly attribute long scrollWidth;

   readonly attribute long scrollHeight;

   readonly attribute long clientTop;

   readonly attribute long clientLeft;

   readonly attribute long clientWidth;

   readonly attribute long clientHeight;

   // Mozilla specific stuff

   /* The maximum offset that the element can be scrolled to

      (i.e., the value that scrollLeft/scrollTop would be clamped to if they were

      set to arbitrarily large values. */

   readonly attribute long scrollTopMax;

   readonly attribute long scrollLeftMax;

 };

 // http://dvcs.w3.org/hg/undomanager/raw-file/tip/undomanager.html

 partial interface Element {

   [Pref="dom.undo_manager.enabled"]

   readonly attribute UndoManager? undoManager;

   [SetterThrows,Pref="dom.undo_manager.enabled"]

   attribute boolean undoScope;

 };

 // http://domparsing.spec.whatwg.org/#extensions-to-the-element-interface

 partial interface Element {

   [Pure,SetterThrows,TreatNullAs=EmptyString]

   attribute DOMString innerHTML;

   [Pure,SetterThrows,TreatNullAs=EmptyString]

   attribute DOMString outerHTML;

   [Throws]

   void insertAdjacentHTML(DOMString position, DOMString text);

 };

 // http://www.w3.org/TR/selectors-api/#interface-definitions

 partial interface Element {

   [Throws, Pure]

   Element?  querySelector(DOMString selectors);

   [Throws, Pure]

   NodeList  querySelectorAll(DOMString selectors);

 };

 // https://dvcs.w3.org/hg/webcomponents/raw-file/tip/spec/shadow/index.html#shadow-root-object

 partial interface Element {

   [Throws,Pref="dom.webcomponents.enabled"]

   ShadowRoot createShadowRoot();

   [Pref="dom.webcomponents.enabled"]

   readonly attribute ShadowRoot? shadowRoot;

 };

 Element implements ChildNode;

 Element implements NonDocumentTypeChildNode;

 Element implements ParentNode;