DataListElement#

class DataListElement extends HtmlElement

Annotations: @SupportedBrowser.new(SupportedBrowser.CHROME), @SupportedBrowser.new(SupportedBrowser.FIREFOX), @SupportedBrowser.new(SupportedBrowser.IE, '10'), @SupportedBrowser.new(SupportedBrowser.SAFARI), @Native.new("HTMLDataListElement")

Inheritance

Object → EventTarget → Node → Element → HtmlElement → DataListElement

Constructors#

DataListElement() factory#

factory DataListElement()

Implementation

factory DataListElement() =>
    document.createElement("datalist") as DataListElement;

Properties#

accessibleNode no setter inherited#

AccessibleNode? get accessibleNode

Inherited from Element.

Implementation

AccessibleNode? get accessibleNode native;

assignedSlot no setter inherited#

SlotElement? get assignedSlot

Inherited from Element.

Implementation

SlotElement? get assignedSlot native;

attributes read / write inherited#

Map<String, String> get attributes

All attributes on this element.

Any modifications to the attribute map will automatically be applied to this element.

This only includes attributes which are not in a namespace (such as 'xlink:href'), additional attributes can be accessed via getNamespacedAttributes.

Inherited from Element.

Implementation

Map<String, String> get attributes => new _ElementAttributeMap(this);

set attributes(Map<String, String> value) {
  Map<String, String> attributes = this.attributes;
  attributes.clear();
  for (String key in value.keys) {
    attributes[key] = value[key]!;
  }
}

baseUri no setter inherited#

String? get baseUri

Inherited from Node.

Implementation

@JSName('baseURI')
String? get baseUri native;

borderEdge no setter inherited#

CssRect get borderEdge

Access the dimensions and position of this element's content + padding + border box.

This returns a rectangle with the dimensions actually available for content in this element, in pixels, regardless of this element's box-sizing property. Unlike getBoundingClientRect, the dimensions of this rectangle will return the same numerical height if the element is hidden or not. This can be used to retrieve jQuery's outerHeight value for an element.

Important note: use of this method will perform CSS calculations that can trigger a browser reflow. Therefore, use of this property during an animation frame is discouraged. See also: Browser Reflow

Inherited from Element.

Implementation

CssRect get borderEdge => new _BorderCssRect(this);

childNodes no setter inherited#

List<Node> get childNodes

A list of this node's children.

Other resources

Node.childNodes from MDN.

Inherited from Node.

Implementation

@Returns('NodeList')
@Creates('NodeList')
List<Node> get childNodes native;

children read / write inherited#

List<Element> get children

List of the direct children of this element.

This collection can be used to add and remove elements from the document.

var item = new DivElement();
item.text = 'Something';
document.body.children.add(item) // Item is now displayed on the page.
for (var element in document.body.children) {
  element.style.background = 'red'; // Turns every child of body red.
}

Inherited from Element.

Implementation

List<Element> get children => new _ChildrenElementList._wrap(this);

set children(List<Element> value) {
  &#47;&#47; Copy list first since we don't want liveness during iteration.
  var copy = value.toList();
  var children = this.children;
  children.clear();
  children.addAll(copy);
}

classes read / write inherited#

CssClassSet get classes

The set of CSS classes applied to this element.

This set makes it easy to add, remove or toggle the classes applied to this element.

element.classes.add('selected');
element.classes.toggle('isOnline');
element.classes.remove('selected');

Inherited from Element.

Implementation

CssClassSet get classes => new _ElementCssClassSet(this);

set classes(Iterable<String> value) {
  &#47;&#47; TODO(sra): Do this without reading the classes in clear() and addAll(),
  &#47;&#47; or writing the classes in clear().
  CssClassSet classSet = classes;
  classSet.clear();
  classSet.addAll(value);
}

className read / write inherited#

String get className

Inherited from Element.

Implementation

String get className native;

set className(String value) native;

client no setter inherited#

Rectangle<num> get client

Gets the position of this element relative to the client area of the page.

Inherited from Element.

Implementation

Rectangle get client =>
    new Rectangle(clientLeft!, clientTop!, clientWidth, clientHeight);

clientHeight no setter inherited#

int get clientHeight

Inherited from Element.

Implementation

int get clientHeight native;

clientLeft no setter inherited#

int? get clientLeft

Inherited from Element.

Implementation

int? get clientLeft native;

clientTop no setter inherited#

int? get clientTop

Inherited from Element.

Implementation

int? get clientTop native;

clientWidth no setter inherited#

int get clientWidth

Inherited from Element.

Implementation

int get clientWidth native;

computedName no setter inherited#

String? get computedName

Inherited from Element.

Implementation

String? get computedName native;

computedRole no setter inherited#

String? get computedRole

Inherited from Element.

Implementation

String? get computedRole native;

contentEdge no setter inherited#

CssRect get contentEdge

Access this element's content position.

Inherited from Element.

Implementation

CssRect get contentEdge => new _ContentCssRect(this);

contentEditable read / write inherited#

String get contentEditable

Inherited from Element.

Implementation

String get contentEditable native;

set contentEditable(String value) native;

dataset read / write inherited#

Map<String, String> get dataset

Allows access to all custom data attributes (data-*) set on this element.

Any data attributes in the markup will be converted to camel-cased keys in the map based on these conversion rules.

For example, HTML specified as:

<div data-my-random-value='value'></div>

Would be accessed in Dart as:

var value = element.dataset['myRandomValue'];

See also:

Inherited from Element.

Implementation

Map<String, String> get dataset => new _DataAttributeMap(attributes);

set dataset(Map<String, String> value) {
  final data = this.dataset;
  data.clear();
  for (String key in value.keys) {
    data[key] = value[key]!;
  }
}

dir read / write inherited#

String? get dir

Inherited from Element.

Implementation

String? get dir native;

set dir(String? value) native;

documentOffset no setter inherited#

Point<num> get documentOffset

Provides the coordinates of the element relative to the top of the document.

This method is the Dart equivalent to jQuery's offset method.

Inherited from Element.

Implementation

Point get documentOffset => offsetTo(document.documentElement!);

draggable read / write inherited#

bool get draggable

Indicates whether the element can be dragged and dropped.

Other resources

Drag and drop sample based on the tutorial from HTML5Rocks.
Drag and drop specification from WHATWG.

Inherited from Element.

Implementation

bool get draggable native;

set draggable(bool value) native;

firstChild no setter inherited#

Node? get firstChild

The first child of this node.

Other resources

Node.firstChild from MDN.

Inherited from Node.

Implementation

Node? get firstChild native;

hashCode no setter inherited#

int get hashCode

Inherited from Interceptor.

Implementation

int get hashCode => Primitives.objectHashCode(this);

hidden read / write inherited#

bool get hidden

Indicates whether the element is not relevant to the page's current state.

Other resources

Hidden attribute specification from WHATWG.

Inherited from Element.

Implementation

bool get hidden native;

set hidden(bool value) native;

id read / write inherited#

String get id

Inherited from Element.

Implementation

String get id native;

set id(String value) native;

inert read / write inherited#

bool? get inert

Inherited from Element.

Implementation

bool? get inert native;

set inert(bool? value) native;

innerHtml read / write inherited#

String? get innerHtml

Parses the HTML fragment and sets it as the contents of this element.

This uses the default sanitization behavior to sanitize the HTML fragment, use setInnerHtml to override the default behavior.

Inherited from Element.

Implementation

String? get innerHtml => _innerHtml;

set innerHtml(String? html) {
  this.setInnerHtml(html);
}

innerText read / write inherited#

String get innerText

Inherited from Element.

Implementation

@JSName('innerText')
String get innerText native;

set innerText(String value) native;

inputMode read / write inherited#

String? get inputMode

Inherited from Element.

Implementation

String? get inputMode native;

set inputMode(String? value) native;

isConnected no setter inherited#

bool? get isConnected

Inherited from Node.

Implementation

bool? get isConnected native;

isContentEditable no setter inherited#

bool? get isContentEditable

Inherited from Element.

Implementation

bool? get isContentEditable native;

lang read / write inherited#

String? get lang

Inherited from Element.

Implementation

String? get lang native;

set lang(String? value) native;

lastChild no setter inherited#

Node? get lastChild

The last child of this node.

Other resources

Node.lastChild from MDN.

Inherited from Node.

Implementation

Node? get lastChild native;

localName no setter inherited#

String get localName

Inherited from Element.

Implementation

@Returns('String')
&#47;&#47; Non-null for Elements.
String get localName => JS('String', '#', _localName);

marginEdge no setter inherited#

