BloomIslandInstance class

Represents an individual island placeholder element discovered in the browser DOM.

Tracks the island's name, host element, parsed props, assigned HydrationStrategy, and active lifecycle status. Owns the BloomMountHandle once hydrated.

final orchestrator = orchestrateIslands();
for (final island in orchestrator.islands) {
  print('Discovered island: ${island.name} [${island.status}]');
}

Properties

element → Element
The host DOM element carrying the data-bloom-island placeholder attribute.
final
error Object?
The error object thrown if hydration failed, or null.
no setter
hashCode int
The hash code for this object.
no setterinherited
isDisposed bool
Whether this island has been disposed.
no setter
isFailed bool
Whether hydration failed due to a builder or DOM exception.
no setter
isHydrated bool
Whether this island has successfully hydrated.
no setter
isPending bool
Whether this island is still awaiting its strategy trigger.
no setter
mountHandle BloomMountHandle?
The active BloomMountHandle managing this island's reactive scope, or null if not hydrated.
no setter
name String
The registered name of this island (e.g. 'shopping-cart').
final
props Map<String, dynamic>
The decoded props payload passed to the island builder.
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
stackTrace StackTrace?
The stack trace captured if hydration failed, or null.
no setter
status IslandStatus
The current lifecycle status of this island instance.
no setter
strategy HydrationStrategy
The hydration strategy governing when this island activates.
final

Methods

dispose() → void
Disposes this island instance, releasing reactive effects and unmounting DOM listeners.
hydrate() Future<BloomMountHandle?>
Triggers immediate hydration of this island instance.
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