Same filename in this branch
  1. 10 core/modules/system/templates/item-list.html.twig
  2. 10 core/themes/olivero/templates/dataset/item-list.html.twig
  3. 10 core/themes/stable9/templates/dataset/item-list.html.twig
  4. 10 core/themes/starterkit_theme/templates/dataset/item-list.html.twig
  5. 10 core/themes/claro/templates/classy/dataset/item-list.html.twig
  6. 10 core/profiles/demo_umami/themes/umami/templates/classy/dataset/item-list.html.twig
Same filename and directory in other branches
  1. 8.9.x core/modules/system/templates/item-list.html.twig
  2. 9 core/modules/system/templates/item-list.html.twig

Default theme implementation for an item list.

Available variables:

  • items: A list of items. Each item contains:

    • attributes: HTML attributes to be applied to each list item.
    • value: The content of the list element.
  • title: The title of the list.
  • list_type: The tag for list element ("ul" or "ol").
  • wrapper_attributes: HTML attributes to be applied to the list wrapper.
  • attributes: HTML attributes to be applied to the list.
  • empty: A message to display when there are no items. Allowed value is a string or render array.
  • context: A list of contextual data associated with the list. May contain:
    • list_style: The custom list style.

See also

template_preprocess_item_list()

56 theme calls to item-list.html.twig
Analyzer::formatMessages in core/modules/views/src/Analyzer.php
Formats the analyze result into a message string.
authorize.php in core/authorize.php
Administrative script for running authorized file operations.
BookController::bookRender in core/modules/book/src/Controller/BookController.php
Prints a listing of all books.
BrokenHandlerTrait::buildOptionsForm in core/modules/views/src/Plugin/views/BrokenHandlerTrait.php
Provides a form to edit options for this plugin.
callback_batch_finished in core/lib/Drupal/Core/Form/form.api.php
Complete a batch process.

... See full list

File

core/modules/system/templates/item-list.html.twig
View source
  1. {#
  2. /**
  3. * @file
  4. * Default theme implementation for an item list.
  5. *
  6. * Available variables:
  7. * - items: A list of items. Each item contains:
  8. * - attributes: HTML attributes to be applied to each list item.
  9. * - value: The content of the list element.
  10. * - title: The title of the list.
  11. * - list_type: The tag for list element ("ul" or "ol").
  12. * - wrapper_attributes: HTML attributes to be applied to the list wrapper.
  13. * - attributes: HTML attributes to be applied to the list.
  14. * - empty: A message to display when there are no items. Allowed value is a
  15. * string or render array.
  16. * - context: A list of contextual data associated with the list. May contain:
  17. * - list_style: The custom list style.
  18. *
  19. * @see template_preprocess_item_list()
  20. *
  21. * @ingroup themeable
  22. */
  23. #}
  24. {% if context.list_style %}
  25. {%- set attributes = attributes.addClass('item-list__' ~ context.list_style) %}
  26. {% endif %}
  27. {% if items or empty %}
  28. {%- if title is not empty -%}
  29. <h3>{{ title }}</h3>
  30. {%- endif -%}
  31. {%- if items -%}
  32. <{{ list_type }}{{ attributes }}>
  33. {%- for item in items -%}
  34. <li{{ item.attributes }}>{{ item.value }}</li>
  35. {%- endfor -%}
  36. </{{ list_type }}>
  37. {%- else -%}
  38. {{- empty -}}
  39. {%- endif -%}
  40. {%- endif %}

Related topics