
####
List
####

.. js:class:: ui.list.List

   Provides a list view component for displaying sortable elements.
   
   .. rubric:: Examples
   
   
   .. code-block:: html
   
      <hoops-list></hoops-list>
      
      <script>
        const list = document.getElementsByTagName("hoops-list")[0];
        list.list = {
          context: {
            elementsData: new Map([[1, 'Item A'], [2, 'Item B']]),
            sortedByValue: true,
            getContent: (context, key, selected) => `${key}: ${context.elementsData.get(key)}`
          }
        };
        list.selected = [1];
      </script>
   
   .. rubric:: Custom Element
   
   
   ``hoops-list``
   
   .. rubric:: Since
   
   
   ``2025.8.0``
   
   
   Index
   =====
   
   .. rubric:: Constructors
   
   
   .. rst-class:: api-xref-list
   
   
   * :js:func:`~ui.list.List.constructor`
   
   .. rubric:: Properties
   
   
   .. rst-class:: api-xref-list
   
   
   * :js:data:`~ui.list.List.list`
   * :js:data:`~ui.list.List.selected`
   
   .. rubric:: Methods
   
   
   .. rst-class:: api-xref-list
   
   
   * :js:meth:`~ui.list.List.updateContext`
   * :js:meth:`~ui.list.List.updateSelected`
   
   



.. rst-class:: kind-group kind-constructors

.. rubric:: Constructors
   :class: kind-group-title


.. js:method:: ui.list.List.constructor

      .. rst-class:: sig-pretty-signature
      
         | List(): :js:class:`List <ui.list.List>`
      
      **Returns**\ : :js:class:`List <ui.list.List>`
      



.. rst-class:: kind-group kind-properties

.. rubric:: Properties
   :class: kind-group-title


.. js:data:: ui.list.List.list

      .. rst-class:: sig-pretty-signature
      
         | list: :js:data:`ContextWrapper <ui.list.ContextWrapper>`
      
      Context wrapper providing list data access methods. Reassign to trigger updates.
      



.. js:data:: ui.list.List.selected

      .. rst-class:: sig-pretty-signature
      
         | selected: *number*\ []
      
      Array of selected element keys. Reassign to trigger updates.
      
      .. rubric:: Default
      
      
      `````ts
      []
      `````
      



.. rst-class:: kind-group kind-methods

.. rubric:: Methods
   :class: kind-group-title


.. js:method:: ui.list.List.updateContext

      .. rst-class:: sig-pretty-signature
      
         | updateContext(): *void*
      
      Triggers a re-render by reassigning list context.
      
      **Returns**\ : *void*
      
      
         void
      
      



.. js:method:: ui.list.List.updateSelected

      .. rst-class:: sig-pretty-signature
      
         | updateSelected(): *void*
      
      Triggers a re-render by reassigning selected elements.
      
      **Returns**\ : *void*
      
      
         void
      
      




