Interface Binding<GetType>

A binding is a stored piece of data that notifies registered listeners when changed.

See

useBinding

interface Binding<GetType> {
    addChangeListener: ((listener: ChangeListener) => ChangeListenerRemover);
    get: (() => GetType);
    getChangeUid: (() => string);
    id: string;
    isBinding: true;
    isLocked: (() => boolean);
    isModified: (() => boolean);
    lock: (() => (() => void));
    reset: (() => void);
    set: ((newValue: GetType) => void);
    setIsModified: ((isModified: boolean) => void);
    setRaw: ((newValue: GetType) => void);
    setValueTransformer?: SetValueTransformer<GetType>;
    triggerChangeListeners: (() => void);
    uid: string;
}

Type Parameters

  • GetType = any

Hierarchy (view full)

Properties

addChangeListener get getChangeUid id isBinding isLocked isModified lock reset set setIsModified setRaw setValueTransformer? triggerChangeListeners uid

Properties

ReadonlyaddChangeListener

addChangeListener: ((listener: ChangeListener) => ChangeListenerRemover)

Adds a listener that will be called when this binding changes.

Type declaration

See

useBindingEffect and BindingsConsumer

Readonlyget

get: (() => GetType)

Type declaration

ReadonlygetChangeUid

getChangeUid: (() => string)

Every time the value is changed, the change uid is updated

Readonlyid

id: string

A technical, but human-readable ID, which isn't guaranteed to be unique

ReadonlyisBinding

isBinding: true

A marker indicating that this is a binding type

ReadonlyisLocked

isLocked: (() => boolean)

Type declaration

    • (): boolean

    • Returns boolean

      true if the binding is locked

ReadonlyisModified

isModified: (() => boolean)

Type declaration

    • (): boolean

    • Returns boolean

      true if this binding has been marked as being modified

Readonlylock

lock: (() => (() => void))

Increments the lock count and returns a method to decrement it. A binding is locked if its lock count is > 0. When a binding is locked, mutating calls (reset/set/setRaw) won't have an immediate effect. However, if a mutating call is made on a locked binding, the change will be applied once the binding becomes unlocked.

Type declaration

    • (): (() => void)

    • Returns (() => void)

      a function for decrementing this binding's lock count.

        • (): void

        • Returns void

Readonlyreset

reset: (() => void)

Resets the binding back to its initial value and marks the binding as non-modified.

Readonlyset

set: ((newValue: GetType) => void)

Sets the value, using the result of setValueTransformer if set, and then marks the binding as modified.

ReadonlysetIsModified

setIsModified: ((isModified: boolean) => void)

Sets the binding as having been modified or not

ReadonlysetRaw

setRaw: ((newValue: GetType) => void)

Sets the internal value without transforming or marking as changed. Don't normally use this!

Optional ReadonlysetValueTransformer

setValueTransformer?: SetValueTransformer<GetType>

If set, a function to transform the value before it's stored

ReadonlytriggerChangeListeners

triggerChangeListeners: (() => void)

Forcibly triggers the change listeners. Don't normally use this!

Readonlyuid

uid: string

An ID that's unique to this runtime

Settings

Member Visibility

On This Page

Properties