Source code

Revision control

Copy as Markdown

Other Tools

/* -*- 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
*
* Copyright © 2012 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C
* liability, trademark and document use rules apply.
*/
interface nsIScreen;
[Exposed=Window]
interface Element : Node {
[Constant]
readonly attribute DOMString? namespaceURI;
[Constant]
readonly attribute DOMString? prefix;
[Constant]
readonly attribute DOMString localName;
// Not [Constant] because it depends on which document we're in
[Pure]
readonly attribute DOMString tagName;
[CEReactions, Pure]
attribute DOMString id;
[CEReactions, Pure]
attribute DOMString className;
[Constant, PutForwards=value]
readonly attribute DOMTokenList classList;
[SameObject, PutForwards=value]
readonly attribute DOMTokenList part;
[SameObject]
readonly attribute NamedNodeMap attributes;
[Pure]
sequence<DOMString> getAttributeNames();
[Pure]
DOMString? getAttribute(DOMString name);
[Pure]
DOMString? getAttributeNS(DOMString? namespace, DOMString localName);
[CEReactions, NeedsSubjectPrincipal=NonSystem, Throws]
boolean toggleAttribute(DOMString name, optional boolean force);
[CEReactions, NeedsSubjectPrincipal=NonSystem, Throws]
void setAttribute(DOMString name, DOMString value);
[CEReactions, NeedsSubjectPrincipal=NonSystem, Throws]
void setAttributeNS(DOMString? namespace, DOMString name, DOMString value);
[CEReactions, Throws]
void removeAttribute(DOMString name);
[CEReactions, Throws]
void removeAttributeNS(DOMString? namespace, DOMString localName);
[Pure]
boolean hasAttribute(DOMString name);
[Pure]
boolean hasAttributeNS(DOMString? namespace, DOMString localName);
[Pure]
boolean hasAttributes();
[Throws, Pure]
Element? closest(UTF8String selector);
[Throws, Pure]
boolean matches(UTF8String selector);
[Throws, Pure, BinaryName="matches"]
boolean webkitMatchesSelector(UTF8String selector);
[Pure]
HTMLCollection getElementsByTagName(DOMString localName);
[Throws, Pure]
HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
[Pure]
HTMLCollection getElementsByClassName(DOMString classNames);
[CEReactions, Throws]
Element? insertAdjacentElement(DOMString where, Element element); // historical
[Throws]
void insertAdjacentText(DOMString where, DOMString data); // historical
/**
* 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;
/**
* Returns the pseudo-element string if this element represents a
* pseudo-element, or null otherwise.
*/
[ChromeOnly]
readonly attribute DOMString? implementedPseudoElement;
// Selectors API
/**
* Returns whether this element would be selected by the given selector
* string.
*
*/
[Throws, Pure, BinaryName="matches"]
boolean mozMatchesSelector(UTF8String selector);
// Pointer events methods.
[UseCounter, Throws]
void setPointerCapture(long pointerId);
[UseCounter, Throws]
void releasePointerCapture(long pointerId);
boolean hasPointerCapture(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.
*
*/
[Deprecated=ElementSetCapture, Pref="dom.mouse_capture.enabled"]
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.
*/
[Deprecated=ElementReleaseCapture, Pref="dom.mouse_capture.enabled"]
void releaseCapture();
/*
* Chrome-only version of setCapture that works outside of a mousedown event.
*/
[ChromeOnly]
void setCaptureAlways(optional boolean retargetToElement = false);
// Mozilla extensions
// Obsolete methods.
Attr? getAttributeNode(DOMString name);
[CEReactions, Throws]
Attr? setAttributeNode(Attr newAttr);
[CEReactions, Throws]
Attr? removeAttributeNode(Attr oldAttr);
Attr? getAttributeNodeNS(DOMString? namespaceURI, DOMString localName);
[CEReactions, Throws]
Attr? setAttributeNodeNS(Attr newAttr);
[Func="nsContentUtils::IsCallerChromeOrElementTransformGettersEnabled"]
DOMMatrixReadOnly getTransformToAncestor(Element ancestor);
[Func="nsContentUtils::IsCallerChromeOrElementTransformGettersEnabled"]
DOMMatrixReadOnly getTransformToParent();
[Func="nsContentUtils::IsCallerChromeOrElementTransformGettersEnabled"]
DOMMatrixReadOnly getTransformToViewport();
};
dictionary FocusOptions {
boolean preventScroll = false;
boolean focusVisible;
};
interface mixin HTMLOrForeignElement {
[SameObject] readonly attribute DOMStringMap dataset;
// See bug 1389421
// attribute DOMString nonce; // intentionally no [CEReactions]
// See bug 1575154
// [CEReactions] attribute boolean autofocus;
[CEReactions, SetterThrows, Pure] attribute long tabIndex;
[Throws, NeedsCallerType] void focus(optional FocusOptions options = {});
[Throws] void blur();
};
interface mixin ElementCSSInlineStyle {
[SameObject, PutForwards=cssText]
readonly attribute CSSStyleDeclaration style;
};
enum ScrollLogicalPosition { "start", "center", "end", "nearest" };
dictionary ScrollIntoViewOptions : ScrollOptions {
ScrollLogicalPosition block = "start";
ScrollLogicalPosition inline = "nearest";
};
partial interface Element {
DOMRectList getClientRects();
DOMRect getBoundingClientRect();
// scrolling
void scrollIntoView(optional (boolean or ScrollIntoViewOptions) arg = {});
// 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;
void scroll(unrestricted double x, unrestricted double y);
void scroll(optional ScrollToOptions options = {});
void scrollTo(unrestricted double x, unrestricted double y);
void scrollTo(optional ScrollToOptions options = {});
void scrollBy(unrestricted double x, unrestricted double y);
void scrollBy(optional ScrollToOptions options = {});
// mozScrollSnap is used by chrome to perform scroll snapping after the
// user performs actions that may affect scroll position
// mozScrollSnap is deprecated, to be replaced by a web accessible API, such
// as an extension to the ScrollOptions dictionary. See bug 1137937.
[ChromeOnly] void mozScrollSnap();
readonly attribute long clientTop;
readonly attribute long clientLeft;
readonly attribute long clientWidth;
readonly attribute long clientHeight;
// Return the screen coordinates of the element, in CSS pixels relative to
// the window's screen.
[ChromeOnly] readonly attribute long screenX;
[ChromeOnly] readonly attribute long screenY;
[ChromeOnly] readonly attribute nsIScreen? screen;
// Mozilla specific stuff
/* The minimum/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. */
[ChromeOnly] readonly attribute long scrollTopMin;
readonly attribute long scrollTopMax;
[ChromeOnly] readonly attribute long scrollLeftMin;
readonly attribute long scrollLeftMax;
};
partial interface Element {
[CEReactions, SetterNeedsSubjectPrincipal=NonSystem, Pure, SetterThrows, GetterCanOOM]
attribute [LegacyNullToEmptyString] DOMString innerHTML;
[CEReactions, Pure, SetterThrows]
attribute [LegacyNullToEmptyString] DOMString outerHTML;
[CEReactions, Throws]
void insertAdjacentHTML(DOMString position, DOMString text);
};
partial interface Element {
[Throws, Pure]
Element? querySelector(UTF8String selectors);
[Throws, Pure]
NodeList querySelectorAll(UTF8String selectors);
};
dictionary ShadowRootInit {
required ShadowRootMode mode;
[Pref="dom.shadowdom.delegatesFocus.enabled"]
boolean delegatesFocus = false;
[Pref="dom.shadowdom.slot.assign.enabled"]
SlotAssignmentMode slotAssignment = "named";
};
partial interface Element {
// Shadow DOM v1
[Throws, UseCounter]
ShadowRoot attachShadow(ShadowRootInit shadowRootInitDict);
[BinaryName="shadowRootByMode"]
readonly attribute ShadowRoot? shadowRoot;
[Func="Document::IsCallerChromeOrAddon", BinaryName="shadowRoot"]
readonly attribute ShadowRoot? openOrClosedShadowRoot;
[BinaryName="assignedSlotByMode"]
readonly attribute HTMLSlotElement? assignedSlot;
[ChromeOnly, BinaryName="assignedSlot"]
readonly attribute HTMLSlotElement? openOrClosedAssignedSlot;
[CEReactions, Unscopable, SetterThrows]
attribute DOMString slot;
};
Element includes ChildNode;
Element includes NonDocumentTypeChildNode;
Element includes ParentNode;
Element includes Animatable;
Element includes GeometryUtils;
Element includes AccessibilityRole;
Element includes AriaAttributes;
partial interface Element {
[NewObject, NeedsCallerType]
Promise<void> requestFullscreen();
[NewObject, BinaryName="requestFullscreen", NeedsCallerType, Deprecated="MozRequestFullScreenDeprecatedPrefix"]
Promise<void> mozRequestFullScreen();
// Events handlers
attribute EventHandler onfullscreenchange;
attribute EventHandler onfullscreenerror;
};
partial interface Element {
[NeedsCallerType, Pref="dom.pointer-lock.enabled"]
void requestPointerLock();
};
// Mozilla-specific additions to support devtools
partial interface Element {
// Support reporting of Flexbox properties
/**
* If this element has a display:flex or display:inline-flex style,
* this property returns an object with computed values for flex
* properties, as well as a property that exposes the flex lines
* in this container.
*/
[ChromeOnly, Pure]
Flex? getAsFlexContainer();
// Support reporting of Grid properties
/**
* If this element has a display:grid or display:inline-grid style,
* this property returns an object with computed values for grid
* tracks and lines.
*/
[ChromeOnly, Pure]
sequence<Grid> getGridFragments();
/**
* Returns whether there are any grid fragments on this element.
*/
[ChromeOnly, Pure]
boolean hasGridFragments();
/**
* Returns a sequence of all the descendent elements of this element
* that have display:grid or display:inline-grid style and generate
* a frame.
*/
[ChromeOnly, Pure]
sequence<Element> getElementsWithGrid();
/**
* Set attribute on the Element with a customized Content-Security-Policy
* appropriate to devtools, which includes:
* style-src 'unsafe-inline'
*/
[ChromeOnly, CEReactions, Throws]
void setAttributeDevtools(DOMString name, DOMString value);
[ChromeOnly, CEReactions, Throws]
void setAttributeDevtoolsNS(DOMString? namespace, DOMString name, DOMString value);
/**
* Provide a direct way to determine if this Element has visible
* scrollbars. Flushes layout.
*/
[ChromeOnly]
readonly attribute boolean hasVisibleScrollbars;
};
// These variables are used in vtt.js, they are used for positioning vtt cues.
partial interface Element {
// These two attributes are a double version of the clientHeight and the
// clientWidth.
[ChromeOnly]
readonly attribute double clientHeightDouble;
[ChromeOnly]
readonly attribute double clientWidthDouble;
// This attribute returns the block size of the first line box under the different
// writing directions. If the direction is horizontal, it represents box's
// height. If the direction is vertical, it represents box's width.
[ChromeOnly]
readonly attribute double firstLineBoxBSize;
};
dictionary SetHTMLOptions {
Sanitizer sanitizer;
};
partial interface Element {
[SecureContext, UseCounter, Throws, Pref="dom.security.sanitizer.enabled"]
void setHTML(DOMString aInnerHTML, optional SetHTMLOptions options = {});
};