API reference
Preparing search index…

ElementInstancer

Checked native allocation/release customization for Rml::ElementInstancer.

Return a detached element allocated by a concrete Element constructor, another ElementInstancer's instanceElement method, or null. Provenance stays through nested instancers, cloning and registry replacement. Factory applies attributes and plugin notifications after allocation; direct instanceElement calls follow the selected instancer's behavior. Callbacks may instance through other instancers and inspect copied values. DOM mutation, registration changes and recursive calls are rejected. Registered instancers remain alive through shutdown. Unregistered instances follow native trees or visible detached ownership edges, allowing GC cycles. Native destruction is synchronous. Release observers receive a snapshot at the next safe boundary, after destruction, including when GC runs inside an instancing callback. Collected observers and environment cleanup do not invoke JS. Shutdown invalidates all instances.

Source & inheritance
Member directory3

Constructors

Methods

Constructors

Methods

  • Invoke this native instancer without inserting the returned element.

    Parameters

    parent
    null | Element

    Proposed parent or null, supplied to the native instancer.

    tag
    string

    Native tag for the new element.

    attributes
    Record<string, VariantValue> = {}

    Snapshot supplied to the allocator, without setters.

    Returns

    null | Element

    Owned detached element or null.

    Source & inheritance

Icons made by Lorc, Delapouite & Skoll · game-icons.net · CC BY 3.0