The ItemList class collects items and then arranges them into an array by priority.

Type Parameters

  • T

Hierarchy

  • ItemList

Constructors

Properties

_items: Record<string, Item<T>> = {}

The items in the list.

Accessors

Methods

  • Add an item to the list.

    Parameters

    • key: string

      A unique key for the item.

    • content: T

      The item's content.

    • priority: number = 0

      The priority of the item. Items with a higher priority will be positioned before items with a lower priority.

    Returns ItemList<T>

  • Internal

    Proxies an item's content, adding the itemName readonly property to it.

    Example

    createItemContentProxy({ foo: 'bar' }, 'myItem');
    // { foo: 'bar', itemName: 'myItem' }

    Returns

    Proxied content

    Type Parameters

    • C extends object

    Parameters

    • content: C

      The item's content (objects only)

    • key: string

      The item's key

    Returns Readonly<C & {
        itemName: string;
    }>

  • Replace an item and/or priority in the list, only if it is already present.

    If content or priority are null, these values will not be replaced.

    If the provided key is not present, nothing will happen.

    Deprecated

    Please use the setContent and setPriority methods to replace items and their priorities. This method will be removed in Flarum 2.0.

    Example

    Replace priority and not content.

    items.replace('myItem', null, 10);
    

    Example

    Replace content and not priority.

    items.replace('myItem', <p>My new value.</p>);
    

    Example

    Replace content and priority.

    items.replace('myItem', <p>My new value.</p>, 10);
    

    Parameters

    • key: string

      The key of the item in the list

    • content: null | T = null

      The item's new content

    • priority: null | number = null

      The item's new priority

    Returns ItemList<T>

  • Replaces an item's content, if the provided item key exists.

    If the provided key is not present, an error will be thrown.

    Example

    Replace item content.

    items.setContent('myItem', <p>My new value.</p>);
    

    Example

    Replace item content and priority.

             items
    .setContent('myItem', <p>My new value.</p>)
    .setPriority('myItem', 10);

    Throws

    If the provided key is not present in the ItemList.

    Parameters

    • key: string

      The key of the item in the list

    • content: T

      The item's new content

    Returns ItemList<T>

  • Replaces an item's priority, if the provided item key exists.

    If the provided key is not present, an error will be thrown.

    Example

    Replace item priority.

    items.setPriority('myItem', 10);
    

    Example

    Replace item priority and content.

             items
    .setPriority('myItem', 10)
    .setContent('myItem', <p>My new value.</p>);

    Throws

    If the provided key is not present in the ItemList.

    Parameters

    • key: string

      The key of the item in the list

    • priority: number

      The item's new priority

    Returns ItemList<T>

  • Convert the list into an array of item content arranged by priority.

    This does not preserve the original types of primitives and proxies all content values to make itemName accessible on them.

    NOTE: If your ItemList holds primitive types (such as numbers, booleans or strings), these will be converted to their object counterparts if you do not provide true to this function.

    NOTE: Modifying any objects in the final array may also update the content of the original ItemList.

    See

    https://github.com/flarum/core/issues/3030

    Parameters

    • Optional keepPrimitives: false

      Converts item content to objects and sets the itemName property on them.

    Returns (T & {
        itemName: string;
    })[]

  • Convert the list into an array of item content arranged by priority.

    Content values that are already objects will be proxied and have itemName accessible on them. Primitive values will not have the itemName property accessible.

    NOTE: Modifying any objects in the final array may also update the content of the original ItemList.

    Parameters

    • keepPrimitives: true

      Converts item content to objects and sets the itemName property on them.

    Returns (T extends object ? T & Readonly<{
        itemName: string;
    }> : T)[]

  • A read-only map of all keys to their respective items in no particular order.

    We don't allow adding new items to the ItemList via setting new properties, nor do we allow modifying existing items directly. You should use the add, setContent and setPriority methods instead.

    To match the old behaviour of the ItemList.items property, call Object.values(ItemList.toObject()).

    Example

    const items = new ItemList();
    items.add('b', 'My cool value', 20);
    items.add('a', 'My value', 10);
    items.toObject();
    // {
    // a: { content: 'My value', priority: 10, itemName: 'a' },
    // b: { content: 'My cool value', priority: 20, itemName: 'b' },
    // }

    Returns DeepReadonly<Record<string, IItemObject<T>>>

Generated using TypeDoc v0.23.24