in English

Пагінацыя

Дакументацыя і прыклады для паказу пагінацыі для пазначэння серыі звязанага кантэнту існуюць на некалькіх старонках.

Агляд

Мы выкарыстоўваем вялікі блок звязаных спасылак для нашай пагінацыі, што робіць спасылкі цяжка прапусціць і лёгка маштабуюцца - і ўсё гэта забяспечваючы вялікія вобласці траплення. Размяшчэнне старонак пабудавана з элементамі спісу HTML, каб праграмы чытання з экрана маглі паведамляць пра колькасць даступных спасылак. Выкарыстоўвайце <nav>элемент абгорткі, каб вызначыць яго як раздзел навігацыі для праграм чытання з экрана і іншых дапаможных тэхналогій.

Акрамя таго, паколькі старонкі, верагодна, маюць больш чым адзін такі раздзел навігацыі, пажадана даць апісанне aria-labelдля <nav>адлюстравання яго мэты. Напрыклад, калі кампанент пагінацыі выкарыстоўваецца для навігацыі паміж наборам вынікаў пошуку, адпаведнай пазнакай можа быць 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>

Праца са значкамі

Жадаеце выкарыстоўваць значок або сімвал замест тэксту для некаторых спасылак на пагінацыю? Не забудзьцеся забяспечыць належную падтрымку праграмы чытання з экрана з ariaатрыбутамі.

<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>
      </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>
      </a>
    </li>
  </ul>
</nav>

Адключаны і актыўны стану

Спасылкі на пагінацыю можна наладзіць для розных абставінаў. Выкарыстоўваецца .disabledдля спасылак, па якіх немагчыма націснуць, і .activeдля ўказання бягучай старонкі.

У той час як .disabledклас pointer-events: noneспрабуе адключыць функцыянальнасць спасылак s, гэта ўласцівасць CSS яшчэ<a> не стандартызавана і не ўлічвае навігацыю з клавіятуры. Такім чынам, вы заўсёды павінны дадаваць tabindex="-1"адключаныя спасылкі і выкарыстоўваць уласны JavaScript, каб цалкам адключыць іх функцыянальнасць.

<nav aria-label="...">
  <ul class="pagination">
    <li class="page-item disabled">
      <a class="page-link">Previous</a>
    </li>
    <li class="page-item"><a class="page-link" href="#">1</a></li>
    <li class="page-item active" aria-current="page">
      <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>

Пры жаданні вы можаце замяніць актыўныя або адключаныя прывязкі на <span>, або апусціць прывязку ў выпадку стрэлак папярэдняга/наступнага, каб выдаліць функцыянальнасць націску і прадухіліць фокус клавіятуры, захаваўшы прызначаныя стылі.

<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" aria-current="page">
      <span class="page-link">2</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>

Праклейванне

Хочаце пагінацыю большага ці меншага памеру? Дадайце .pagination-lgабо .pagination-smдля дадатковых памераў.

<nav aria-label="...">
  <ul class="pagination pagination-lg">
    <li class="page-item active" aria-current="page">
      <span class="page-link">1</span>
    </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 active" aria-current="page">
      <span class="page-link">1</span>
    </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>

Выраўноўванне

Змяніце выраўноўванне кампанентаў пагінацыі з дапамогай утыліт flexbox .

<nav aria-label="Page navigation example">
  <ul class="pagination justify-content-center">
    <li class="page-item disabled">
      <a class="page-link">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">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>