CssRect get marginEdge

Access the dimensions and position of this element's content + padding + border + margin box.

Important note: use of this method will perform CSS calculations that can trigger a browser reflow. Therefore, use of this property during an animation frame is discouraged. See also: Browser Reflow

Inherited from Element.

Implementation

CssRect get marginEdge => new _MarginCssRect(this);

namespaceUri no setter inherited#

String? get namespaceUri

A URI that identifies the XML namespace of this element.

null if no namespace URI is specified.

Other resources

Node.namespaceURI from W3C.

Inherited from Element.

Implementation

String? get namespaceUri => _namespaceUri;

nextElementSibling no setter inherited#

Element? get nextElementSibling

Inherited from Element.

Implementation

Element? get nextElementSibling native;

nextNode no setter inherited#

Node? get nextNode

The next sibling node.

Other resources

Node.nextSibling from MDN.

Inherited from Node.

Implementation

@JSName('nextSibling')
&#47;**
 * The next sibling node.
 *
 * ## Other resources
 *
 * * [Node.nextSibling](https:&#47;&#47;developer.mozilla.org&#47;en-US&#47;docs&#47;Web&#47;API&#47;Node.nextSibling)
 *   from MDN.
 *&#47;
Node? get nextNode native;

nodeName no setter inherited#

String? get nodeName

The name of this node.

This varies by this node's nodeType.

Other resources

Node.nodeName from MDN. This page contains a table of nodeName values for each nodeType.

Inherited from Node.

Implementation

String? get nodeName native;

nodes read / write inherited#

List<Node> get nodes

A modifiable list of this node's children.

Inherited from Node.

Implementation

List<Node> get nodes {
  return new _ChildNodeListLazy(this);
}

set nodes(Iterable<Node> value) {
  &#47;&#47; Copy list first since we don't want liveness during iteration.
  &#47;&#47; TODO(jacobr): there is a better way to do this.
  var copy = value.toList();
  text = '';
  for (Node node in copy) {
    append(node);
  }
}

nodeType no setter inherited#

int get nodeType

The type of node.

This value is one of:

ATTRIBUTE_NODE if this node is an attribute.
CDATA_SECTION_NODE if this node is a CDataSection.
COMMENT_NODE if this node is a Comment.
DOCUMENT_FRAGMENT_NODE if this node is a DocumentFragment.
DOCUMENT_NODE if this node is a Document.
DOCUMENT_TYPE_NODE if this node is a _DocumentType node.
ELEMENT_NODE if this node is an Element.
ENTITY_NODE if this node is an entity.
ENTITY_REFERENCE_NODE if this node is an entity reference.
NOTATION_NODE if this node is a notation.
PROCESSING_INSTRUCTION_NODE if this node is a ProcessingInstruction.
TEXT_NODE if this node is a Text node.

Other resources

Node.nodeType from MDN.

Inherited from Node.

Implementation

int get nodeType native;

nodeValue no setter inherited#

String? get nodeValue

The value of this node.

This varies by this type's nodeType.

Other resources

Node.nodeValue from MDN. This page contains a table of nodeValue values for each nodeType.

Inherited from Node.

Implementation

String? get nodeValue native;

nonce read / write inherited#

String? get nonce

Inherited from HtmlElement.

Implementation

String? get nonce native;

set nonce(String? value) native;

offset no setter inherited#

Rectangle<num> get offset

Gets the offset of this element relative to its offsetParent.

Inherited from Element.

Implementation

Rectangle get offset =>
    new Rectangle(offsetLeft, offsetTop, offsetWidth, offsetHeight);

offsetHeight no setter inherited#

int get offsetHeight

Inherited from Element.

Implementation

int get offsetHeight => JS<num>('num', '#.offsetHeight', this).round();

offsetLeft no setter inherited#

int get offsetLeft

Inherited from Element.

Implementation

int get offsetLeft => JS<num>('num', '#.offsetLeft', this).round();

offsetParent no setter inherited#

Element? get offsetParent

Inherited from Element.

Implementation

Element? get offsetParent native;

offsetTop no setter inherited#

int get offsetTop

Inherited from Element.

Implementation

int get offsetTop => JS<num>('num', '#.offsetTop', this).round();

offsetWidth no setter inherited#

int get offsetWidth

Inherited from Element.

Implementation

int get offsetWidth => JS<num>('num', '#.offsetWidth', this).round();

on no setter inherited#

ElementEvents get on

This is an ease-of-use accessor for event streams which should only be used when an explicit accessor is not available.

Inherited from Element.

Implementation

ElementEvents get on => new ElementEvents(this);

onAbort no setter inherited#

ElementStream<Event> get onAbort

Stream of abort events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onAbort => abortEvent.forElement(this);

onBeforeCopy no setter inherited#

ElementStream<Event> get onBeforeCopy

Stream of beforecopy events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onBeforeCopy => beforeCopyEvent.forElement(this);

onBeforeCut no setter inherited#

ElementStream<Event> get onBeforeCut

Stream of beforecut events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onBeforeCut => beforeCutEvent.forElement(this);

onBeforePaste no setter inherited#

ElementStream<Event> get onBeforePaste

Stream of beforepaste events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onBeforePaste => beforePasteEvent.forElement(this);

onBlur no setter inherited#

ElementStream<Event> get onBlur

Stream of blur events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onBlur => blurEvent.forElement(this);

onCanPlay no setter inherited#

ElementStream<Event> get onCanPlay

Inherited from Element.

Implementation

ElementStream<Event> get onCanPlay => canPlayEvent.forElement(this);

onCanPlayThrough no setter inherited#

ElementStream<Event> get onCanPlayThrough

Inherited from Element.

Implementation

ElementStream<Event> get onCanPlayThrough =>
    canPlayThroughEvent.forElement(this);

onChange no setter inherited#

ElementStream<Event> get onChange

Stream of change events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onChange => changeEvent.forElement(this);

onClick no setter inherited#

ElementStream<MouseEvent> get onClick

Stream of click events handled by this Element.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onClick => clickEvent.forElement(this);

onContextMenu no setter inherited#

ElementStream<MouseEvent> get onContextMenu

Stream of contextmenu events handled by this Element.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onContextMenu =>
    contextMenuEvent.forElement(this);

onCopy no setter inherited#

ElementStream<ClipboardEvent> get onCopy

Stream of copy events handled by this Element.

Inherited from Element.

Implementation

ElementStream<ClipboardEvent> get onCopy => copyEvent.forElement(this);

onCut no setter inherited#

ElementStream<ClipboardEvent> get onCut

Stream of cut events handled by this Element.

Inherited from Element.

Implementation

ElementStream<ClipboardEvent> get onCut => cutEvent.forElement(this);

onDoubleClick no setter inherited#

ElementStream<Event> get onDoubleClick

Stream of doubleclick events handled by this Element.

Inherited from Element.

Implementation

@DomName('Element.ondblclick')
ElementStream<Event> get onDoubleClick => doubleClickEvent.forElement(this);

onDrag no setter inherited#

ElementStream<MouseEvent> get onDrag

A stream of drag events fired when this element currently being dragged.

A drag event is added to this stream as soon as the drag begins. A drag event is also added to this stream at intervals while the drag operation is still ongoing.

Other resources

Drag and drop sample based on the tutorial from HTML5Rocks.
Drag and drop specification from WHATWG.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onDrag => dragEvent.forElement(this);

onDragEnd no setter inherited#

ElementStream<MouseEvent> get onDragEnd

A stream of dragend events fired when this element completes a drag operation.

Other resources

Drag and drop sample based on the tutorial from HTML5Rocks.
Drag and drop specification from WHATWG.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onDragEnd => dragEndEvent.forElement(this);

onDragEnter no setter inherited#

ElementStream<MouseEvent> get onDragEnter

A stream of dragenter events fired when a dragged object is first dragged over this element.

Other resources

Drag and drop sample based on the tutorial from HTML5Rocks.
Drag and drop specification from WHATWG.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onDragEnter => dragEnterEvent.forElement(this);

onDragLeave no setter inherited#

ElementStream<MouseEvent> get onDragLeave

A stream of dragleave events fired when an object being dragged over this element leaves this element's target area.

Other resources

Drag and drop sample based on the tutorial from HTML5Rocks.
Drag and drop specification from WHATWG.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onDragLeave => dragLeaveEvent.forElement(this);

onDragOver no setter inherited#

ElementStream<MouseEvent> get onDragOver

A stream of dragover events fired when a dragged object is currently being dragged over this element.

Other resources

Drag and drop sample based on the tutorial from HTML5Rocks.
Drag and drop specification from WHATWG.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onDragOver => dragOverEvent.forElement(this);

onDragStart no setter inherited#

ElementStream<MouseEvent> get onDragStart

A stream of dragstart events fired when this element starts being dragged.

Other resources

Drag and drop sample based on the tutorial from HTML5Rocks.
Drag and drop specification from WHATWG.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onDragStart => dragStartEvent.forElement(this);

onDrop no setter inherited#

ElementStream<MouseEvent> get onDrop

A stream of drop events fired when a dragged object is dropped on this element.

Other resources

Drag and drop sample based on the tutorial from HTML5Rocks.
Drag and drop specification from WHATWG.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onDrop => dropEvent.forElement(this);

onDurationChange no setter inherited#

ElementStream<Event> get onDurationChange

Inherited from Element.

Implementation

ElementStream<Event> get onDurationChange =>
    durationChangeEvent.forElement(this);

onEmptied no setter inherited#

ElementStream<Event> get onEmptied

Inherited from Element.

Implementation

ElementStream<Event> get onEmptied => emptiedEvent.forElement(this);

onEnded no setter inherited#

ElementStream<Event> get onEnded

Inherited from Element.

Implementation

ElementStream<Event> get onEnded => endedEvent.forElement(this);

onError no setter inherited#

ElementStream<Event> get onError

Stream of error events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onError => errorEvent.forElement(this);

onFocus no setter inherited#

ElementStream<Event> get onFocus

Stream of focus events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onFocus => focusEvent.forElement(this);

onFullscreenChange no setter inherited#

ElementStream<Event> get onFullscreenChange

Stream of fullscreenchange events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onFullscreenChange =>
    fullscreenChangeEvent.forElement(this);

onFullscreenError no setter inherited#

ElementStream<Event> get onFullscreenError

Stream of fullscreenerror events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onFullscreenError =>
    fullscreenErrorEvent.forElement(this);

onInput no setter inherited#

ElementStream<Event> get onInput

Stream of input events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onInput => inputEvent.forElement(this);

onInvalid no setter inherited#

ElementStream<Event> get onInvalid

Stream of invalid events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onInvalid => invalidEvent.forElement(this);

onKeyDown no setter inherited#

ElementStream<KeyboardEvent> get onKeyDown

Stream of keydown events handled by this Element.

Inherited from Element.

Implementation

ElementStream<KeyboardEvent> get onKeyDown => keyDownEvent.forElement(this);

onKeyPress no setter inherited#

ElementStream<KeyboardEvent> get onKeyPress

Stream of keypress events handled by this Element.

Inherited from Element.

Implementation

ElementStream<KeyboardEvent> get onKeyPress => keyPressEvent.forElement(this);

onKeyUp no setter inherited#

ElementStream<KeyboardEvent> get onKeyUp

Stream of keyup events handled by this Element.

Inherited from Element.

Implementation

ElementStream<KeyboardEvent> get onKeyUp => keyUpEvent.forElement(this);

onLoad no setter inherited#

ElementStream<Event> get onLoad

Stream of load events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onLoad => loadEvent.forElement(this);

onLoadedData no setter inherited#

ElementStream<Event> get onLoadedData

Inherited from Element.

Implementation

ElementStream<Event> get onLoadedData => loadedDataEvent.forElement(this);

onLoadedMetadata no setter inherited#

ElementStream<Event> get onLoadedMetadata

Inherited from Element.

Implementation

ElementStream<Event> get onLoadedMetadata =>
    loadedMetadataEvent.forElement(this);

onMouseDown no setter inherited#

ElementStream<MouseEvent> get onMouseDown

Stream of mousedown events handled by this Element.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onMouseDown => mouseDownEvent.forElement(this);

onMouseEnter no setter inherited#

ElementStream<MouseEvent> get onMouseEnter

Stream of mouseenter events handled by this Element.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onMouseEnter =>
    mouseEnterEvent.forElement(this);

onMouseLeave no setter inherited#

ElementStream<MouseEvent> get onMouseLeave

Stream of mouseleave events handled by this Element.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onMouseLeave =>
    mouseLeaveEvent.forElement(this);

onMouseMove no setter inherited#

ElementStream<MouseEvent> get onMouseMove

Stream of mousemove events handled by this Element.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onMouseMove => mouseMoveEvent.forElement(this);

onMouseOut no setter inherited#

ElementStream<MouseEvent> get onMouseOut

Stream of mouseout events handled by this Element.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onMouseOut => mouseOutEvent.forElement(this);

onMouseOver no setter inherited#

ElementStream<MouseEvent> get onMouseOver

Stream of mouseover events handled by this Element.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onMouseOver => mouseOverEvent.forElement(this);

onMouseUp no setter inherited#

ElementStream<MouseEvent> get onMouseUp

Stream of mouseup events handled by this Element.

Inherited from Element.

Implementation

ElementStream<MouseEvent> get onMouseUp => mouseUpEvent.forElement(this);

onMouseWheel no setter inherited#

ElementStream<WheelEvent> get onMouseWheel

Stream of mousewheel events handled by this Element.

Inherited from Element.

Implementation

ElementStream<WheelEvent> get onMouseWheel =>
    mouseWheelEvent.forElement(this);

onPaste no setter inherited#

ElementStream<ClipboardEvent> get onPaste

Stream of paste events handled by this Element.

Inherited from Element.

Implementation

ElementStream<ClipboardEvent> get onPaste => pasteEvent.forElement(this);

onPause no setter inherited#

ElementStream<Event> get onPause

Inherited from Element.

Implementation

ElementStream<Event> get onPause => pauseEvent.forElement(this);

onPlay no setter inherited#

ElementStream<Event> get onPlay

Inherited from Element.

Implementation

ElementStream<Event> get onPlay => playEvent.forElement(this);

onPlaying no setter inherited#

ElementStream<Event> get onPlaying

Inherited from Element.

Implementation

ElementStream<Event> get onPlaying => playingEvent.forElement(this);

onRateChange no setter inherited#

ElementStream<Event> get onRateChange

Inherited from Element.

Implementation

ElementStream<Event> get onRateChange => rateChangeEvent.forElement(this);

onReset no setter inherited#

ElementStream<Event> get onReset

Stream of reset events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onReset => resetEvent.forElement(this);

onResize no setter inherited#

ElementStream<Event> get onResize

Inherited from Element.

Implementation

ElementStream<Event> get onResize => resizeEvent.forElement(this);

onScroll no setter inherited#

ElementStream<Event> get onScroll

Stream of scroll events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onScroll => scrollEvent.forElement(this);

onSearch no setter inherited#

ElementStream<Event> get onSearch

Stream of search events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onSearch => searchEvent.forElement(this);

onSeeked no setter inherited#

ElementStream<Event> get onSeeked

Inherited from Element.

Implementation

ElementStream<Event> get onSeeked => seekedEvent.forElement(this);

onSeeking no setter inherited#

ElementStream<Event> get onSeeking

Inherited from Element.

Implementation

ElementStream<Event> get onSeeking => seekingEvent.forElement(this);

onSelect no setter inherited#

ElementStream<Event> get onSelect

Stream of select events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onSelect => selectEvent.forElement(this);

onSelectStart no setter inherited#

ElementStream<Event> get onSelectStart

Stream of selectstart events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onSelectStart => selectStartEvent.forElement(this);

onStalled no setter inherited#

ElementStream<Event> get onStalled

Inherited from Element.

Implementation

ElementStream<Event> get onStalled => stalledEvent.forElement(this);

onSubmit no setter inherited#

ElementStream<Event> get onSubmit

Stream of submit events handled by this Element.

Inherited from Element.

Implementation

ElementStream<Event> get onSubmit => submitEvent.forElement(this);

onSuspend no setter inherited#

ElementStream<Event> get onSuspend

Inherited from Element.

Implementation

ElementStream<Event> get onSuspend => suspendEvent.forElement(this);

onTimeUpdate no setter inherited#

ElementStream<Event> get onTimeUpdate

Inherited from Element.

Implementation

ElementStream<Event> get onTimeUpdate => timeUpdateEvent.forElement(this);

onTouchCancel no setter inherited#

ElementStream<TouchEvent> get onTouchCancel

Stream of touchcancel events handled by this Element.

Inherited from Element.

Implementation

ElementStream<TouchEvent> get onTouchCancel =>
    touchCancelEvent.forElement(this);

onTouchEnd no setter inherited#

ElementStream<TouchEvent> get onTouchEnd

Stream of touchend events handled by this Element.

Inherited from Element.

Implementation

ElementStream<TouchEvent> get onTouchEnd => touchEndEvent.forElement(this);

onTouchEnter no setter inherited#

ElementStream<TouchEvent> get onTouchEnter

Stream of touchenter events handled by this Element.

Inherited from Element.

Implementation

ElementStream<TouchEvent> get onTouchEnter =>
    touchEnterEvent.forElement(this);

onTouchLeave no setter inherited#

ElementStream<TouchEvent> get onTouchLeave

Stream of touchleave events handled by this Element.

Inherited from Element.

Implementation

ElementStream<TouchEvent> get onTouchLeave =>
    touchLeaveEvent.forElement(this);

onTouchMove no setter inherited#

ElementStream<TouchEvent> get onTouchMove

Stream of touchmove events handled by this Element.

Inherited from Element.

Implementation

ElementStream<TouchEvent> get onTouchMove => touchMoveEvent.forElement(this);

onTouchStart no setter inherited#

ElementStream<TouchEvent> get onTouchStart

Stream of touchstart events handled by this Element.

Inherited from Element.

Implementation

ElementStream<TouchEvent> get onTouchStart =>
    touchStartEvent.forElement(this);

onTransitionEnd no setter inherited#

ElementStream<TransitionEvent> get onTransitionEnd

Stream of transitionend events handled by this Element.

Inherited from Element.

Implementation

@SupportedBrowser(SupportedBrowser.CHROME)
@SupportedBrowser(SupportedBrowser.FIREFOX)
@SupportedBrowser(SupportedBrowser.IE, '10')
@SupportedBrowser(SupportedBrowser.SAFARI)
ElementStream<TransitionEvent> get onTransitionEnd =>
    transitionEndEvent.forElement(this);

onVolumeChange no setter inherited#

ElementStream<Event> get onVolumeChange

Inherited from Element.

Implementation

ElementStream<Event> get onVolumeChange => volumeChangeEvent.forElement(this);

onWaiting no setter inherited#

ElementStream<Event> get onWaiting

Inherited from Element.

Implementation

ElementStream<Event> get onWaiting => waitingEvent.forElement(this);

onWheel no setter inherited#

ElementStream<WheelEvent> get onWheel

Inherited from Element.

Implementation

ElementStream<WheelEvent> get onWheel => wheelEvent.forElement(this);

options no setter#

List<Node>? get options

Implementation

@Returns('HtmlCollection')
@Creates('HtmlCollection')
List<Node>? get options native;

outerHtml no setter inherited#

String? get outerHtml

Inherited from Element.

Implementation

@JSName('outerHTML')
String? get outerHtml native;

ownerDocument no setter inherited#

Document? get ownerDocument

The document this node belongs to.

Returns null if this node does not belong to any document.

Other resources

Node.ownerDocument from MDN.

Inherited from Node.

Implementation

Document? get ownerDocument native;

paddingEdge no setter inherited#

CssRect get paddingEdge

Access the dimensions and position of this element's content + padding box.

Inherited from Element.

Implementation

CssRect get paddingEdge => new _PaddingCssRect(this);

parent no setter inherited#

Element? get parent

The parent element of this node.

Returns null if this node either does not have a parent or its parent is not an element.

Other resources

Node.parentElement from W3C.

Inherited from Node.

Implementation

@JSName('parentElement')
&#47;**
 * The parent element of this node.
 *
 * Returns null if this node either does not have a parent or its parent is
 * not an element.
 *
 * ## Other resources
 *
 * * [Node.parentElement](https:&#47;&#47;developer.mozilla.org&#47;en-US&#47;docs&#47;Web&#47;API&#47;Node.parentElement)
 *   from W3C.
 *&#47;
Element? get parent native;

parentNode no setter inherited#

Node? get parentNode

The parent node of this node.

Other resources

Node.parentNode from MDN.

Inherited from Node.

Implementation

Node? get parentNode native;

previousElementSibling no setter inherited#

Element? get previousElementSibling

Inherited from Element.

Implementation

Element? get previousElementSibling native;

previousNode no setter inherited#

Node? get previousNode

The previous sibling node.

Other resources

Node.previousSibling from MDN.

Inherited from Node.

Implementation

@JSName('previousSibling')
&#47;**
 * The previous sibling node.
 *
 * ## Other resources
 *
 * * [Node.previousSibling](https:&#47;&#47;developer.mozilla.org&#47;en-US&#47;docs&#47;Web&#47;API&#47;Node.previousSibling)
 *   from MDN.
 *&#47;
Node? get previousNode native;

runtimeType no setter inherited#

Type get runtimeType

Inherited from Interceptor.

Implementation

Type get runtimeType =>
    getRuntimeTypeOfInterceptorNotArray(getInterceptor(this), this);

scrollHeight no setter inherited#

int get scrollHeight

Inherited from Element.

Implementation

int get scrollHeight => JS<num>('num', '#.scrollHeight', this).round();

scrollLeft read / write inherited#

int get scrollLeft

Inherited from Element.

Implementation

int get scrollLeft => JS<num>('num', '#.scrollLeft', this).round();

set scrollLeft(int value) {
  JS("void", "#.scrollLeft = #", this, value.round());
}

scrollTop read / write inherited#

int get scrollTop

Inherited from Element.

Implementation

int get scrollTop => JS<num>('num', '#.scrollTop', this).round();

set scrollTop(int value) {
  JS("void", "#.scrollTop = #", this, value.round());
}

scrollWidth no setter inherited#

int get scrollWidth

Inherited from Element.

Implementation

int get scrollWidth => JS<num>('num', '#.scrollWidth', this).round();

shadowRoot no setter inherited#

ShadowRoot? get shadowRoot

The shadow root of this shadow host.

Other resources

Shadow DOM 101 from HTML5Rocks.
Shadow DOM specification from W3C.

Inherited from Element.

Implementation

@SupportedBrowser(SupportedBrowser.CHROME, '25')
ShadowRoot? get shadowRoot =>
    JS('ShadowRoot|Null', '#.shadowRoot || #.webkitShadowRoot', this, this);

slot read / write inherited#

String? get slot

Inherited from Element.

Implementation

String? get slot native;

set slot(String? value) native;

spellcheck read / write inherited#

bool? get spellcheck

Inherited from Element.

Implementation

bool? get spellcheck native;

set spellcheck(bool? value) native;

style no setter inherited#

CssStyleDeclaration get style

Inherited from Element.

Implementation

CssStyleDeclaration get style native;

styleMap no setter inherited#

StylePropertyMap? get styleMap

Inherited from Element.

Implementation

StylePropertyMap? get styleMap native;

tabIndex read / write inherited#

int? get tabIndex

Inherited from Element.

Implementation

int? get tabIndex native;

set tabIndex(int? value) native;

tagName no setter inherited#

String get tagName

Inherited from Element.

Implementation

String get tagName native;

text read / write inherited#

String? get text

All text within this node and its descendants.

Other resources

Node.textContent from MDN.

Inherited from Node.

Implementation

@JSName('textContent')
&#47;**
 * All text within this node and its descendants.
 *
 * ## Other resources
 *
 * * [Node.textContent](https:&#47;&#47;developer.mozilla.org&#47;en-US&#47;docs&#47;Web&#47;API&#47;Node.textContent)
 *   from MDN.
 *&#47;
String? get text native;

@JSName('textContent')
set text(String? value) native;

title read / write inherited#

String? get title

Inherited from Element.

Implementation

String? get title native;

set title(String? value) native;

translate read / write inherited#

bool? get translate

Specifies whether this element's text content changes when the page is localized.

Other resources

The translate attribute from WHATWG.

Inherited from Element.

Implementation

bool? get translate native;

set translate(bool? value) native;

Methods#

addEventListener() inherited#

void addEventListener( String type, dynamic Function(Event event)? listener, [ bool? useCapture, ]);

Inherited from EventTarget.

Implementation

void addEventListener(
  String type,
  EventListener? listener, [
  bool? useCapture,
]) {
  &#47;&#47; TODO(leafp): This check is avoid a bug in our dispatch code when
  &#47;&#47; listener is null.  The browser treats this call as a no-op in this
  &#47;&#47; case, so it's fine to short-circuit it, but we should not have to.
  if (listener != null) {
    _addEventListener(type, listener, useCapture);
  }
}

after() inherited#

void after(Object nodes)

Inherited from Element.

Implementation

void after(Object nodes) native;

animate() inherited#

Animation animate(Iterable<Map<String, dynamic>> frames, [ dynamic timing])

Creates a new AnimationEffect object whose target element is the object on which the method is called, and calls the play() method of the AnimationTimeline object of the document timeline of the node document of the element, passing the newly created AnimationEffect as the argument to the method. Returns an Animation for the effect.

Examples

var animation = elem.animate([{"opacity": 75}, {"opacity": 0}], 200);

var animation = elem.animate([
  {"transform": "translate(100px, -100%)"},
  {"transform" : "translate(400px, 500px)"}
], 1500);

The frames parameter is an Iterable<Map>, where the map entries specify CSS animation effects. The timing parameter can be a double, representing the number of milliseconds for the transition, or a Map with fields corresponding to those of the timing object.

Inherited from Element.

Implementation

@SupportedBrowser(SupportedBrowser.CHROME, '36')
Animation animate(Iterable<Map<String, dynamic>> frames, [timing]) {
  if (frames is! Iterable || !(frames.every((x) => x is Map))) {
    throw new ArgumentError(
      "The frames parameter should be a List of Maps "
      "with frame information",
    );
  }
  var convertedFrames;
  if (frames is Iterable) {
    convertedFrames = frames.map(convertDartToNative_Dictionary).toList();
  } else {
    convertedFrames = frames;
  }
  var convertedTiming = timing is Map
      ? convertDartToNative_Dictionary(timing)
      : timing;
  return convertedTiming == null
      ? _animate(convertedFrames)
      : _animate(convertedFrames, convertedTiming);
}

append() inherited#

Node append(Node node)

Adds a node to the end of the child nodes list of this node.

If the node already exists in this document, it will be removed from its current parent node, then added to this node.

This method is more efficient than nodes.add, and is the preferred way of appending a child node.

Inherited from Node.

Implementation

@JSName('appendChild')
&#47;**
 * Adds a node to the end of the child [nodes] list of this node.
 *
 * If the node already exists in this document, it will be removed from its
 * current parent node, then added to this node.
 *
 * This method is more efficient than `nodes.add`, and is the preferred
 * way of appending a child node.
 *&#47;
Node append(Node node) native;

appendHtml() inherited#

void appendHtml( String text, { NodeValidator? validator, NodeTreeSanitizer? treeSanitizer, });

Parses the specified text as HTML and adds the resulting node after the last child of this element.

Inherited from Element.

Implementation

void appendHtml(
  String text, {
  NodeValidator? validator,
  NodeTreeSanitizer? treeSanitizer,
}) {
  this.insertAdjacentHtml(
    'beforeend',
    text,
    validator: validator,
    treeSanitizer: treeSanitizer,
  );
}

appendText() inherited#

void appendText(String text)

Adds the specified text after the last child of this element.

Inherited from Element.

Implementation

void appendText(String text) {
  this.append(new Text(text));
}

attached() inherited#

void attached()

Called by the DOM when this element has been inserted into the live document.

Warning: This API is part of multiple custom element APIs that are no longer supported.

Inherited from Element.

Implementation

void attached() {
  &#47;&#47; For the deprecation period, call the old callback.
  enteredView();
}

attachShadow() inherited#

ShadowRoot attachShadow(Map<dynamic, dynamic> shadowRootInitDict)

Inherited from Element.

Implementation

ShadowRoot attachShadow(Map shadowRootInitDict) {
  var shadowRootInitDict_1 = convertDartToNative_Dictionary(
    shadowRootInitDict,
  );
  return _attachShadow_1(shadowRootInitDict_1);
}

attributeChanged() inherited#

void attributeChanged(String name, String oldValue, String newValue)

Called by the DOM whenever an attribute on this has been changed.

Inherited from Element.

Implementation

void attributeChanged(String name, String oldValue, String newValue) {}

before() inherited#

void before(Object nodes)

Inherited from Element.

Implementation

void before(Object nodes) native;

blur() inherited#

void blur()

Inherited from Element.

Implementation

void blur() native;

click() inherited#

void click()

Inherited from Element.

Implementation

void click() native;

clone() inherited#

Node clone(bool? deep)

Returns a copy of this node.

If deep is true, then all of this node's children and descendants are copied as well. If deep is false, then only this node is copied.

Other resources

Node.cloneNode from MDN.

Inherited from Node.

Implementation

@JSName('cloneNode')
&#47;**
 * Returns a copy of this node.
 *
 * If [deep] is `true`, then all of this node's children and descendants are
 * copied as well. If [deep] is `false`, then only this node is copied.
 *
 * ## Other resources
 *
 * * [Node.cloneNode](https:&#47;&#47;developer.mozilla.org&#47;en-US&#47;docs&#47;Web&#47;API&#47;Node.cloneNode)
 *   from MDN.
 *&#47;
Node clone(bool? deep) native;

closest() inherited#

Element? closest(String selectors)

Inherited from Element.

Implementation

Element? closest(String selectors) native;

contains() inherited#

bool contains(Node? other)

Returns true if this node contains the specified node.

Other resources

Node.contains from MDN.

Inherited from Node.

Implementation

bool contains(Node? other) native;

createFragment() inherited#

DocumentFragment createFragment( String? html, { NodeValidator? validator, NodeTreeSanitizer? treeSanitizer, });

Create a DocumentFragment from the HTML fragment and ensure that it follows the sanitization rules specified by the validator or treeSanitizer.

If the default validation behavior is too restrictive then a new NodeValidator should be created, either extending or wrapping a default validator and overriding the validation APIs.

The treeSanitizer is used to walk the generated node tree and sanitize it. A custom treeSanitizer can also be provided to perform special validation rules but since the API is more complex to implement this is discouraged.

The returned tree is guaranteed to only contain nodes and attributes which are allowed by the provided validator.

See also:

Inherited from Element.

Implementation

DocumentFragment createFragment(
  String? html, {
  NodeValidator? validator,
  NodeTreeSanitizer? treeSanitizer,
}) {
  if (treeSanitizer == null) {
    if (validator == null) {
      if (_defaultValidator == null) {
        _defaultValidator = new NodeValidatorBuilder.common();
      }
      validator = _defaultValidator;
    }
    if (_defaultSanitizer == null) {
      _defaultSanitizer = new _ValidatingTreeSanitizer(validator!);
    } else {
      _defaultSanitizer!.validator = validator!;
    }
    treeSanitizer = _defaultSanitizer;
  } else if (validator != null) {
    throw new ArgumentError(
      'validator can only be passed if treeSanitizer is null',
    );
  }

  if (_parseDocument == null) {
    _parseDocument = document.implementation!.createHtmlDocument('');
    _parseRange = _parseDocument!.createRange();

    &#47;&#47; Workaround for Safari bug. Was also previously Chrome bug 229142
    &#47;&#47; - URIs are not resolved in new doc.
    BaseElement base = _parseDocument!.createElement('base') as BaseElement;
    base.href = document.baseUri!;
    _parseDocument!.head!.append(base);
  }

  &#47;&#47; TODO(terry): Fixes Chromium 50 change no body after createHtmlDocument()
  if (_parseDocument!.body == null) {
    _parseDocument!.body =
        _parseDocument!.createElement("body") as BodyElement;
  }

  Element contextElement;
  if (this is BodyElement) {
    contextElement = _parseDocument!.body!;
  } else {
    contextElement = _parseDocument!.createElement(tagName);
    _parseDocument!.body!.append(contextElement);
  }
  DocumentFragment fragment;
  if (Range.supportsCreateContextualFragment &&
      _canBeUsedToCreateContextualFragment) {
    _parseRange!.selectNodeContents(contextElement);
    &#47;&#47; createContextualFragment expects a non-nullable html string.
    &#47;&#47; If null is passed, it gets converted to 'null' instead.
    fragment = _parseRange!.createContextualFragment(html ?? 'null');
  } else {
    contextElement._innerHtml = html;

    fragment = _parseDocument!.createDocumentFragment();
    while (contextElement.firstChild != null) {
      fragment.append(contextElement.firstChild!);
    }
  }
  if (contextElement != _parseDocument!.body) {
    contextElement.remove();
  }

  treeSanitizer!.sanitizeTree(fragment);
  &#47;&#47; Copy the fragment over to the main document (fix for 14184)
  document.adoptNode(fragment);

  return fragment;
}

createShadowRoot() inherited#

ShadowRoot createShadowRoot()

Creates a new shadow root for this shadow host.

Other resources

Shadow DOM 101 from HTML5Rocks.
Shadow DOM specification from W3C.

Inherited from Element.

Implementation

@SupportedBrowser(SupportedBrowser.CHROME, '25')
ShadowRoot createShadowRoot() {
  return JS(
    'ShadowRoot',
    '(#.createShadowRoot || #.webkitCreateShadowRoot).call(#)',
    this,
    this,
    this,
  );
}

detached() inherited#

void detached()

Called by the DOM when this element has been removed from the live document.

Warning: This API is part of multiple custom element APIs that are no longer supported. draft specification.

Inherited from Element.

Implementation

void detached() {
  &#47;&#47; For the deprecation period, call the old callback.
  leftView();
}

dispatchEvent() inherited#

bool dispatchEvent(Event event)

Inherited from EventTarget.

Implementation

bool dispatchEvent(Event event) native;

deprecated enteredView() inherited#

void enteredView()

DEPRECATED

next release

Deprecated*: override attached instead.

Inherited from Element.

Implementation

@deprecated
void enteredView() {}

focus() inherited#

void focus()

Inherited from Element.

Implementation

void focus() native;

getAnimations() inherited#

List<Animation> getAnimations()

Inherited from Element.

Implementation

List<Animation> getAnimations() native;

getAttribute() inherited#

String? getAttribute(String name)

Inherited from Element.

Implementation

@pragma('dart2js:tryInline')
String? getAttribute(String name) {
  &#47;&#47; TODO(41258): Delete this assertion after forcing strong mode.
  &#47;&#47; Protect [name] against string conversion to "null" or "undefined".
  assert(name != null, 'Attribute name cannot be null');
  return _getAttribute(name);
}

getAttributeNames() inherited#

List<String> getAttributeNames()

Inherited from Element.

Implementation

List<String> getAttributeNames() native;

getAttributeNS() inherited#

String? getAttributeNS(String? namespaceURI, String name)

Inherited from Element.

Implementation

@pragma('dart2js:tryInline')
String? getAttributeNS(String? namespaceURI, String name) {
  &#47;&#47; TODO(41258): Delete this assertion after forcing strong mode.
  &#47;&#47; Protect [name] against string conversion to "null" or "undefined".
  &#47;&#47; [namespaceURI] does not need protecting, both `null` and `undefined` map to `null`.
  assert(name != null, 'Attribute name cannot be null');
  return _getAttributeNS(namespaceURI, name);
}

getBoundingClientRect() inherited#

Rectangle<num> getBoundingClientRect()

Returns the smallest bounding rectangle that encompasses this element's padding, scrollbar, and border.

Other resources

Element.getBoundingClientRect from MDN.
The getBoundingClientRect() method from W3C.

Inherited from Element.

Implementation

@Creates('_DomRect')
@Returns('_DomRect|Null')
Rectangle getBoundingClientRect() native;

getClientRects() inherited#

List<Rectangle<num>> getClientRects()

Inherited from Element.

Implementation

List<Rectangle> getClientRects() {
  var value = _getClientRects();

  &#47;&#47; If no prototype we need one for the world to hookup to the proper Dart class.
  var jsProto = JS('', '#.prototype', value);
  if (jsProto == null) {
    JS('', '#.prototype = Object.create(null)', value);
  }

  applyExtension('DOMRectList', value);

  return value;
}

getComputedStyle() inherited#

CssStyleDeclaration getComputedStyle([ String? pseudoElement])

The set of all CSS values applied to this element, including inherited and default values.

The computedStyle contains values that are inherited from other sources, such as parent elements or stylesheets. This differs from the style property, which contains only the values specified directly on this element.

PseudoElement can be values such as ::after, ::before, ::marker, ::line-marker.

See also:

Cascade and Inheritance from MDN.
Pseudo-elements from MDN.

Inherited from Element.

Implementation

CssStyleDeclaration getComputedStyle([String? pseudoElement]) {
  if (pseudoElement == null) {
    pseudoElement = '';
  }
  &#47;&#47; TODO(jacobr): last param should be null, see b&#47;5045788
  return window._getComputedStyle(this, pseudoElement);
}

getDestinationInsertionPoints() inherited#

List<Node> getDestinationInsertionPoints()

Returns a list of shadow DOM insertion points to which this element is distributed.

Other resources

Shadow DOM specification from W3C.

Inherited from Element.

Implementation

@Returns('NodeList')
@Creates('NodeList')
List<Node> getDestinationInsertionPoints() native;

getElementsByClassName() inherited#

List<Node> getElementsByClassName(String classNames)

Returns a list of nodes with the given class name inside this element.

Other resources

getElementsByClassName from MDN.
DOM specification from W3C.

Inherited from Element.

Implementation

@Creates('NodeList|HtmlCollection')
@Returns('NodeList|HtmlCollection')
List<Node> getElementsByClassName(String classNames) native;

getNamespacedAttributes() inherited#

Map<String, String> getNamespacedAttributes(String namespace)

Gets a map for manipulating the attributes of a particular namespace.

This is primarily useful for SVG attributes such as xref:link.

Inherited from Element.

Implementation

Map<String, String> getNamespacedAttributes(String namespace) {
  return new _NamespacedAttributeMap(this, namespace);
}

getRootNode() inherited#

Node getRootNode([ Map<dynamic, dynamic>? options])

Inherited from Node.

Implementation

Node getRootNode([Map? options]) {
  if (options != null) {
    var options_1 = convertDartToNative_Dictionary(options);
    return _getRootNode_1(options_1);
  }
  return _getRootNode_2();
}

hasAttribute() inherited#

bool hasAttribute(String name)

Inherited from Element.

Implementation

@pragma('dart2js:tryInline')
bool hasAttribute(String name) {
  &#47;&#47; TODO(41258): Delete this assertion after forcing strong mode.
  &#47;&#47; Protect [name] against string conversion to "null" or "undefined".
  assert(name != null, 'Attribute name cannot be null');
  return _hasAttribute(name);
}

hasAttributeNS() inherited#

bool hasAttributeNS(String? namespaceURI, String name)

Inherited from Element.

Implementation

@pragma('dart2js:tryInline')
bool hasAttributeNS(String? namespaceURI, String name) {
  &#47;&#47; TODO(41258): Delete this assertion after forcing strong mode.
  &#47;&#47; Protect [name] against string conversion to "null" or "undefined".
  &#47;&#47; [namespaceURI] does not need protecting, both `null` and `undefined` map to `null`.
  assert(name != null, 'Attribute name cannot be null');
  return _hasAttributeNS(namespaceURI, name);
}

hasChildNodes() inherited#

bool hasChildNodes()

Returns true if this node has any children.

Other resources

Node.hasChildNodes from MDN.

Inherited from Node.

Implementation

bool hasChildNodes() native;

hasPointerCapture() inherited#

bool hasPointerCapture(int pointerId)

Inherited from Element.

Implementation

bool hasPointerCapture(int pointerId) native;

insertAdjacentElement() inherited#

Element insertAdjacentElement(String where, Element element)

Inserts element into the DOM at the specified location.

To see the possible values for where, read the doc for insertAdjacentHtml.

See also:

insertAdjacentHtml

Inherited from Element.

Implementation

Element insertAdjacentElement(String where, Element element) {
  if (JS('bool', '!!#.insertAdjacentElement', this)) {
    _insertAdjacentElement(where, element);
  } else {
    _insertAdjacentNode(where, element);
  }
  return element;
}

insertAdjacentHtml() inherited#

void insertAdjacentHtml( String where, String html, { NodeValidator? validator, NodeTreeSanitizer? treeSanitizer, });

Parses text as an HTML fragment and inserts it into the DOM at the specified location.

The where parameter indicates where to insert the HTML fragment:

'beforeBegin': Immediately before this element.
'afterBegin': As the first child of this element.
'beforeEnd': As the last child of this element.
'afterEnd': Immediately after this element.

    var html = '<div class="something">content</div>';
    // Inserts as the first child
    document.body.insertAdjacentHtml('afterBegin', html);
    var createdElement = document.body.children[0];
    print(createdElement.classes[0]); // Prints 'something'

See also:

Inherited from Element.

Implementation

void insertAdjacentHtml(
  String where,
  String html, {
  NodeValidator? validator,
  NodeTreeSanitizer? treeSanitizer,
}) {
  if (treeSanitizer is _TrustedHtmlTreeSanitizer) {
    _insertAdjacentHtml(where, html);
  } else {
    _insertAdjacentNode(
      where,
      createFragment(
        html,
        validator: validator,
        treeSanitizer: treeSanitizer,
      ),
    );
  }
}

insertAdjacentText() inherited#

void insertAdjacentText(String where, String text)

Inserts text into the DOM at the specified location.

To see the possible values for where, read the doc for insertAdjacentHtml.

See also:

insertAdjacentHtml

Inherited from Element.

Implementation

void insertAdjacentText(String where, String text) {
  if (JS('bool', '!!#.insertAdjacentText', this)) {
    _insertAdjacentText(where, text);
  } else {
    _insertAdjacentNode(where, new Text(text));
  }
}

insertAllBefore() inherited#

void insertAllBefore(Iterable<Node> newNodes, Node child)

Inserts all of the nodes into this node directly before child.

See also:

insertBefore

Inherited from Node.

Implementation

void insertAllBefore(Iterable<Node> newNodes, Node child) {
  if (newNodes is _ChildNodeListLazy) {
    _ChildNodeListLazy otherList = newNodes;
    if (identical(otherList._this, this)) {
      throw new ArgumentError(newNodes);
    }

    &#47;&#47; Optimized route for copying between nodes.
    for (var i = 0, len = otherList.length; i < len; ++i) {
      this.insertBefore(otherList._this.firstChild!, child);
    }
  } else {
    for (var node in newNodes) {
      this.insertBefore(node, child);
    }
  }
}

insertBefore() inherited#

Node insertBefore(Node node, Node? child)

Inserts the given node into this node directly before child. If child is null, then the given node is inserted at the end of this node's child nodes.

Other resources

Node.insertBefore from MDN.

Inherited from Node.

Implementation

Node insertBefore(Node node, Node? child) native;

deprecated leftView() inherited#

void leftView()

DEPRECATED

next release

Deprecated*: override detached instead.

Inherited from Element.

Implementation

@deprecated
void leftView() {}

matches() inherited#

bool matches(String selectors)

Checks if this element matches the CSS selectors.

Inherited from Element.

Implementation

bool matches(String selectors) {
  if (JS('bool', '!!#.matches', this)) {
    return JS('bool', '#.matches(#)', this, selectors);
  } else if (JS('bool', '!!#.webkitMatchesSelector', this)) {
    return JS('bool', '#.webkitMatchesSelector(#)', this, selectors);
  } else if (JS('bool', '!!#.mozMatchesSelector', this)) {
    return JS('bool', '#.mozMatchesSelector(#)', this, selectors);
  } else if (JS('bool', '!!#.msMatchesSelector', this)) {
    return JS('bool', '#.msMatchesSelector(#)', this, selectors);
  } else if (JS('bool', '!!#.oMatchesSelector', this)) {
    return JS('bool', '#.oMatchesSelector(#)', this, selectors);
  } else {
    throw new UnsupportedError("Not supported on this platform");
  }
}

matchesWithAncestors() inherited#

bool matchesWithAncestors(String selectors)

Checks if this element or any of its parents match the CSS selectors.

Inherited from Element.

Implementation

bool matchesWithAncestors(String selectors) {
  var elem = this as Element?;
  do {
    if (elem!.matches(selectors)) return true;
    elem = elem.parent;
  } while (elem != null);
  return false;
}

noSuchMethod() inherited#

dynamic noSuchMethod(Invocation invocation)

Invoked when a nonexistent method or property is accessed.

A dynamic member invocation can attempt to call a member which doesn't exist on the receiving object. Example:

dynamic object = 1;
object.add(42); // Statically allowed, run-time error

This invalid code will invoke the noSuchMethod method of the integer 1 with an Invocation representing the .add(42) call and arguments (which then throws).

Classes can override noSuchMethod to provide custom behavior for such invalid dynamic invocations.

A class with a non-default noSuchMethod invocation can also omit implementations for members of its interface. Example:

class MockList<T> implements List<T> {
  noSuchMethod(Invocation invocation) {
    log(invocation);
    super.noSuchMethod(invocation); // Will throw.
  }
}
void main() {
  MockList().add(42);
}

This code has no compile-time warnings or errors even though the MockList class has no concrete implementation of any of the List interface methods. Calls to List methods are forwarded to noSuchMethod, so this code will log an invocation similar to Invocation.method(#add, [42]) and then throw.

If a value is returned from noSuchMethod, it becomes the result of the original invocation. If the value is not of a type that can be returned by the original invocation, a type error occurs at the invocation.

The default behavior is to throw a NoSuchMethodError.

Inherited from Interceptor.

Implementation

dynamic noSuchMethod(Invocation invocation) {
  throw NoSuchMethodError.withInvocation(this, invocation);
}

offsetTo() inherited#

Point<num> offsetTo(Element parent)

Provides the offset of this element's borderEdge relative to the specified parent.

This is the Dart equivalent of jQuery's position method. Unlike jQuery's position, however, parent can be any parent element of this, rather than only this's immediate offsetParent. If the specified element is not an offset parent or transitive offset parent to this element, an ArgumentError is thrown.

Inherited from Element.

Implementation

Point offsetTo(Element parent) {
  return Element._offsetToHelper(this, parent);
}

querySelector() inherited#

Element? querySelector(String selectors)

Finds the first descendant element of this element that matches the specified group of selectors.

selectors should be a string using CSS selector syntax.

// Gets the first descendant with the class 'classname'
var element = element.querySelector('.className');
// Gets the element with id 'id'
var element = element.querySelector('#id');
// Gets the first descendant [ImageElement]
var img = element.querySelector('img');

For details about CSS selector syntax, see the CSS selector specification.

Inherited from Element.

Implementation

Element? querySelector(String selectors) native;

querySelectorAll() inherited#

ElementList<T> querySelectorAll<T extends Element>(String selectors)

Finds all descendent elements of this element that match the specified group of selectors.

selectors should be a string using CSS selector syntax.

var items = element.querySelectorAll('.itemClassName');

For details about CSS selector syntax, see the CSS selector specification.

Inherited from Element.

Implementation

ElementList<T> querySelectorAll<T extends Element>(String selectors) =>
    new _FrozenElementList<T>._wrap(_querySelectorAll(selectors));

releasePointerCapture() inherited#

void releasePointerCapture(int pointerId)

Inherited from Element.

Implementation

void releasePointerCapture(int pointerId) native;

remove() inherited#

void remove()

Removes this node from the DOM.

Inherited from Node.

Implementation

void remove() {
  &#47;&#47; TODO(jacobr): should we throw an exception if parent is already null?
  &#47;&#47; TODO(vsm): Use the native remove when available.
  if (this.parentNode != null) {
    final Node parent = this.parentNode!;
    parent._removeChild(this);
  }
}

removeAttribute() inherited#

void removeAttribute(String name)

Inherited from Element.

Implementation

@pragma('dart2js:tryInline')
void removeAttribute(String name) {
  &#47;&#47; TODO(41258): Delete this assertion after forcing strong mode.
  &#47;&#47; Protect [name] against string conversion to "null" or "undefined".
  assert(name != null, 'Attribute name cannot be null');
  _removeAttribute(name);
}

removeAttributeNS() inherited#

void removeAttributeNS(String? namespaceURI, String name)

Inherited from Element.

Implementation

@pragma('dart2js:tryInline')
void removeAttributeNS(String? namespaceURI, String name) {
  &#47;&#47; TODO(41258): Delete this assertion after forcing strong mode.
  &#47;&#47; Protect [name] against string conversion to "null" or "undefined".
  assert(name != null, 'Attribute name cannot be null');
  _removeAttributeNS(namespaceURI, name);
}

removeEventListener() inherited#

void removeEventListener( String type, dynamic Function(Event event)? listener, [ bool? useCapture, ]);

Inherited from EventTarget.

Implementation

void removeEventListener(
  String type,
  EventListener? listener, [
  bool? useCapture,
]) {
  &#47;&#47; TODO(leafp): This check is avoid a bug in our dispatch code when
  &#47;&#47; listener is null.  The browser treats this call as a no-op in this
  &#47;&#47; case, so it's fine to short-circuit it, but we should not have to.
  if (listener != null) {
    _removeEventListener(type, listener, useCapture);
  }
}

replaceWith() inherited#

Node replaceWith(Node otherNode)

Replaces this node with another node.

Inherited from Node.

Implementation

Node replaceWith(Node otherNode) {
  try {
    final Node parent = this.parentNode!;
    parent._replaceChild(otherNode, this);
  } catch (e) {}
  return this;
}

requestFullscreen() inherited#

Future<void> requestFullscreen([ Map<dynamic, dynamic>? options])

Displays this element fullscreen.

Other resources

Fullscreen API from MDN.
Fullscreen specification from W3C.

Inherited from Element.

Implementation

@SupportedBrowser(SupportedBrowser.CHROME)
@SupportedBrowser(SupportedBrowser.FIREFOX)
@SupportedBrowser(SupportedBrowser.SAFARI)
Future<void> requestFullscreen([Map? options]) {
  var retValue;
  if (options != null) {
    retValue = JS(
      '',
      '(#.requestFullscreen||#.webkitRequestFullscreen).call(#, #)',
      this,
      this,
      this,
      convertDartToNative_Dictionary(options),
    );
  } else {
    retValue = JS(
      '',
      '(#.requestFullscreen||#.webkitRequestFullscreen).call(#)',
      this,
      this,
      this,
    );
  }
  if (retValue != null) return promiseToFuture(retValue);
  return Future<void>.value();
}

requestPointerLock() inherited#

void requestPointerLock()

Inherited from Element.

Implementation

void requestPointerLock() native;

scroll() inherited#

void scroll([ dynamic options_OR_x, num? y])

Inherited from Element.

Implementation

void scroll([options_OR_x, num? y]) {
  if (options_OR_x == null && y == null) {
    _scroll_1();
    return;
  }
  if ((options_OR_x is Map) && y == null) {
    var options_1 = convertDartToNative_Dictionary(options_OR_x);
    _scroll_2(options_1);
    return;
  }
  if (y != null && (options_OR_x is num)) {
    _scroll_3(options_OR_x, y);
    return;
  }
  throw new ArgumentError("Incorrect number or type of arguments");
}

scrollBy() inherited#

void scrollBy([ dynamic options_OR_x, num? y])

Inherited from Element.

Implementation

void scrollBy([options_OR_x, num? y]) {
  if (options_OR_x == null && y == null) {
    _scrollBy_1();
    return;
  }
  if ((options_OR_x is Map) && y == null) {
    var options_1 = convertDartToNative_Dictionary(options_OR_x);
    _scrollBy_2(options_1);
    return;
  }
  if (y != null && (options_OR_x is num)) {
    _scrollBy_3(options_OR_x, y);
    return;
  }
  throw new ArgumentError("Incorrect number or type of arguments");
}

scrollIntoView() inherited#

void scrollIntoView([ ScrollAlignment? alignment])

Scrolls this element into view.

Only one of the alignment options may be specified at a time.

If no options are specified then this will attempt to scroll the minimum amount needed to bring the element into view.

Note that alignCenter is currently only supported on WebKit platforms. If alignCenter is specified but not supported then this will fall back to alignTop.

See also:

scrollIntoView from MDN.
scrollIntoViewIfNeeded from MDN.

Inherited from Element.

Implementation

void scrollIntoView([ScrollAlignment? alignment]) {
  var hasScrollIntoViewIfNeeded = true;
  hasScrollIntoViewIfNeeded = JS(
    'bool',
    '!!(#.scrollIntoViewIfNeeded)',
    this,
  );
  if (alignment == ScrollAlignment.TOP) {
    this._scrollIntoView(true);
  } else if (alignment == ScrollAlignment.BOTTOM) {
    this._scrollIntoView(false);
  } else if (hasScrollIntoViewIfNeeded) {
    &#47;&#47; TODO(srujzs): This method shouldn't be calling out to
    &#47;&#47; `scrollIntoViewIfNeeded`. Remove this and make `scrollIntoView` match
    &#47;&#47; the browser definition. If you intend to use `scrollIntoViewIfNeeded`,
    &#47;&#47; use the `Element.scrollIntoViewIfNeeded` method.
    if (alignment == ScrollAlignment.CENTER) {
      this.scrollIntoViewIfNeeded(true);
    } else {
      this.scrollIntoViewIfNeeded();
    }
  } else {
    this._scrollIntoView();
  }
}

scrollIntoViewIfNeeded() inherited#

void scrollIntoViewIfNeeded([ bool? centerIfNeeded])

Nonstandard version of scrollIntoView that scrolls the current element into the visible area of the browser window if it's not already within the visible area of the browser window. If the element is already within the visible area of the browser window, then no scrolling takes place.

Other resources

Element.scrollIntoViewIfNeeded from MDN.

Inherited from Element.

Implementation

void scrollIntoViewIfNeeded([bool? centerIfNeeded]) native;

scrollTo() inherited#

void scrollTo([ dynamic options_OR_x, num? y])

Inherited from Element.

Implementation

void scrollTo([options_OR_x, num? y]) {
  if (options_OR_x == null && y == null) {
    _scrollTo_1();
    return;
  }
  if ((options_OR_x is Map) && y == null) {
    var options_1 = convertDartToNative_Dictionary(options_OR_x);
    _scrollTo_2(options_1);
    return;
  }
  if (y != null && (options_OR_x is num)) {
    _scrollTo_3(options_OR_x, y);
    return;
  }
  throw new ArgumentError("Incorrect number or type of arguments");
}

setApplyScroll() inherited#

Future<ScrollState> setApplyScroll(String nativeScrollBehavior)

Inherited from Element.

Implementation

Future<ScrollState> setApplyScroll(String nativeScrollBehavior) {
  var completer = new Completer<ScrollState>();
  _setApplyScroll((value) {
    completer.complete(value);
  }, nativeScrollBehavior);
  return completer.future;
}

setAttribute() inherited#

void setAttribute(String name, Object value)

Inherited from Element.

Implementation

@pragma('dart2js:tryInline')
void setAttribute(String name, Object value) {
  &#47;&#47; TODO(41258): Delete these assertions after forcing strong mode.
  &#47;&#47; Protect [name] against string conversion to "null" or "undefined".
  assert(name != null, 'Attribute name cannot be null');
  &#47;&#47; TODO(sra): assert(value != null, 'Attribute value cannot be null.');
  _setAttribute(name, value);
}

setAttributeNS() inherited#

void setAttributeNS(String? namespaceURI, String name, Object value)

Inherited from Element.

Implementation

@pragma('dart2js:tryInline')
void setAttributeNS(String? namespaceURI, String name, Object value) {
  &#47;&#47; TODO(41258): Delete these assertions after forcing strong mode.
  &#47;&#47; Protect [name] against string conversion to "null" or "undefined".
  assert(name != null, 'Attribute name cannot be null');
  &#47;&#47; TODO(sra): assert(value != null, 'Attribute value cannot be null.');
  _setAttributeNS(namespaceURI, name, value);
}

setDistributeScroll() inherited#

Future<ScrollState> setDistributeScroll(String nativeScrollBehavior)

Inherited from Element.

Implementation

Future<ScrollState> setDistributeScroll(String nativeScrollBehavior) {
  var completer = new Completer<ScrollState>();
  _setDistributeScroll((value) {
    completer.complete(value);
  }, nativeScrollBehavior);
  return completer.future;
}

setInnerHtml() inherited#

void setInnerHtml( String? html, { NodeValidator? validator, NodeTreeSanitizer? treeSanitizer, });

Parses the HTML fragment and sets it as the contents of this element. This ensures that the generated content follows the sanitization rules specified by the validator or treeSanitizer.

If the default validation behavior is too restrictive then a new NodeValidator should be created, either extending or wrapping a default validator and overriding the validation APIs.

The resulting tree is guaranteed to only contain nodes and attributes which are allowed by the provided validator.

See also:

Inherited from Element.

Implementation

void setInnerHtml(
  String? html, {
  NodeValidator? validator,
  NodeTreeSanitizer? treeSanitizer,
}) {
  text = null;
  if (treeSanitizer is _TrustedHtmlTreeSanitizer) {
    _innerHtml = html;
  } else {
    append(
      createFragment(
        html,
        validator: validator,
        treeSanitizer: treeSanitizer,
      ),
    );
  }
}

setPointerCapture() inherited#

void setPointerCapture(int pointerId)

Inherited from Element.

Implementation

void setPointerCapture(int pointerId) native;

toString() inherited#

String toString()

The string representation of this element.

This is equivalent to reading the localName property.

Inherited from Element.

Implementation

String toString() => localName;

Operators#

operator ==() inherited#

bool operator ==(Object other)

The equality operator.

The default behavior for all Objects is to return true if and only if this object and other are the same object.

Override this method to specify a different equality relation on a class. The overriding method must still be an equivalence relation. That is, it must be:

Total: It must return a boolean for all arguments. It should never throw.
Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and o2 == o3 are true, then o1 == o3 must be true.

The method should also be consistent over time, so whether two objects are equal should only change if at least one of the objects was modified.

If a subclass overrides the equality operator, it should override the hashCode method as well to maintain consistency.

Inherited from Interceptor.

Implementation

bool operator ==(Object other) => identical(this, other);

Static Properties#

supported no setter#

bool get supported

Checks if this type is supported on the current platform.

Implementation

static bool get supported => Element.isTagSupported('datalist');