You are here

item-list.html.twig in Drupal 8

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

File

core/themes/stable/templates/dataset/item-list.html.twig
View source
  1. {#
  2. /**
  3. * @file
  4. * Theme override 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. #}
  22. {% if context.list_style %}
  23. {%- set attributes = attributes.addClass('item-list__' ~ context.list_style) %}
  24. {% endif %}
  25. {% if items or empty %}
  26. {%- if title is not empty -%}
  27. <h3>{{ title }}</h3>
  28. {%- endif -%}
  29. {%- if items -%}
  30. <{{ list_type }}{{ attributes }}>
  31. {%- for item in items -%}
  32. <li{{ item.attributes }}>{{ item.value }}</li>
  33. {%- endfor -%}
  34. </{{ list_type }}>
  35. {%- else -%}
  36. {{- empty -}}
  37. {%- endif -%}
  38. {%- endif %}