LiveNode class

Reactive boundary — re-evaluates builder inside a signal effect and patches only its own DOM region.

DOM Mounting and Sentinels

In the browser, LiveNode mounts to a pair of sentinel comments: <!-- bloom:live --> and <!-- /bloom:live -->.

It establishes a fine-grained signals effect that automatically tracks all signal reads occurring synchronously within builder. When any tracked signal updates, the effect runs:

  1. Disposes all child effects, event listeners, and subscriptions owned by the previous subtree's _Region.
  2. Executes builder to obtain the new descriptor tree.
  3. Updates or reconciles the DOM nodes positioned strictly between the sentinel comments, leaving the surrounding DOM untouched.

SSR Behavior

During server-side rendering (renderToHtml), builder is executed exactly once synchronously to produce the static HTML output. No signals effects or sentinels are created on the server.

Usually created using the DSL sugar Live.

Inheritance

Constructors

LiveNode(BloomNode builder())
Creates a reactive boundary descriptor driven by builder.
const

Properties

builder BloomNode Function()
The reactive builder callback invoked to produce this boundary's subtree.
final
hashCode int
The hash code for this object.
no setterinherited
runtimeType Type
A representation of the runtime type of the object.
no setterinherited

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() String
A string representation of this object.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited