VoltX.js

Appearance

lifecycle ​

Global lifecycle hook system for VoltX.js Provides beforeMount, afterMount, beforeUnmount, and afterUnmount hooks

registerGlobalHook ​

Register a global lifecycle hook. Global hooks run for every mount/unmount operation in the application.

typescript
export function registerGlobalHook(name: GlobalHookName, cb: MountHookCallback | UnmountHookCallback): () => void

Example:

typescript
// Log every mount operation
registerGlobalHook('beforeMount', (root, scope) => {
  console.log('Mounting', root, 'with scope', scope);
});

// Track mounted elements
const mountedElements = new Set<Element>();
registerGlobalHook('afterMount', (root) => {
  mountedElements.add(root);
});
registerGlobalHook('beforeUnmount', (root) => {
  mountedElements.delete(root);
});

unregisterGlobalHook ​

Unregister a global lifecycle hook.

typescript
export function unregisterGlobalHook(name: GlobalHookName, cb: MountHookCallback | UnmountHookCallback): boolean

clearGlobalHooks ​

Clear all global hooks for a specific lifecycle event.

typescript
export function clearGlobalHooks(name: GlobalHookName): void

clearAllGlobalHooks ​

typescript
export function clearAllGlobalHooks(): void

getGlobalHooks ​

Get all registered hooks for a specific lifecycle event. Used internally by the binder system.

typescript
export function getGlobalHooks(name: GlobalHookName): Array<MountHookCallback | UnmountHookCallback>

executeGlobalHooks ​

Execute all registered hooks for a lifecycle event. Used internally by the binder system.

typescript
export function executeGlobalHooks(hookName: GlobalHookName, root: Element, scope?: Scope): void

registerElementHook ​

Register a per-element lifecycle hook. These hooks are specific to individual elements.

typescript
export function registerElementHook(element: Element, hookType: "mount" | "unmount", cb: () => void): void

notifyElementMounted ​

Notify that an element has been mounted. Executes all registered onMount callbacks for the element.

typescript
export function notifyElementMounted(element: Element): void

notifyElementUnmounted ​

Notify that an element is being unmounted. Executes all registered onUnmount callbacks for the element.

typescript
export function notifyElementUnmounted(element: Element): void

notifyBindingCreated ​

Notify that a binding has been created on an element.

typescript
export function notifyBindingCreated(element: Element, name: string): void

notifyBindingDestroyed ​

Notify that a binding has been destroyed on an element.

typescript
export function notifyBindingDestroyed(element: Element, name: string): void

isElementMounted ​

Check if an element is currently mounted.

typescript
export function isElementMounted(element: Element): boolean

getElementBindings ​

Get all bindings on an element.

typescript
export function getElementBindings(element: Element): string[]