Pagbilang ng pahina
Dokumentasyon at mga halimbawa para sa pagpapakita ng pagination upang ipahiwatig ang isang serye ng mga nauugnay na nilalaman na umiiral sa maraming mga pahina.
Gumagamit kami ng malaking bloke ng mga konektadong link para sa aming pagination, na ginagawang mahirap makaligtaan ang mga link at madaling masusukat—lahat habang nagbibigay ng malalaking lugar ng hit. Binuo ang pagbilang ng pahina gamit ang mga elemento ng HTML ng listahan upang maipahayag ng mga screen reader ang bilang ng mga available na link. Gumamit ng elemento ng pambalot <nav>
upang tukuyin ito bilang seksyon ng nabigasyon para sa mga screen reader at iba pang mga pantulong na teknolohiya.
Bilang karagdagan, dahil ang mga pahina ay malamang na may higit sa isang tulad na seksyon ng nabigasyon, ipinapayong magbigay ng isang mapaglarawang aria-label
para <nav>
maipakita ang layunin nito. Halimbawa, kung ang bahagi ng pagination ay ginagamit upang mag-navigate sa pagitan ng isang hanay ng mga resulta ng paghahanap, ang isang naaangkop na label ay maaaring 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>
Naghahanap na gumamit ng isang icon o simbolo bilang kapalit ng teksto para sa ilang mga link ng pagination? Tiyaking magbigay ng wastong suporta sa screen reader na may aria
mga katangian at .sr-only
utility.
<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">«</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">»</span>
<span class="sr-only">Next</span>
</a>
</li>
</ul>
</nav>
Ang mga link sa pagbilang ng pahina ay nako-customize para sa iba't ibang mga pangyayari. Gamitin .disabled
para sa mga link na lumilitaw na hindi na-click at .active
upang ipahiwatig ang kasalukuyang pahina.
Habang .disabled
ginagamit ng klase pointer-events: none
upang subukang huwag paganahin ang paggana ng link ng <a>
s, ang pag-aari ng CSS ay hindi pa na-standardize at hindi isinasaalang-alang ang pag-navigate sa keyboard. Dahil dito, dapat kang palaging magdagdag tabindex="-1"
sa mga naka-disable na link at gumamit ng custom na JavaScript upang ganap na huwag paganahin ang kanilang functionality.
<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>
Maaari mong opsyonal na palitan ang aktibo o hindi pinaganang mga anchor para sa <span>
, o alisin ang anchor sa kaso ng mga nauna/susunod na arrow, upang alisin ang pag-andar ng pag-click at maiwasan ang pagtutok sa keyboard habang pinapanatili ang mga nilalayong istilo.
<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>
Gusto mo ba ng mas malaki o mas maliit na pagination? Magdagdag .pagination-lg
o .pagination-sm
para sa mga karagdagang laki.
<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>
Baguhin ang pagkakahanay ng mga bahagi ng pagination gamit ang 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>