Source

Paginatioun

Dokumentatioun an Beispiller fir d'Paginatioun ze weisen fir unzeginn datt eng Serie vu verwandten Inhalter op verschidde Säiten existéiert.

Iwwersiicht

Mir benotzen e grousse Block vu verbonne Linken fir eis Paginatioun, sou datt Linken schwéier ze verpassen an einfach skalierbar maachen - alles wärend grouss Hitberäicher ubidden. Paginatioun ass mat Lëscht HTML Elementer gebaut sou datt Écran Lieser d'Zuel vun de verfügbare Linken kënne matdeelen. Benotzt e Wrapelement <nav>fir et als Navigatiounssektioun fir Écran Lieser an aner Hëllefstechnologien ze identifizéieren.

Zousätzlech, well Säiten wahrscheinlech méi wéi eng Navigatiounssektioun hunn, ass et unzeroden eng deskriptiv aria-labelfir den <nav>Zweck ze reflektéieren. Zum Beispill, wann d'Paginéierungskomponent benotzt gëtt fir tëscht enger Rei vu Sichresultater ze navigéieren, kann e passende Label aria-label="Search results pages".

<nav aria-label="Page navigation example">
  <ul class="pagination">
    <li class="page-item"><a class="page-link" href="#">Previous</a></li>
    <li class="page-item"><a class="page-link" href="#">1</a></li>
    <li class="page-item"><a class="page-link" href="#">2</a></li>
    <li class="page-item"><a class="page-link" href="#">3</a></li>
    <li class="page-item"><a class="page-link" href="#">Next</a></li>
  </ul>
</nav>

Schafft mat Ikonen

Sicht Dir eng Ikon oder Symbol an der Plaz vum Text fir e puer Paginatiounslinks ze benotzen? Gitt sécher datt Dir e passende Bildschirm Lieser Ënnerstëtzung mat ariaAttributer an .sr-onlyUtility ubitt.

<nav aria-label="Page navigation example">
  <ul class="pagination">
    <li class="page-item">
      <a class="page-link" href="#" aria-label="Previous">
        <span aria-hidden="true">&laquo;</span>
        <span class="sr-only">Previous</span>
      </a>
    </li>
    <li class="page-item"><a class="page-link" href="#">1</a></li>
    <li class="page-item"><a class="page-link" href="#">2</a></li>
    <li class="page-item"><a class="page-link" href="#">3</a></li>
    <li class="page-item">
      <a class="page-link" href="#" aria-label="Next">
        <span aria-hidden="true">&raquo;</span>
        <span class="sr-only">Next</span>
      </a>
    </li>
  </ul>
</nav>

Behënnert an aktiv Staaten

Paginéierungslinks si personaliséierbar fir verschidden Ëmstänn. Benotzt .disabledfir Linken déi onklickbar erschéngen a .activefir déi aktuell Säit unzeginn.

Wärend d' .disabledKlass benotzt pointer-events: nonefir ze probéieren d'Linkfunktioun vu <a>s auszeschalten, ass dës CSS-Eegeschaft nach net standardiséiert a berücksichtegt keng Tastaturnavigatioun. Als solch sollt Dir ëmmer tabindex="-1"op behënnerte Linken addéieren a personaliséiert JavaScript benotze fir hir Funktionalitéit komplett auszeschalten.

<nav aria-label="...">
  <ul class="pagination">
    <li class="page-item disabled">
      <a class="page-link" href="#" tabindex="-1">Previous</a>
    </li>
    <li class="page-item"><a class="page-link" href="#">1</a></li>
    <li class="page-item active">
      <a class="page-link" href="#">2 <span class="sr-only">(current)</span></a>
    </li>
    <li class="page-item"><a class="page-link" href="#">3</a></li>
    <li class="page-item">
      <a class="page-link" href="#">Next</a>
    </li>
  </ul>
</nav>

Dir kënnt optional aktiv oder behënnert Ankeren austauschen fir <span>, oder den Anker am Fall vun de Prev/Next Pfeile austauschen, fir Klickfunktionalitéit ze läschen an Tastaturfokus ze vermeiden, wärend geplangte Stiler behalen.

<nav aria-label="...">
  <ul class="pagination">
    <li class="page-item disabled">
      <span class="page-link">Previous</span>
    </li>
    <li class="page-item"><a class="page-link" href="#">1</a></li>
    <li class="page-item active">
      <span class="page-link">
        2
        <span class="sr-only">(current)</span>
      </span>
    </li>
    <li class="page-item"><a class="page-link" href="#">3</a></li>
    <li class="page-item">
      <a class="page-link" href="#">Next</a>
    </li>
  </ul>
</nav>

Gréisst

Loscht op méi grouss oder méi kleng Paginatioun? Addéieren .pagination-lgoder .pagination-smfir zousätzlech Gréissten.

<nav aria-label="...">
  <ul class="pagination pagination-lg">
    <li class="page-item disabled">
      <a class="page-link" href="#" tabindex="-1">1</a>
    </li>
    <li class="page-item"><a class="page-link" href="#">2</a></li>
    <li class="page-item"><a class="page-link" href="#">3</a></li>
  </ul>
</nav>
<nav aria-label="...">
  <ul class="pagination pagination-sm">
    <li class="page-item disabled">
      <a class="page-link" href="#" tabindex="-1">1</a>
    </li>
    <li class="page-item"><a class="page-link" href="#">2</a></li>
    <li class="page-item"><a class="page-link" href="#">3</a></li>
  </ul>
</nav>

Ausriichtung

Ännert d'Ausrichtung vun de Paginatiounskomponenten mat Flexbox Utilities .

<nav aria-label="Page navigation example">
  <ul class="pagination justify-content-center">
    <li class="page-item disabled">
      <a class="page-link" href="#" tabindex="-1">Previous</a>
    </li>
    <li class="page-item"><a class="page-link" href="#">1</a></li>
    <li class="page-item"><a class="page-link" href="#">2</a></li>
    <li class="page-item"><a class="page-link" href="#">3</a></li>
    <li class="page-item">
      <a class="page-link" href="#">Next</a>
    </li>
  </ul>
</nav>
<nav aria-label="Page navigation example">
  <ul class="pagination justify-content-end">
    <li class="page-item disabled">
      <a class="page-link" href="#" tabindex="-1">Previous</a>
    </li>
    <li class="page-item"><a class="page-link" href="#">1</a></li>
    <li class="page-item"><a class="page-link" href="#">2</a></li>
    <li class="page-item"><a class="page-link" href="#">3</a></li>
    <li class="page-item">
      <a class="page-link" href="#">Next</a>
    </li>
  </ul>
</nav>