Aberdeen - v1.0.3
    Preparing search index...

    Function ref

    • Creates a reactive reference ({ value: T }-like object) to a specific value within a proxied object or array.

      This is primarily used for the bind property in $ to create two-way data bindings with form elements, and for passing a reactive property to any of the $ key-value pairs.

      Reading ref.value accesses the property from the underlying proxy (and subscribes the current scope). Assigning to ref.value updates the property in the underlying proxy (triggering reactive updates).

      Type Parameters

      • T extends TargetType
      • K extends string | number | symbol

      Parameters

      • target: T

        The reactive proxy (created by proxy) containing the target property.

      • index: K

        The key (for objects) or index (for arrays) of the property to reference.

      Returns ValueRef<T[K]>

      A reference object with a value property linked to the specified proxy property.

      const formData = proxy({ color: 'orange', velocity: 42 });

      // Usage with `bind`
      $('input', {
      type: 'text',
      // Creates a two-way binding between the input's value and formData.username
      bind: ref(formData, 'color')
      });

      // Usage as a dynamic property, causes a TextNode with just the name to be created and live-updated
      $('p:Selected color: ', {
      text: ref(formData, 'color'),
      $color: ref(formData, 'color')
      });

      // Changes are actually stored in formData - this causes logs like `{color: "Blue", velocity 42}`
      $(() => console.log(formData))