aleph1.co.uk Git - yaffs-website/blob - web/core/themes/classy/templates/navigation/pager.html.twig

   1 {#
   2 /**
   3  * @file
   4  * Theme override to display a pager.
   5  *
   6  * Available variables:
   7  * - items: List of pager items.
   8  *   The list is keyed by the following elements:
   9  *   - first: Item for the first page; not present on the first page of results.
  10  *   - previous: Item for the previous page; not present on the first page
  11  *     of results.
  12  *   - next: Item for the next page; not present on the last page of results.
  13  *   - last: Item for the last page; not present on the last page of results.
  14  *   - pages: List of pages, keyed by page number.
  15  *   Sub-sub elements:
  16  *   items.first, items.previous, items.next, items.last, and each item inside
  17  *   items.pages contain the following elements:
  18  *   - href: URL with appropriate query parameters for the item.
  19  *   - attributes: A keyed list of HTML attributes for the item.
  20  *   - text: The visible text used for the item link, such as "‹ Previous"
  21  *     or "Next ›".
  22  * - current: The page number of the current page.
  23  * - ellipses: If there are more pages than the quantity allows, then an
  24  *   ellipsis before or after the listed pages may be present.
  25  *   - previous: Present if the currently visible list of pages does not start
  26  *     at the first page.
  27  *   - next: Present if the visible list of pages ends before the last page.
  28  *
  29  * @see template_preprocess_pager()
  30  */
  31 #}
  32 {% if items %}
  33   <nav class="pager" role="navigation" aria-labelledby="pagination-heading">
  34     <h4 id="pagination-heading" class="visually-hidden">{{ 'Pagination'|t }}</h4>
  35     <ul class="pager__items js-pager__items">
  36       {# Print first item if we are not on the first page. #}
  37       {% if items.first %}
  38         <li class="pager__item pager__item--first">
  39           <a href="{{ items.first.href }}" title="{{ 'Go to first page'|t }}"{{ items.first.attributes|without('href', 'title') }}>
  40             <span class="visually-hidden">{{ 'First page'|t }}</span>
  41             <span aria-hidden="true">{{ items.first.text|default('« First'|t) }}</span>
  42           </a>
  43         </li>
  44       {% endif %}
  45       {# Print previous item if we are not on the first page. #}
  46       {% if items.previous %}
  47         <li class="pager__item pager__item--previous">
  48           <a href="{{ items.previous.href }}" title="{{ 'Go to previous page'|t }}" rel="prev"{{ items.previous.attributes|without('href', 'title', 'rel') }}>
  49             <span class="visually-hidden">{{ 'Previous page'|t }}</span>
  50             <span aria-hidden="true">{{ items.previous.text|default('‹ Previous'|t) }}</span>
  51           </a>
  52         </li>
  53       {% endif %}
  54       {# Add an ellipsis if there are further previous pages. #}
  55       {% if ellipses.previous %}
  56         <li class="pager__item pager__item--ellipsis" role="presentation">&hellip;</li>
  57       {% endif %}
  58       {# Now generate the actual pager piece. #}
  59       {% for key, item in items.pages %}
  60         <li class="pager__item{{ current == key ? ' is-active' : '' }}">
  61           {% if current == key %}
  62             {% set title = 'Current page'|t %}
  63           {% else %}
  64             {% set title = 'Go to page @key'|t({'@key': key}) %}
  65           {% endif %}
  66           <a href="{{ item.href }}" title="{{ title }}"{{ item.attributes|without('href', 'title') }}>
  67             <span class="visually-hidden">
  68               {{ current == key ? 'Current page'|t : 'Page'|t }}
  69             </span>
  70             {{- key -}}
  71           </a>
  72         </li>
  73       {% endfor %}
  74       {# Add an ellipsis if there are further next pages. #}
  75       {% if ellipses.next %}
  76         <li class="pager__item pager__item--ellipsis" role="presentation">&hellip;</li>
  77       {% endif %}
  78       {# Print next item if we are not on the last page. #}
  79       {% if items.next %}
  80         <li class="pager__item pager__item--next">
  81           <a href="{{ items.next.href }}" title="{{ 'Go to next page'|t }}" rel="next"{{ items.next.attributes|without('href', 'title', 'rel') }}>
  82             <span class="visually-hidden">{{ 'Next page'|t }}</span>
  83             <span aria-hidden="true">{{ items.next.text|default('Next ›'|t) }}</span>
  84           </a>
  85         </li>
  86       {% endif %}
  87       {# Print last item if we are not on the last page. #}
  88       {% if items.last %}
  89         <li class="pager__item pager__item--last">
  90           <a href="{{ items.last.href }}" title="{{ 'Go to last page'|t }}"{{ items.last.attributes|without('href', 'title') }}>
  91             <span class="visually-hidden">{{ 'Last page'|t }}</span>
  92             <span aria-hidden="true">{{ items.last.text|default('Last »'|t) }}</span>
  93           </a>
  94         </li>
  95       {% endif %}
  96     </ul>
  97   </nav>
  98 {% endif %}