@ngyewch/leaflet-webcomponent
    Preparing search index...

    Class LeafletMapElement

    Leaflet Map web component.

    Hierarchy

    • LitElement
      • LeafletMapElement
    Index

    Other

    constructor accessKey accessKeyLabel ariaActiveDescendantElement ariaAtomic ariaAutoComplete ariaBrailleLabel ariaBrailleRoleDescription ariaBusy ariaChecked ariaColCount ariaColIndex ariaColIndexText ariaColSpan ariaControlsElements ariaCurrent ariaDescribedByElements ariaDescription ariaDetailsElements ariaDisabled ariaErrorMessageElements ariaExpanded ariaFlowToElements ariaHasPopup ariaHidden ariaInvalid ariaKeyShortcuts ariaLabel ariaLabelledByElements ariaLevel ariaLive ariaModal ariaMultiLine ariaMultiSelectable ariaOrientation ariaOwnsElements ariaPlaceholder ariaPosInSet ariaPressed ariaReadOnly ariaRelevant ariaRequired ariaRoleDescription ariaRowCount ariaRowIndex ariaRowIndexText ariaRowSpan ariaSelected ariaSetSize ariaSort ariaValueMax ariaValueMin ariaValueNow ariaValueText assignedSlot ATTRIBUTE_NODE attributes attributeStyleMap autocapitalize autocorrect autofocus baseURI CDATA_SECTION_NODE childElementCount childNodes children className clientHeight clientLeft clientTop clientWidth COMMENT_NODE contentEditable currentCSSZoom dataset dir DOCUMENT_FRAGMENT_NODE DOCUMENT_NODE DOCUMENT_POSITION_CONTAINED_BY DOCUMENT_POSITION_CONTAINS DOCUMENT_POSITION_DISCONNECTED DOCUMENT_POSITION_FOLLOWING DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC DOCUMENT_POSITION_PRECEDING DOCUMENT_TYPE_NODE draggable ELEMENT_NODE enterKeyHint ENTITY_NODE ENTITY_REFERENCE_NODE firstChild firstElementChild hidden id inert innerHTML innerText inputMode isConnected isContentEditable lang lastChild lastElementChild localName namespaceURI nextElementSibling nextSibling nodeName nodeType nodeValue nonce? NOTATION_NODE offsetHeight offsetLeft offsetParent offsetTop offsetWidth onabort onanimationcancel onanimationend onanimationiteration onanimationstart onauxclick onbeforeinput onbeforematch onbeforetoggle onblur oncancel oncanplay oncanplaythrough onchange onclick onclose oncontextlost oncontextmenu oncontextrestored oncopy oncuechange oncut ondblclick ondrag ondragend ondragenter ondragleave ondragover ondragstart ondrop ondurationchange onemptied onended onerror onfocus onformdata onfullscreenchange onfullscreenerror ongotpointercapture oninput oninvalid onkeydown onkeypress onkeyup onload onloadeddata onloadedmetadata onloadstart onlostpointercapture onmousedown onmouseenter onmouseleave onmousemove onmouseout onmouseover onmouseup onpaste onpause onplay onplaying onpointercancel onpointerdown onpointerenter onpointerleave onpointermove onpointerout onpointerover onpointerrawupdate onpointerup onprogress onratechange onreset onresize onscroll onscrollend onsecuritypolicyviolation onseeked onseeking onselect onselectionchange onselectstart onslotchange onstalled onsubmit onsuspend ontimeupdate ontoggle ontouchcancel? ontouchend? ontouchmove? ontouchstart? ontransitioncancel ontransitionend ontransitionrun ontransitionstart onvolumechange onwaiting onwebkitanimationend onwebkitanimationiteration onwebkitanimationstart onwebkittransitionend onwheel outerHTML outerText ownerDocument parentElement parentNode popover prefix previousElementSibling previousSibling PROCESSING_INSTRUCTION_NODE role scrollHeight scrollLeft scrollTop scrollWidth shadowRoot slot spellcheck tabIndex tagName TEXT_NODE title translate writingSuggestions _$litElement$ _initializers? [metadata] finalized classList part style textContent addEventListener after animate append appendChild attachInternals attachShadow before blur checkVisibility click cloneNode closest compareDocumentPosition computedStyleMap contains dispatchEvent focus getAnimations getAttribute getAttributeNames getAttributeNode getAttributeNodeNS getAttributeNS getBoundingClientRect getClientRects getElementsByClassName getElementsByTagName getElementsByTagNameNS getHTML getRootNode hasAttribute hasAttributeNS hasAttributes hasChildNodes hasPointerCapture hidePopover insertAdjacentElement insertAdjacentHTML insertAdjacentText insertBefore isDefaultNamespace isEqualNode isSameNode lookupNamespaceURI lookupPrefix matches normalize prepend querySelector querySelectorAll releasePointerCapture remove removeAttribute removeAttributeNode removeAttributeNS removeChild removeEventListener replaceChild replaceChildren replaceWith requestFullscreen requestPointerLock scroll scrollBy scrollIntoView scrollTo setAttribute setAttributeNode setAttributeNodeNS setAttributeNS setHTMLUnsafe setPointerCapture showPopover toggleAttribute togglePopover webkitMatchesSelector addInitializer finalize

    attributes

    controllers

    dev-mode

    lifecycle

    properties

    rendering

    styles

    updates

    Other

    • Returns LeafletMapElement

    accessKey: string

    The HTMLElement.accessKey property sets the keystroke which a user can press to jump to a given element.

    MDN Reference

    accessKeyLabel: string

    The HTMLElement.accessKeyLabel read-only property returns a string containing the element's browser-assigned access key (if any); otherwise it returns an empty string.

    MDN Reference

    ariaActiveDescendantElement: null | Element
    ariaAtomic: null | string
    ariaAutoComplete: null | string
    ariaBrailleLabel: null | string
    ariaBrailleRoleDescription: null | string
    ariaBusy: null | string
    ariaChecked: null | string
    ariaColCount: null | string
    ariaColIndex: null | string
    ariaColIndexText: null | string
    ariaColSpan: null | string
    ariaControlsElements: null | readonly Element[]
    ariaCurrent: null | string
    ariaDescribedByElements: null | readonly Element[]
    ariaDescription: null | string
    ariaDetailsElements: null | readonly Element[]
    ariaDisabled: null | string
    ariaErrorMessageElements: null | readonly Element[]
    ariaExpanded: null | string
    ariaFlowToElements: null | readonly Element[]
    ariaHasPopup: null | string
    ariaHidden: null | string
    ariaInvalid: null | string
    ariaKeyShortcuts: null | string
    ariaLabel: null | string
    ariaLabelledByElements: null | readonly Element[]
    ariaLevel: null | string
    ariaLive: null | string
    ariaModal: null | string
    ariaMultiLine: null | string
    ariaMultiSelectable: null | string
    ariaOrientation: null | string
    ariaOwnsElements: null | readonly Element[]
    ariaPlaceholder: null | string
    ariaPosInSet: null | string
    ariaPressed: null | string
    ariaReadOnly: null | string
    ariaRelevant: null | string
    ariaRequired: null | string
    ariaRoleDescription: null | string
    ariaRowCount: null | string
    ariaRowIndex: null | string
    ariaRowIndexText: null | string
    ariaRowSpan: null | string
    ariaSelected: null | string
    ariaSetSize: null | string
    ariaSort: null | string
    ariaValueMax: null | string
    ariaValueMin: null | string
    ariaValueNow: null | string
    ariaValueText: null | string
    assignedSlot: null | HTMLSlotElement
    ATTRIBUTE_NODE: 2
    attributes: NamedNodeMap

    The Element.attributes property returns a live collection of all attribute nodes registered to the specified node.

    MDN Reference

    attributeStyleMap: StylePropertyMap
    autocapitalize: string

    The autocapitalize property of the HTMLElement interface represents the element's capitalization behavior for user input.

    MDN Reference

    autocorrect: boolean

    The autocorrect property of the HTMLElement interface controls whether or not autocorrection of editable text is enabled for spelling and/or punctuation errors.

    MDN Reference

    autofocus: boolean
    baseURI: string

    The read-only baseURI property of the Node interface returns the absolute base URL of the document containing the node.

    MDN Reference

    CDATA_SECTION_NODE: 4

    node is a CDATASection node.

    childElementCount: number
    childNodes: NodeListOf<ChildNode>

    The read-only childNodes property of the Node interface returns a live the first child node is assigned index 0.

    MDN Reference

    children: HTMLCollection

    Returns the child elements.

    MDN Reference

    className: string

    The className property of the of the specified element.

    MDN Reference

    clientHeight: number

    The clientHeight read-only property of the Element interface is zero for elements with no CSS or inline layout boxes; otherwise, it's the inner height of an element in pixels.

    MDN Reference

    clientLeft: number

    The clientLeft read-only property of the Element interface returns the width of the left border of an element in pixels.

    MDN Reference

    clientTop: number

    The clientTop read-only property of the Element interface returns the width of the top border of an element in pixels.

    MDN Reference

    clientWidth: number

    The clientWidth read-only property of the Element interface is zero for inline elements and elements with no CSS; otherwise, it's the inner width of an element in pixels.

    MDN Reference

    COMMENT_NODE: 8

    node is a Comment node.

    contentEditable: string
    currentCSSZoom: number

    The currentCSSZoom read-only property of the Element interface provides the 'effective' CSS zoom of an element, taking into account the zoom applied to the element and all its parent elements.

    MDN Reference

    dataset: DOMStringMap
    dir: string

    The HTMLElement.dir property indicates the text writing directionality of the content of the current element.

    MDN Reference

    DOCUMENT_FRAGMENT_NODE: 11

    node is a DocumentFragment node.

    DOCUMENT_NODE: 9

    node is a document.

    DOCUMENT_POSITION_CONTAINED_BY: 16

    Set when other is a descendant of node.

    DOCUMENT_POSITION_CONTAINS: 8

    Set when other is an ancestor of node.

    DOCUMENT_POSITION_DISCONNECTED: 1

    Set when node and other are not in the same tree.

    DOCUMENT_POSITION_FOLLOWING: 4

    Set when other is following node.

    DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: 32
    DOCUMENT_POSITION_PRECEDING: 2

    Set when other is preceding node.

    DOCUMENT_TYPE_NODE: 10

    node is a doctype.

    draggable: boolean

    The draggable property of the HTMLElement interface gets and sets a Boolean primitive indicating if the element is draggable.

    MDN Reference

    ELEMENT_NODE: 1

    node is an element.

    enterKeyHint: string
    ENTITY_NODE: 6
    ENTITY_REFERENCE_NODE: 5
    firstChild: null | ChildNode

    The read-only firstChild property of the Node interface returns the node's first child in the tree, or null if the node has no children.

    MDN Reference

    firstElementChild: null | Element

    Returns the first child that is an element, and null otherwise.

    MDN Reference

    hidden: boolean

    The HTMLElement property hidden reflects the value of the element's hidden attribute.

    MDN Reference

    id: string

    The id property of the Element interface represents the element's identifier, reflecting the id global attribute.

    MDN Reference

    inert: boolean

    The HTMLElement property inert reflects the value of the element's inert attribute.

    MDN Reference

    innerHTML: string

    The innerHTML property of the Element interface gets or sets the HTML or XML markup contained within the element.

    MDN Reference

    innerText: string

    The innerText property of the HTMLElement interface represents the rendered text content of a node and its descendants.

    MDN Reference

    inputMode: string
    isConnected: boolean

    The read-only isConnected property of the Node interface returns a boolean indicating whether the node is connected (directly or indirectly) to a Document object.

    MDN Reference

    isContentEditable: boolean
    lang: string

    The lang property of the HTMLElement interface indicates the base language of an element's attribute values and text content, in the form of a MISSING: RFC(5646, 'BCP 47 language identifier tag')].

    MDN Reference

    lastChild: null | ChildNode

    The read-only lastChild property of the Node interface returns the last child of the node, or null if there are no child nodes.

    MDN Reference

    lastElementChild: null | Element

    Returns the last child that is an element, and null otherwise.

    MDN Reference

    localName: string

    The Element.localName read-only property returns the local part of the qualified name of an element.

    MDN Reference

    namespaceURI: null | string

    The Element.namespaceURI read-only property returns the namespace URI of the element, or null if the element is not in a namespace.

    MDN Reference

    nextElementSibling: null | Element

    Returns the first following sibling that is an element, and null otherwise.

    MDN Reference

    nextSibling: null | ChildNode

    The read-only nextSibling property of the Node interface returns the node immediately following the specified one in their parent's Node.childNodes, or returns null if the specified node is the last child in the parent element.

    MDN Reference

    nodeName: string

    The read-only nodeName property of Node returns the name of the current node as a string.

    MDN Reference

    nodeType: number

    The read-only nodeType property of a Node interface is an integer that identifies what the node is.

    MDN Reference

    nodeValue: null | string

    The nodeValue property of the Node interface returns or sets the value of the current node.

    MDN Reference

    nonce?: string
    NOTATION_NODE: 12
    offsetHeight: number

    The offsetHeight read-only property of the HTMLElement interface returns the height of an element, including vertical padding and borders, as an integer.

    MDN Reference

    offsetLeft: number

    The offsetLeft read-only property of the HTMLElement interface returns the number of pixels that the upper left corner of the current element is offset to the left within the HTMLElement.offsetParent node.

    MDN Reference

    offsetParent: null | Element

    The HTMLElement.offsetParent read-only property returns a reference to the element which is the closest (nearest in the containment hierarchy) positioned ancestor element.

    MDN Reference

    offsetTop: number

    The offsetTop read-only property of the HTMLElement interface returns the distance from the outer border of the current element (including its margin) to the top padding edge of the HTMLelement.offsetParent, the closest positioned ancestor element.

    MDN Reference

    offsetWidth: number

    The offsetWidth read-only property of the HTMLElement interface returns the layout width of an element as an integer.

    MDN Reference

    onabort: null | ((this: GlobalEventHandlers, ev: UIEvent) => any)
    onanimationcancel:
        | null
        | ((this: GlobalEventHandlers, ev: AnimationEvent) => any)
    onanimationend: null | ((this: GlobalEventHandlers, ev: AnimationEvent) => any)
    onanimationiteration:
        | null
        | ((this: GlobalEventHandlers, ev: AnimationEvent) => any)
    onanimationstart:
        | null
        | ((this: GlobalEventHandlers, ev: AnimationEvent) => any)
    onauxclick: null | ((this: GlobalEventHandlers, ev: PointerEvent) => any)
    onbeforeinput: null | ((this: GlobalEventHandlers, ev: InputEvent) => any)
    onbeforematch: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onbeforetoggle: null | ((this: GlobalEventHandlers, ev: ToggleEvent) => any)
    onblur: null | ((this: GlobalEventHandlers, ev: FocusEvent) => any)
    oncancel: null | ((this: GlobalEventHandlers, ev: Event) => any)
    oncanplay: null | ((this: GlobalEventHandlers, ev: Event) => any)
    oncanplaythrough: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onchange: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onclick: null | ((this: GlobalEventHandlers, ev: PointerEvent) => any)
    onclose: null | ((this: GlobalEventHandlers, ev: Event) => any)
    oncontextlost: null | ((this: GlobalEventHandlers, ev: Event) => any)
    oncontextmenu: null | ((this: GlobalEventHandlers, ev: PointerEvent) => any)
    oncontextrestored: null | ((this: GlobalEventHandlers, ev: Event) => any)
    oncopy: null | ((this: GlobalEventHandlers, ev: ClipboardEvent) => any)
    oncuechange: null | ((this: GlobalEventHandlers, ev: Event) => any)
    oncut: null | ((this: GlobalEventHandlers, ev: ClipboardEvent) => any)
    ondblclick: null | ((this: GlobalEventHandlers, ev: MouseEvent) => any)
    ondrag: null | ((this: GlobalEventHandlers, ev: DragEvent) => any)
    ondragend: null | ((this: GlobalEventHandlers, ev: DragEvent) => any)
    ondragenter: null | ((this: GlobalEventHandlers, ev: DragEvent) => any)
    ondragleave: null | ((this: GlobalEventHandlers, ev: DragEvent) => any)
    ondragover: null | ((this: GlobalEventHandlers, ev: DragEvent) => any)
    ondragstart: null | ((this: GlobalEventHandlers, ev: DragEvent) => any)
    ondrop: null | ((this: GlobalEventHandlers, ev: DragEvent) => any)
    ondurationchange: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onemptied: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onended: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onerror: OnErrorEventHandler
    onfocus: null | ((this: GlobalEventHandlers, ev: FocusEvent) => any)
    onformdata: null | ((this: GlobalEventHandlers, ev: FormDataEvent) => any)
    onfullscreenchange: null | ((this: Element, ev: Event) => any)
    onfullscreenerror: null | ((this: Element, ev: Event) => any)
    ongotpointercapture:
        | null
        | ((this: GlobalEventHandlers, ev: PointerEvent) => any)
    oninput: null | ((this: GlobalEventHandlers, ev: Event) => any)
    oninvalid: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onkeydown: null | ((this: GlobalEventHandlers, ev: KeyboardEvent) => any)
    onkeypress: null | ((this: GlobalEventHandlers, ev: KeyboardEvent) => any)

    MDN Reference

    onkeyup: null | ((this: GlobalEventHandlers, ev: KeyboardEvent) => any)
    onload: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onloadeddata: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onloadedmetadata: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onloadstart: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onlostpointercapture:
        | null
        | ((this: GlobalEventHandlers, ev: PointerEvent) => any)
    onmousedown: null | ((this: GlobalEventHandlers, ev: MouseEvent) => any)
    onmouseenter: null | ((this: GlobalEventHandlers, ev: MouseEvent) => any)
    onmouseleave: null | ((this: GlobalEventHandlers, ev: MouseEvent) => any)
    onmousemove: null | ((this: GlobalEventHandlers, ev: MouseEvent) => any)
    onmouseout: null | ((this: GlobalEventHandlers, ev: MouseEvent) => any)
    onmouseover: null | ((this: GlobalEventHandlers, ev: MouseEvent) => any)
    onmouseup: null | ((this: GlobalEventHandlers, ev: MouseEvent) => any)
    onpaste: null | ((this: GlobalEventHandlers, ev: ClipboardEvent) => any)
    onpause: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onplay: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onplaying: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onpointercancel: null | ((this: GlobalEventHandlers, ev: PointerEvent) => any)
    onpointerdown: null | ((this: GlobalEventHandlers, ev: PointerEvent) => any)
    onpointerenter: null | ((this: GlobalEventHandlers, ev: PointerEvent) => any)
    onpointerleave: null | ((this: GlobalEventHandlers, ev: PointerEvent) => any)
    onpointermove: null | ((this: GlobalEventHandlers, ev: PointerEvent) => any)
    onpointerout: null | ((this: GlobalEventHandlers, ev: PointerEvent) => any)
    onpointerover: null | ((this: GlobalEventHandlers, ev: PointerEvent) => any)
    onpointerrawupdate: null | ((this: GlobalEventHandlers, ev: Event) => any)

    Available only in secure contexts.

    MDN Reference

    onpointerup: null | ((this: GlobalEventHandlers, ev: PointerEvent) => any)
    onprogress: null | ((this: GlobalEventHandlers, ev: ProgressEvent) => any)
    onratechange: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onreset: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onresize: null | ((this: GlobalEventHandlers, ev: UIEvent) => any)
    onscroll: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onscrollend: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onsecuritypolicyviolation:
        | null
        | ((this: GlobalEventHandlers, ev: SecurityPolicyViolationEvent) => any)
    onseeked: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onseeking: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onselect: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onselectionchange: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onselectstart: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onslotchange: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onstalled: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onsubmit: null | ((this: GlobalEventHandlers, ev: SubmitEvent) => any)
    onsuspend: null | ((this: GlobalEventHandlers, ev: Event) => any)
    ontimeupdate: null | ((this: GlobalEventHandlers, ev: Event) => any)
    ontoggle: null | ((this: GlobalEventHandlers, ev: ToggleEvent) => any)
    ontouchcancel?: null | ((this: GlobalEventHandlers, ev: TouchEvent) => any)
    ontouchend?: null | ((this: GlobalEventHandlers, ev: TouchEvent) => any)
    ontouchmove?: null | ((this: GlobalEventHandlers, ev: TouchEvent) => any)
    ontouchstart?: null | ((this: GlobalEventHandlers, ev: TouchEvent) => any)
    ontransitioncancel:
        | null
        | ((this: GlobalEventHandlers, ev: TransitionEvent) => any)
    ontransitionend:
        | null
        | ((this: GlobalEventHandlers, ev: TransitionEvent) => any)
    ontransitionrun:
        | null
        | ((this: GlobalEventHandlers, ev: TransitionEvent) => any)
    ontransitionstart:
        | null
        | ((this: GlobalEventHandlers, ev: TransitionEvent) => any)
    onvolumechange: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onwaiting: null | ((this: GlobalEventHandlers, ev: Event) => any)
    onwebkitanimationend: null | ((this: GlobalEventHandlers, ev: Event) => any)

    This is a legacy alias of onanimationend.

    MDN Reference

    onwebkitanimationiteration:
        | null
        | ((this: GlobalEventHandlers, ev: Event) => any)

    This is a legacy alias of onanimationiteration.

    MDN Reference

    onwebkitanimationstart: null | ((this: GlobalEventHandlers, ev: Event) => any)

    This is a legacy alias of onanimationstart.

    MDN Reference

    onwebkittransitionend: null | ((this: GlobalEventHandlers, ev: Event) => any)

    This is a legacy alias of ontransitionend.

    MDN Reference

    onwheel: null | ((this: GlobalEventHandlers, ev: WheelEvent) => any)
    outerHTML: string

    The outerHTML attribute of the Element DOM interface gets the serialized HTML fragment describing the element including its descendants.

    MDN Reference

    outerText: string

    The outerText property of the HTMLElement interface returns the same value as HTMLElement.innerText.

    MDN Reference

    ownerDocument: Document

    The read-only ownerDocument property of the Node interface returns the top-level document object of the node.

    MDN Reference

    parentElement: null | HTMLElement

    The read-only parentElement property of Node interface returns the DOM node's parent Element, or null if the node either has no parent, or its parent isn't a DOM Element.

    MDN Reference

    parentNode: null | ParentNode

    The read-only parentNode property of the Node interface returns the parent of the specified node in the DOM tree.

    MDN Reference

    popover: null | string

    The popover property of the HTMLElement interface gets and sets an element's popover state via JavaScript ('auto', 'hint', or 'manual'), and can be used for feature detection.

    MDN Reference

    prefix: null | string

    The Element.prefix read-only property returns the namespace prefix of the specified element, or null if no prefix is specified.

    MDN Reference

    previousElementSibling: null | Element

    Returns the first preceding sibling that is an element, and null otherwise.

    MDN Reference

    previousSibling: null | ChildNode

    The read-only previousSibling property of the Node interface returns the node immediately preceding the specified one in its parent's or null if the specified node is the first in that list.

    MDN Reference

    PROCESSING_INSTRUCTION_NODE: 7

    node is a ProcessingInstruction node.

    role: null | string
    scrollHeight: number

    The scrollHeight read-only property of the Element interface is a measurement of the height of an element's content, including content not visible on the screen due to overflow.

    MDN Reference

    scrollLeft: number

    The scrollLeft property of the Element interface gets or sets the number of pixels by which an element's content is scrolled from its left edge.

    MDN Reference

    scrollTop: number

    The scrollTop property of the Element interface gets or sets the number of pixels by which an element's content is scrolled from its top edge.

    MDN Reference

    scrollWidth: number

    The scrollWidth read-only property of the Element interface is a measurement of the width of an element's content, including content not visible on the screen due to overflow.

    MDN Reference

    shadowRoot: null | ShadowRoot

    The Element.shadowRoot read-only property represents the shadow root hosted by the element.

    MDN Reference

    slot: string

    The slot property of the Element interface returns the name of the shadow DOM slot the element is inserted in.

    MDN Reference

    spellcheck: boolean

    The spellcheck property of the HTMLElement interface represents a boolean value that controls the spell-checking hint.

    MDN Reference

    tabIndex: number
    tagName: string

    The tagName read-only property of the Element interface returns the tag name of the element on which it's called.

    MDN Reference

    TEXT_NODE: 3

    node is a Text node.

    title: string

    The HTMLElement.title property represents the title of the element: the text usually displayed in a 'tooltip' popup when the mouse is over the node.

    MDN Reference

    translate: boolean

    The translate property of the HTMLElement interface indicates whether an element's attribute values and the values of its Text node children are to be translated when the page is localized, or whether to leave them unchanged.

    MDN Reference

    writingSuggestions: string

    The writingSuggestions property of the HTMLElement interface is a string indicating if browser-provided writing suggestions should be enabled under the scope of the element or not.

    MDN Reference

    _$litElement$: boolean
    _initializers?: Initializer[]
    "[metadata]": object & Record<PropertyKey, unknown>
    finalized: undefined | true

    Marks class as having been finalized, which includes creating properties from static properties, but does not include all properties created from decorators.

    • get classList(): DOMTokenList

      The Element.classList is a read-only property that returns a live DOMTokenList collection of the class attributes of the element.

      MDN Reference

      Returns DOMTokenList

    • set classList(value: string): void

      Parameters

      • value: string

      Returns void

    • get part(): DOMTokenList

      The part property of the Element interface represents the part identifier(s) of the element (i.e., set using the part attribute), returned as a DOMTokenList.

      MDN Reference

      Returns DOMTokenList

    • set part(value: string): void

      Parameters

      • value: string

      Returns void

    • get style(): CSSStyleDeclaration

      Returns CSSStyleDeclaration

    • set style(cssText: string): void

      Parameters

      • cssText: string

      Returns void

    • get textContent(): string

      Returns string

    • set textContent(value: null | string): void

      The textContent property of the Node interface represents the text content of the node and its descendants.

      MDN Reference

      Parameters

      • value: null | string

      Returns void

    • Type Parameters

      • K extends keyof HTMLElementEventMap

      Parameters

      • type: K
      • listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any
      • Optionaloptions: boolean | AddEventListenerOptions

      Returns void

    • Parameters

      • type: string
      • listener: EventListenerOrEventListenerObject
      • Optionaloptions: boolean | AddEventListenerOptions

      Returns void

    • Inserts nodes just after node, while replacing strings in nodes with equivalent Text nodes.

      Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

      MDN Reference

      Parameters

      • ...nodes: (string | Node)[]

      Returns void

    • Parameters

      • keyframes: null | PropertyIndexedKeyframes | Keyframe[]
      • Optionaloptions: number | KeyframeAnimationOptions

      Returns Animation

    • Inserts nodes after the last child of node, while replacing strings in nodes with equivalent Text nodes.

      Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

      MDN Reference

      Parameters

      • ...nodes: (string | Node)[]

      Returns void

    • The appendChild() method of the Node interface adds a node to the end of the list of children of a specified parent node.

      MDN Reference

      Type Parameters

      • T extends Node

      Parameters

      • node: T

      Returns T

    • The HTMLElement.attachInternals() method returns an ElementInternals object.

      MDN Reference

      Returns ElementInternals

    • The Element.attachShadow() method attaches a shadow DOM tree to the specified element and returns a reference to its ShadowRoot.

      MDN Reference

      Parameters

      • init: ShadowRootInit

      Returns ShadowRoot

    • Inserts nodes just before node, while replacing strings in nodes with equivalent Text nodes.

      Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

      MDN Reference

      Parameters

      • ...nodes: (string | Node)[]

      Returns void

    • Returns void

    • The checkVisibility() method of the Element interface checks whether the element is visible.

      MDN Reference

      Parameters

      • Optionaloptions: CheckVisibilityOptions

      Returns boolean

    • The HTMLElement.click() method simulates a mouse click on an element.

      MDN Reference

      Returns void

    • The cloneNode() method of the Node interface returns a duplicate of the node on which this method was called.

      MDN Reference

      Parameters

      • Optionalsubtree: boolean

      Returns Node

    • The closest() method of the Element interface traverses the element and its parents (heading toward the document root) until it finds a node that matches the specified CSS selector.

      MDN Reference

      Type Parameters

      • K extends keyof HTMLElementTagNameMap

      Parameters

      • selector: K

      Returns null | HTMLElementTagNameMap[K]

    • Type Parameters

      • K extends keyof SVGElementTagNameMap

      Parameters

      • selector: K

      Returns null | SVGElementTagNameMap[K]

    • Type Parameters

      • K extends keyof MathMLElementTagNameMap

      Parameters

      • selector: K

      Returns null | MathMLElementTagNameMap[K]

    • Type Parameters

      • E extends Element = Element

      Parameters

      • selectors: string

      Returns null | E

    • The compareDocumentPosition() method of the Node interface reports the position of its argument node relative to the node on which it is called.

      MDN Reference

      Parameters

      • other: Node

      Returns number

    • The computedStyleMap() method of the Element interface returns a StylePropertyMapReadOnly interface which provides a read-only representation of a CSS declaration block that is an alternative to CSSStyleDeclaration.

      MDN Reference

      Returns StylePropertyMapReadOnly

    • The contains() method of the Node interface returns a boolean value indicating whether a node is a descendant of a given node, that is the node itself, one of its direct children (Node.childNodes), one of the children's direct children, and so on.

      MDN Reference

      Parameters

      • other: null | Node

      Returns boolean

    • The dispatchEvent() method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.

      MDN Reference

      Parameters

      • event: Event

      Returns boolean

    • Parameters

      • Optionaloptions: FocusOptions

      Returns void

    • Parameters

      • Optionaloptions: GetAnimationsOptions

      Returns Animation[]

    • The getAttribute() method of the element.

      MDN Reference

      Parameters

      • qualifiedName: string

      Returns null | string

    • The getAttributeNames() method of the array.

      MDN Reference

      Returns string[]

    • Returns the specified attribute of the specified element, as an Attr node.

      MDN Reference

      Parameters

      • qualifiedName: string

      Returns null | Attr

    • The getAttributeNodeNS() method of the Element interface returns the namespaced Attr node of an element.

      MDN Reference

      Parameters

      • namespace: null | string
      • localName: string

      Returns null | Attr

    • The getAttributeNS() method of the Element interface returns the string value of the attribute with the specified namespace and name.

      MDN Reference

      Parameters

      • namespace: null | string
      • localName: string

      Returns null | string

    • The Element.getBoundingClientRect() method returns a position relative to the viewport.

      MDN Reference

      Returns DOMRect

    • The getClientRects() method of the Element interface returns a collection of DOMRect objects that indicate the bounding rectangles for each CSS border box in a client.

      MDN Reference

      Returns DOMRectList

    • The Element method getElementsByClassName() returns a live specified class name or names.

      MDN Reference

      Parameters

      • classNames: string

      Returns HTMLCollectionOf<Element>

    • The Element.getElementsByTagName() method returns a live All descendants of the specified element are searched, but not the element itself.

      MDN Reference

      Type Parameters

      • K extends keyof HTMLElementTagNameMap

      Parameters

      • qualifiedName: K

      Returns HTMLCollectionOf<HTMLElementTagNameMap[K]>

    • Type Parameters

      • K extends keyof SVGElementTagNameMap

      Parameters

      • qualifiedName: K

      Returns HTMLCollectionOf<SVGElementTagNameMap[K]>

    • Type Parameters

      • K extends keyof MathMLElementTagNameMap

      Parameters

      • qualifiedName: K

      Returns HTMLCollectionOf<MathMLElementTagNameMap[K]>

    • Type Parameters

      • K extends keyof HTMLElementDeprecatedTagNameMap

      Parameters

      • qualifiedName: K

      Returns HTMLCollectionOf<HTMLElementDeprecatedTagNameMap[K]>

    • Parameters

      • qualifiedName: string

      Returns HTMLCollectionOf<Element>

    • The Element.getElementsByTagNameNS() method returns a live HTMLCollection of elements with the given tag name belonging to the given namespace.

      MDN Reference

      Parameters

      • namespaceURI: "http://www.w3.org/1999/xhtml"
      • localName: string

      Returns HTMLCollectionOf<HTMLElement>

    • Parameters

      • namespaceURI: "http://www.w3.org/2000/svg"
      • localName: string

      Returns HTMLCollectionOf<SVGElement>

    • Parameters

      • namespaceURI: "http://www.w3.org/1998/Math/MathML"
      • localName: string

      Returns HTMLCollectionOf<MathMLElement>

    • Parameters

      • namespace: null | string
      • localName: string

      Returns HTMLCollectionOf<Element>

    • The getHTML() method of the Element interface is used to serialize an element's DOM to an HTML string.

      MDN Reference

      Parameters

      • Optionaloptions: GetHTMLOptions

      Returns string

    • The getRootNode() method of the Node interface returns the context object's root, which optionally includes the shadow root if it is available.

      MDN Reference

      Parameters

      • Optionaloptions: GetRootNodeOptions

      Returns Node

    • The Element.hasAttribute() method returns a Boolean value indicating whether the specified element has the specified attribute or not.

      MDN Reference

      Parameters

      • qualifiedName: string

      Returns boolean

    • The hasAttributeNS() method of the Element interface returns a boolean value indicating whether the current element has the specified attribute with the specified namespace.

      MDN Reference

      Parameters

      • namespace: null | string
      • localName: string

      Returns boolean

    • The hasAttributes() method of the Element interface returns a boolean value indicating whether the current element has any attributes or not.

      MDN Reference

      Returns boolean

    • The hasChildNodes() method of the Node interface returns a boolean value indicating whether the given Node has child nodes or not.

      MDN Reference

      Returns boolean

    • The hasPointerCapture() method of the pointer capture for the pointer identified by the given pointer ID.

      MDN Reference

      Parameters

      • pointerId: number

      Returns boolean

    • The hidePopover() method of the HTMLElement interface hides a popover element (i.e., one that has a valid popover attribute) by removing it from the top layer and styling it with display: none.

      MDN Reference

      Returns void

    • The insertAdjacentElement() method of the relative to the element it is invoked upon.

      MDN Reference

      Parameters

      • where: InsertPosition
      • element: Element

      Returns null | Element

    • The insertAdjacentHTML() method of the the resulting nodes into the DOM tree at a specified position.

      MDN Reference

      Parameters

      • position: InsertPosition
      • string: string

      Returns void

    • The insertAdjacentText() method of the Element interface, given a relative position and a string, inserts a new text node at the given position relative to the element it is called from.

      MDN Reference

      Parameters

      • where: InsertPosition
      • data: string

      Returns void

    • The insertBefore() method of the Node interface inserts a node before a reference node as a child of a specified parent node.

      MDN Reference

      Type Parameters

      • T extends Node

      Parameters

      • node: T
      • child: null | Node

      Returns T

    • The isDefaultNamespace() method of the Node interface accepts a namespace URI as an argument.

      MDN Reference

      Parameters

      • namespace: null | string

      Returns boolean

    • The isEqualNode() method of the Node interface tests whether two nodes are equal.

      MDN Reference

      Parameters

      • otherNode: null | Node

      Returns boolean

    • The isSameNode() method of the Node interface is a legacy alias the for the === strict equality operator.

      MDN Reference

      Parameters

      • otherNode: null | Node

      Returns boolean

    • The lookupNamespaceURI() method of the Node interface takes a prefix as parameter and returns the namespace URI associated with it on the given node if found (and null if not).

      MDN Reference

      Parameters

      • prefix: null | string

      Returns null | string

    • The lookupPrefix() method of the Node interface returns a string containing the prefix for a given namespace URI, if present, and null if not.

      MDN Reference

      Parameters

      • namespace: null | string

      Returns null | string

    • The matches() method of the Element interface tests whether the element would be selected by the specified CSS selector.

      MDN Reference

      Parameters

      • selectors: string

      Returns boolean

    • The normalize() method of the Node interface puts the specified node and all of its sub-tree into a normalized form.

      MDN Reference

      Returns void

    • Inserts nodes before the first child of node, while replacing strings in nodes with equivalent Text nodes.

      Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

      MDN Reference

      Parameters

      • ...nodes: (string | Node)[]

      Returns void

    • Returns the first element that is a descendant of node that matches selectors.

      MDN Reference

      Type Parameters

      • K extends keyof HTMLElementTagNameMap

      Parameters

      • selectors: K

      Returns null | HTMLElementTagNameMap[K]

    • Type Parameters

      • K extends keyof SVGElementTagNameMap

      Parameters

      • selectors: K

      Returns null | SVGElementTagNameMap[K]

    • Type Parameters

      • K extends keyof MathMLElementTagNameMap

      Parameters

      • selectors: K

      Returns null | MathMLElementTagNameMap[K]

    • Type Parameters

      • K extends keyof HTMLElementDeprecatedTagNameMap

      Parameters

      • selectors: K

      Returns null | HTMLElementDeprecatedTagNameMap[K]

    • Type Parameters

      • E extends Element = Element

      Parameters

      • selectors: string

      Returns null | E

    • Returns all element descendants of node that match selectors.

      MDN Reference

      Type Parameters

      • K extends keyof HTMLElementTagNameMap

      Parameters

      • selectors: K

      Returns NodeListOf<HTMLElementTagNameMap[K]>

    • Type Parameters

      • K extends keyof SVGElementTagNameMap

      Parameters

      • selectors: K

      Returns NodeListOf<SVGElementTagNameMap[K]>

    • Type Parameters

      • K extends keyof MathMLElementTagNameMap

      Parameters

      • selectors: K

      Returns NodeListOf<MathMLElementTagNameMap[K]>

    • Type Parameters

      • K extends keyof HTMLElementDeprecatedTagNameMap

      Parameters

      • selectors: K

      Returns NodeListOf<HTMLElementDeprecatedTagNameMap[K]>

    • Type Parameters

      • E extends Element = Element

      Parameters

      • selectors: string

      Returns NodeListOf<E>

    • The releasePointerCapture() method of the previously set for a specific (PointerEvent) pointer.

      MDN Reference

      Parameters

      • pointerId: number

      Returns void

    • Removes node.

      MDN Reference

      Returns void

    • The Element method removeAttribute() removes the attribute with the specified name from the element.

      MDN Reference

      Parameters

      • qualifiedName: string

      Returns void

    • The removeAttributeNode() method of the Element interface removes the specified Attr node from the element.

      MDN Reference

      Parameters

      • attr: Attr

      Returns Attr

    • The removeAttributeNS() method of the If you are working with HTML and you don't need to specify the requested attribute as being part of a specific namespace, use the Element.removeAttribute() method instead.

      MDN Reference

      Parameters

      • namespace: null | string
      • localName: string

      Returns void

    • The removeChild() method of the Node interface removes a child node from the DOM and returns the removed node.

      MDN Reference

      Type Parameters

      • T extends Node

      Parameters

      • child: T

      Returns T

    • Type Parameters

      • K extends keyof HTMLElementEventMap

      Parameters

      • type: K
      • listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any
      • Optionaloptions: boolean | EventListenerOptions

      Returns void

    • Parameters

      • type: string
      • listener: EventListenerOrEventListenerObject
      • Optionaloptions: boolean | EventListenerOptions

      Returns void

    • The replaceChild() method of the Node interface replaces a child node within the given (parent) node.

      MDN Reference

      Type Parameters

      • T extends Node

      Parameters

      • node: Node
      • child: T

      Returns T

    • Replace all children of node with nodes, while replacing strings in nodes with equivalent Text nodes.

      Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

      MDN Reference

      Parameters

      • ...nodes: (string | Node)[]

      Returns void

    • Replaces node with nodes, while replacing strings in nodes with equivalent Text nodes.

      Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

      MDN Reference

      Parameters

      • ...nodes: (string | Node)[]

      Returns void

    • The Element.requestFullscreen() method issues an asynchronous request to make the element be displayed in fullscreen mode.

      MDN Reference

      Parameters

      • Optionaloptions: FullscreenOptions

      Returns Promise<void>

    • The requestPointerLock() method of the Element interface lets you asynchronously ask for the pointer to be locked on the given element.

      MDN Reference

      Parameters

      • Optionaloptions: PointerLockOptions

      Returns Promise<void>

    • The scroll() method of the Element interface scrolls the element to a particular set of coordinates inside a given element.

      MDN Reference

      Parameters

      • Optionaloptions: ScrollToOptions

      Returns void

    • Parameters

      • x: number
      • y: number

      Returns void

    • The scrollBy() method of the Element interface scrolls an element by the given amount.

      MDN Reference

      Parameters

      • Optionaloptions: ScrollToOptions

      Returns void

    • Parameters

      • x: number
      • y: number

      Returns void

    • The Element interface's scrollIntoView() method scrolls the element's ancestor containers such that the element on which scrollIntoView() is called is visible to the user.

      MDN Reference

      Parameters

      • Optionalarg: boolean | ScrollIntoViewOptions

      Returns void

    • The scrollTo() method of the Element interface scrolls to a particular set of coordinates inside a given element.

      MDN Reference

      Parameters

      • Optionaloptions: ScrollToOptions

      Returns void

    • Parameters

      • x: number
      • y: number

      Returns void

    • The setAttribute() method of the Element interface sets the value of an attribute on the specified element.

      MDN Reference

      Parameters

      • qualifiedName: string
      • value: string

      Returns void

    • The setAttributeNode() method of the Element interface adds a new Attr node to the specified element.

      MDN Reference

      Parameters

      • attr: Attr

      Returns null | Attr

    • The setAttributeNodeNS() method of the Element interface adds a new namespaced Attr node to an element.

      MDN Reference

      Parameters

      • attr: Attr

      Returns null | Attr

    • setAttributeNS adds a new attribute or changes the value of an attribute with the given namespace and name.

      MDN Reference

      Parameters

      • namespace: null | string
      • qualifiedName: string
      • value: string

      Returns void

    • The setHTMLUnsafe() method of the Element interface is used to parse a string of HTML into a DocumentFragment, optionally filtering out unwanted elements and attributes, and those that don't belong in the context, and then using it to replace the element's subtree in the DOM.

      MDN Reference

      Parameters

      • html: string

      Returns void

    • The setPointerCapture() method of the capture target of future pointer events.

      MDN Reference

      Parameters

      • pointerId: number

      Returns void

    • The showPopover() method of the HTMLElement interface shows a Popover_API element (i.e., one that has a valid popover attribute) by adding it to the top layer.

      MDN Reference

      Returns void

    • The toggleAttribute() method of the present and adding it if it is not present) on the given element.

      MDN Reference

      Parameters

      • qualifiedName: string
      • Optionalforce: boolean

      Returns boolean

    • The togglePopover() method of the HTMLElement interface toggles a Popover_API element (i.e., one that has a valid popover attribute) between the hidden and showing states.

      MDN Reference

      Parameters

      • Optionaloptions: boolean

      Returns boolean

    • Parameters

      • selectors: string

      Returns boolean

      This is a legacy alias of matches.

      MDN Reference

    • Adds an initializer function to the class that is called during instance construction.

      This is useful for code that runs against a ReactiveElement subclass, such as a decorator, that needs to do work for each instance, such as setting up a ReactiveController.

      const myDecorator = (target: typeof ReactiveElement, key: string) => {
      target.addInitializer((instance: ReactiveElement) => {
      // This is run during construction of the element
      new MyController(instance);
      });
      }

      Decorating a field will then cause each instance to run an initializer that adds a controller:

      class MyElement extends LitElement {
      @myDecorator foo;
      }

      Initializers are stored per-constructor. Adding an initializer to a subclass does not add it to a superclass. Since initializers are run in constructors, initializers will run in order of the class hierarchy, starting with superclasses and progressing to the instance's class.

      Parameters

      • initializer: Initializer

      Returns void

    • Finishes setting up the class so that it's ready to be registered as a custom element and instantiated.

      This method is called by the ReactiveElement.observedAttributes getter. If you override the observedAttributes getter, you must either call super.observedAttributes to trigger finalization, or call finalize() yourself.

      Returns void

    attributes

    • get observedAttributes(): string[]

      Returns a list of attributes corresponding to the registered properties.

      Returns string[]

    • Synchronizes property values when attributes change.

      Specifically, when an attribute is set, the corresponding property is set. You should rarely need to implement this callback. If this method is overridden, super.attributeChangedCallback(name, _old, value) must be called.

      See responding to attribute changes on MDN for more information about the attributeChangedCallback.

      Parameters

      • name: string
      • _old: null | string
      • value: null | string

      Returns void

    controllers

    • Registers a ReactiveController to participate in the element's reactive update cycle. The element automatically calls into any registered controllers during its lifecycle callbacks.

      If the element is connected when addController() is called, the controller's hostConnected() callback will be immediately called.

      Parameters

      • controller: ReactiveController

      Returns void

    • Removes a ReactiveController from the element.

      Parameters

      • controller: ReactiveController

      Returns void

    dev-mode

    disableWarning?: (warningKind: WarningKind) => void

    Disable the given warning category for this class.

    This method only exists in development builds, so it should be accessed with a guard like:

    // Disable for all ReactiveElement subclasses
    ReactiveElement.disableWarning?.('migration');

    // Disable for only MyElement and subclasses
    MyElement.disableWarning?.('migration');
    enabledWarnings?: WarningKind[]

    Read or set all the enabled warning categories for this class.

    This property is only used in development builds.

    enableWarning?: (warningKind: WarningKind) => void

    Enable the given warning category for this class.

    This method only exists in development builds, so it should be accessed with a guard like:

    // Enable for all ReactiveElement subclasses
    ReactiveElement.enableWarning?.('migration');

    // Enable for only MyElement and subclasses
    MyElement.enableWarning?.('migration');

    lifecycle

    • Invoked when the component is added to the document's DOM.

      In connectedCallback() you should setup tasks that should only occur when the element is connected to the document. The most common of these is adding event listeners to nodes external to the element, like a keydown event handler added to the window.

      connectedCallback() {
      super.connectedCallback();
      addEventListener('keydown', this._handleKeydown);
      }

      Typically, anything done in connectedCallback() should be undone when the element is disconnected, in disconnectedCallback().

      Returns void

    • Invoked when the component is removed from the document's DOM.

      This callback is the main signal to the element that it may no longer be used. disconnectedCallback() should ensure that nothing is holding a reference to the element (such as event listeners added to nodes external to the element), so that it is free to be garbage collected.

      disconnectedCallback() {
      super.disconnectedCallback();
      window.removeEventListener('keydown', this._handleKeydown);
      }

      An element may be re-connected after being disconnected.

      Returns void

    properties

    elementProperties: PropertyDeclarationMap

    Memoized list of all element properties, including any superclass properties. Created lazily on user subclasses when finalizing the class.

    properties: PropertyDeclarations

    User-supplied object that maps property names to PropertyDeclaration objects containing options for configuring reactive properties. When a reactive property is set the element will update and render.

    By default properties are public fields, and as such, they should be considered as primarily settable by element users, either via attribute or the property itself.

    Generally, properties that are changed by the element should be private or protected fields and should use the state: true option. Properties marked as state do not reflect from the corresponding attribute

    However, sometimes element code does need to set a public property. This should typically only be done in response to user interaction, and an event should be fired informing the user; for example, a checkbox sets its checked property when clicked and fires a changed event. Mutating public properties should typically not be done for non-primitive (object or array) properties. In other cases when an element needs to manage state, a private property set with the state: true option should be used. When needed, state properties can be initialized via public properties to facilitate complex interactions.

    • Creates a property accessor on the element prototype if one does not exist and stores a PropertyDeclaration for the property with the given options. The property setter calls the property's hasChanged property option or uses a strict identity check to determine whether or not to request an update.

      This method may be overridden to customize properties; however, when doing so, it's important to call super.createProperty to ensure the property is setup correctly. This method calls getPropertyDescriptor internally to get a descriptor to install. To customize what properties do when they are get or set, override getPropertyDescriptor. To customize the options for a property, implement createProperty like this:

      static createProperty(name, options) {
      options = Object.assign(options, {myOption: true});
      super.createProperty(name, options);
      }

      Parameters

      • name: PropertyKey
      • Optionaloptions: PropertyDeclaration<unknown, unknown>

      Returns void

    • Returns a property descriptor to be defined on the given named property. If no descriptor is returned, the property will not become an accessor. For example,

      class MyElement extends LitElement {
      static getPropertyDescriptor(name, key, options) {
      const defaultDescriptor =
      super.getPropertyDescriptor(name, key, options);
      const setter = defaultDescriptor.set;
      return {
      get: defaultDescriptor.get,
      set(value) {
      setter.call(this, value);
      // custom action.
      },
      configurable: true,
      enumerable: true
      }
      }
      }

      Parameters

      • name: PropertyKey
      • key: string | symbol
      • options: PropertyDeclaration

      Returns undefined | PropertyDescriptor

    • Returns the property options associated with the given property. These options are defined with a PropertyDeclaration via the properties object or the @property decorator and are registered in createProperty(...).

      Note, this method should be considered "final" and not overridden. To customize the options for a given property, override createProperty.

      Parameters

      • name: PropertyKey

      Returns PropertyDeclaration<unknown, unknown>

    rendering

    renderOptions: RenderOptions
    renderRoot: DocumentFragment | HTMLElement

    Node or ShadowRoot into which element DOM should be rendered. Defaults to an open shadowRoot.

    shadowRootOptions: ShadowRootInit

    Options used when calling attachShadow. Set this property to customize the options for the shadowRoot; for example, to create a closed shadowRoot: {mode: 'closed'}.

    Note, these options are used in createRenderRoot. If this method is customized, options should be respected if possible.

    • Returns DocumentFragment | HTMLElement

    • Invoked on each update to perform rendering tasks. This method may return any value renderable by lit-html's ChildPart - typically a TemplateResult. Setting properties inside this method will not trigger the element to update.

      Returns TemplateResult<1>

    styles

    elementStyles: CSSResultOrNative[]

    Memoized list of all element styles. Created lazily on user subclasses when finalizing the class.

    styles: CSSResult = ...

    Array of styles to apply to the element. The styles should be defined using the css tag function, via constructible stylesheets, or imported from native CSS module scripts.

    Note on Content Security Policy:

    Element styles are implemented with <style> tags when the browser doesn't support adopted StyleSheets. To use such <style> tags with the style-src CSP directive, the style-src value must either include 'unsafe-inline' or nonce-<base64-value> with <base64-value> replaced be a server-generated nonce.

    To provide a nonce to use on generated <style> elements, set window.litNonce to a server-generated nonce in your page's HTML, before loading application code:

    <script>
    // Generated and unique per request:
    window.litNonce = 'a1b2c3d4';
    </script>
    • Takes the styles the user supplied via the static styles property and returns the array of styles to apply to the element. Override this method to integrate into a style management system.

      Styles are deduplicated preserving the last instance in the list. This is a performance optimization to avoid duplicated styles that can occur especially when composing via subclassing. The last item is kept to try to preserve the cascade order with the assumption that it's most important that last added styles override previous styles.

      Parameters

      • Optionalstyles: CSSResultGroup

      Returns CSSResultOrNative[]

    updates

    hasUpdated: boolean

    Is set to true after the first update. The element code cannot assume that renderRoot exists before the element hasUpdated.

    isUpdatePending: boolean

    True if there is a pending update as a result of calling requestUpdate(). Should only be read.

    • get updateComplete(): Promise<boolean>

      Returns a Promise that resolves when the element has completed updating. The Promise value is a boolean that is true if the element completed the update without triggering another update. The Promise result is false if a property was set inside updated(). If the Promise is rejected, an exception was thrown during the update.

      To await additional asynchronous work, override the getUpdateComplete method. For example, it is sometimes useful to await a rendered element before fulfilling this Promise. To do this, first await super.getUpdateComplete(), then any subsequent state.

      Returns Promise<boolean>

      A promise of a boolean that resolves to true if the update completed without triggering another update.

    • Note, this method should be considered final and not overridden. It is overridden on the element instance with a function that triggers the first update.

      Parameters

      • _requestedUpdate: boolean

      Returns void

    • Invoked when the element is first updated. Implement to perform one time work on the element after update.

      firstUpdated() {
      this.renderRoot.getElementById('my-text-area').focus();
      }

      Setting properties inside this method will trigger the element to update again after this update cycle completes.

      Parameters

      • _changedProperties: Map<PropertyKey, unknown> | PropertyValueMap<any>

        Map of changed properties with old values

      Returns void

    • Override point for the updateComplete promise.

      It is not safe to override the updateComplete getter directly due to a limitation in TypeScript which means it is not possible to call a superclass getter (e.g. super.updateComplete.then(...)) when the target language is ES5 (https://github.com/microsoft/TypeScript/issues/338). This method should be overridden instead. For example:

      class MyElement extends LitElement {
      override async getUpdateComplete() {
      const result = await super.getUpdateComplete();
      await this._myChild.updateComplete;
      return result;
      }
      }

      Returns Promise<boolean>

      A promise of a boolean that resolves to true if the update completed without triggering another update.

    • Performs an element update. Note, if an exception is thrown during the update, firstUpdated and updated will not be called.

      Call performUpdate() to immediately process a pending update. This should generally not be needed, but it can be done in rare cases when you need to update synchronously.

      Returns void

    • Requests an update which is processed asynchronously. This should be called when an element should update based on some state not triggered by setting a reactive property. In this case, pass no arguments. It should also be called when manually implementing a property setter. In this case, pass the property name and oldValue to ensure that any configured property options are honored.

      Parameters

      • Optionalname: PropertyKey

        name of requesting property

      • OptionaloldValue: unknown

        old value of requesting property

      • Optionaloptions: PropertyDeclaration<unknown, unknown>

        property options to use instead of the previously configured options

      Returns void

    • Schedules an element update. You can override this method to change the timing of updates by returning a Promise. The update will await the returned Promise, and you should resolve the Promise to allow the update to proceed. If this method is overridden, super.scheduleUpdate() must be called.

      For instance, to schedule updates to occur just before the next frame:

      override protected async scheduleUpdate(): Promise<unknown> {
      await new Promise((resolve) => requestAnimationFrame(() => resolve()));
      super.scheduleUpdate();
      }

      Returns void | Promise<unknown>

    • Controls whether or not update() should be called when the element requests an update. By default, this method always returns true, but this can be customized to control when to update.

      Parameters

      • _changedProperties: Map<PropertyKey, unknown> | PropertyValueMap<any>

        Map of changed properties with old values

      Returns boolean

    • Updates the element. This method reflects property values to attributes and calls render to render DOM via lit-html. Setting properties inside this method will not trigger another update.

      Parameters

      • changedProperties: Map<PropertyKey, unknown> | PropertyValueMap<any>

        Map of changed properties with old values

      Returns void

    • Invoked whenever the element is updated. Implement to perform post-updating tasks via DOM APIs, for example, focusing an element.

      Setting properties inside this method will trigger the element to update again after this update cycle completes.

      Parameters

      • _changedProperties: Map<PropertyKey, unknown> | PropertyValueMap<any>

        Map of changed properties with old values

      Returns void

    • Invoked before update() to compute values needed during the update.

      Implement willUpdate to compute property values that depend on other properties and are used in the rest of the update process.

      willUpdate(changedProperties) {
      // only need to check changed properties for an expensive computation.
      if (changedProperties.has('firstName') || changedProperties.has('lastName')) {
      this.sha = computeSHA(`${this.firstName} ${this.lastName}`);
      }
      }

      render() {
      return html`SHA: ${this.sha}`;
      }

      Parameters

      • _changedProperties: Map<PropertyKey, unknown> | PropertyValueMap<any>

      Returns void