item-list.html.twig

Same filename in this branch
  1. 8.9.x core/profiles/demo_umami/themes/umami/templates/classy/dataset/item-list.html.twig
  2. 8.9.x core/themes/seven/templates/classy/dataset/item-list.html.twig
  3. 8.9.x core/themes/claro/templates/classy/dataset/item-list.html.twig
  4. 8.9.x core/themes/bartik/templates/classy/dataset/item-list.html.twig
  5. 8.9.x core/themes/stable/templates/dataset/item-list.html.twig
  6. 8.9.x core/themes/classy/templates/dataset/item-list.html.twig
Same filename in other branches
  1. 9 core/profiles/demo_umami/themes/umami/templates/classy/dataset/item-list.html.twig
  2. 9 core/themes/olivero/templates/dataset/item-list.html.twig
  3. 9 core/themes/stable9/templates/dataset/item-list.html.twig
  4. 9 core/themes/seven/templates/classy/dataset/item-list.html.twig
  5. 9 core/themes/claro/templates/classy/dataset/item-list.html.twig
  6. 9 core/themes/bartik/templates/classy/dataset/item-list.html.twig
  7. 9 core/themes/stable/templates/dataset/item-list.html.twig
  8. 9 core/themes/starterkit_theme/templates/dataset/item-list.html.twig
  9. 9 core/themes/classy/templates/dataset/item-list.html.twig
  10. 9 core/modules/system/templates/item-list.html.twig
  11. 10 core/profiles/demo_umami/themes/umami/templates/classy/dataset/item-list.html.twig
  12. 10 core/themes/olivero/templates/dataset/item-list.html.twig
  13. 10 core/themes/stable9/templates/dataset/item-list.html.twig
  14. 10 core/themes/claro/templates/classy/dataset/item-list.html.twig
  15. 10 core/themes/starterkit_theme/templates/dataset/item-list.html.twig
  16. 10 core/modules/system/templates/item-list.html.twig
  17. 11.x core/profiles/demo_umami/themes/umami/templates/classy/dataset/item-list.html.twig
  18. 11.x core/themes/olivero/templates/dataset/item-list.html.twig
  19. 11.x core/themes/stable9/templates/dataset/item-list.html.twig
  20. 11.x core/themes/claro/templates/classy/dataset/item-list.html.twig
  21. 11.x core/themes/starterkit_theme/templates/dataset/item-list.html.twig
  22. 11.x 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()

77 theme calls to item-list.html.twig
AggregatorFeedBlock::build in core/modules/aggregator/src/Plugin/Block/AggregatorFeedBlock.php
Analyzer::formatMessages in core/modules/views/src/Analyzer.php
Formats the analyze result into a message string.
ArgumentPluginBase::getTokenHelp in core/modules/views/src/Plugin/views/argument/ArgumentPluginBase.php
Provide token help information for the argument.
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.

... 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


Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.