Create a native instancer with allocation and optional release observers.
createReturn a newly allocated detached native element or null.
releaseOptionalObserve the pre-destruction snapshot at a safe boundary.
Invoke this native instancer without inserting the returned element.
parentProposed parent or null, supplied to the native instancer.
tagNative tag for the new element.
attributesSnapshot supplied to the allocator, without setters.
Owned detached element or null.
Release a detached owned element allocated by this exact instancer.
elementOwned element; borrowed, attached and active nodes fail.
Checked native allocation/release customization for Rml::ElementInstancer.
Remarks
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.