Source

Paginaasje

Dokumintaasje en foarbylden foar it werjaan fan paginaasje om oan te jaan dat in searje relatearre ynhâld bestiet oer meardere siden.

Oersicht

Wy brûke in grut blok ferbûne keppelings foar ús paginaasje, wêrtroch keppelings dreech te missen en maklik skaalber binne - alles wylst wy grutte hitgebieten leverje. Paginaasje is boud mei list HTML-eleminten sadat skermlêzers it oantal beskikbere keppelings kinne oankundigje. Brûk in wikkelelemint <nav>om it te identifisearjen as in navigaasjediel foar skermlêzers en oare assistinte technologyen.

Derneist, om't siden wierskynlik mear as ien sa'n navigaasje-seksje hawwe, is it oan te rieden om in beskriuwing te jaan aria-labelfoar it <nav>om it doel te reflektearjen. Bygelyks, as de pagineringskomponint wurdt brûkt om te navigearjen tusken in set sykresultaten, kin in passend label wêze 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>

Wurkje mei ikoanen

Op syk nei in ikoan of symboal te brûken yn plak fan tekst foar guon pagineringskeppelings? Soargje derfoar dat jo juste skermlêzerstipe leverje mei ariaattributen en it .sr-onlynut.

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

Utskeakele en aktive steaten

Paginaasjekeppelings binne oanpasber foar ferskate omstannichheden. Brûk .disabledfoar keppelings dy't net te klikken lykje en .activeom de aktuele side oan te jaan.

Wylst de .disabledklasse brûkt pointer-events: noneom te besykjen te skeakeljen de keppeling funksjonaliteit fan <a>s, dat CSS eigendom is noch net standerdisearre en net rekken mei toetseboerd navigaasje. As sadanich moatte jo altyd tabindex="-1"útskeakele keppelings tafoegje en oanpast JavaScript brûke om har funksjonaliteit folslein út te skeakeljen.

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

Jo kinne opsjoneel aktive of útskeakele ankers ruilje foar <span>, of it anker weilitte yn it gefal fan 'e foarige / folgjende pylken, om klikfunksjonaliteit te ferwiderjen en toetseboerdfokus te foarkommen, wylst jo bedoelde stilen behâlde.

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

Sizing

Wolle jo in gruttere of lytsere paginaasje? Add .pagination-lgof .pagination-smfoar ekstra maten.

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

Alignment

Feroarje de ôfstimming fan pagineringskomponinten mei flexbox-hulpprogramma's .

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