Pagination

ເອກະສານແລະຕົວຢ່າງສໍາລັບການສະແດງ pagination ເພື່ອຊີ້ບອກຊຸດຂອງເນື້ອຫາທີ່ກ່ຽວຂ້ອງມີຢູ່ໃນຫຼາຍຫນ້າ.

ໃນໜ້ານີ້

ພາບລວມ

ພວກເຮົາໃຊ້ຕົວເຊື່ອມຕໍ່ອັນໃຫຍ່ຫຼວງສໍາລັບການສ້າງຫນ້າຂອງພວກເຮົາ, ເຮັດໃຫ້ການເຊື່ອມຕໍ່ທີ່ຍາກທີ່ຈະພາດແລະຂະຫຍາຍໄດ້ງ່າຍ - ທັງຫມົດໃນຂະນະທີ່ສະຫນອງພື້ນທີ່ຂະຫນາດໃຫຍ່. Pagination ຖືກສ້າງຂຶ້ນດ້ວຍອົງປະກອບ HTML ເພື່ອໃຫ້ຜູ້ອ່ານຫນ້າຈໍສາມາດປະກາດຈໍານວນການເຊື່ອມຕໍ່ທີ່ມີຢູ່. ໃຊ້ອົງປະກອບການຫໍ່ <nav>ເພື່ອກໍານົດມັນເປັນສ່ວນນໍາທາງເພື່ອກວດສອບຜູ້ອ່ານແລະເຕັກໂນໂລຢີການຊ່ວຍເຫຼືອອື່ນໆ.

ນອກຈາກນັ້ນ, ຍ້ອນວ່າຫນ້າເວັບມີຫຼາຍກວ່າຫນຶ່ງສ່ວນການນໍາທາງດັ່ງກ່າວ, ມັນສົມຄວນທີ່ຈະໃຫ້ຄໍາບັນຍາຍ aria-labelເພື່ອ <nav>ສະທ້ອນເຖິງຈຸດປະສົງຂອງມັນ. ຕົວຢ່າງ, ຖ້າອົງປະກອບ pagination ຖືກນໍາໃຊ້ເພື່ອນໍາທາງລະຫວ່າງຊຸດຜົນການຄົ້ນຫາ, ປ້າຍຊື່ທີ່ເຫມາະສົມອາດຈະເປັນ aria-label="Search results pages".

html

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

ເຮັດວຽກກັບໄອຄອນ

ຊອກຫາການນໍາໃຊ້ໄອຄອນຫຼືສັນຍາລັກແທນຂໍ້ຄວາມສໍາລັບບາງການເຊື່ອມຕໍ່ pagination? ໃຫ້ແນ່ໃຈວ່າໃຫ້ການສະຫນັບສະຫນູນເຄື່ອງອ່ານຫນ້າຈໍທີ່ເຫມາະສົມກັບ ariaຄຸນລັກສະນະຕ່າງໆ.

html

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

ສະຖານະທີ່ພິການ ແລະເຄື່ອນໄຫວ

ການເຊື່ອມຕໍ່ Pagination ແມ່ນສາມາດປັບແຕ່ງໄດ້ສໍາລັບສະຖານະການທີ່ແຕກຕ່າງກັນ. ໃຊ້ .disabledສໍາລັບການເຊື່ອມຕໍ່ທີ່ປາກົດວ່າບໍ່ສາມາດຄລິກໄດ້ແລະ .activeຊີ້ບອກຫນ້າປະຈຸບັນ.

ໃນຂະນະທີ່ .disabledຫ້ອງຮຽນໃຊ້ pointer-events: noneເພື່ອ ພະຍາຍາມ ປິດການທໍາງານຂອງການເຊື່ອມຕໍ່ຂອງ <a>s, ຄຸນສົມບັດ CSS ຍັງບໍ່ທັນໄດ້ມາດຕະຖານແລະບໍ່ໄດ້ກວມເອົາການນໍາທາງແປ້ນພິມ. ດັ່ງນັ້ນ, ທ່ານຄວນເພີ່ມ ການເຊື່ອມຕໍ່ທີ່ຖືກປິດໃຊ້ງານຢູ່ສະເຫມີ tabindex="-1"ແລະໃຊ້ JavaScript ແບບກໍານົດເອງເພື່ອປິດການທໍາງານຂອງພວກເຂົາຢ່າງສົມບູນ.

html

<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>ຫຼືຍົກເລີກສະມໍໃນກໍລະນີຂອງລູກສອນກ່ອນ/ຖັດໄປ, ເພື່ອລຶບການທໍາງານຂອງຄລິກ ແລະປ້ອງກັນການໂຟກັສແປ້ນພິມໃນຂະນະທີ່ຮັກສາຮູບແບບທີ່ຕັ້ງໄວ້.

html

<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 ໃຫຍ່ຫຼືນ້ອຍກວ່າ? ເພີ່ມ .pagination-lgຫຼື .pagination-smສໍາລັບຂະຫນາດເພີ່ມເຕີມ.

html

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

html

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

ຈັດຮຽງ

ປ່ຽນການຈັດຮຽງຂອງອົງປະກອບ pagination ດ້ວຍ flexbox utilities . ສໍາລັບຕົວຢ່າງ, ກັບ .justify-content-center:

html

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

ຫຼືກັບ .justify-content-end:

html

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

CSS

ຕົວແປ

ເພີ່ມໃນ v5.2.0

ເປັນສ່ວນຫນຶ່ງຂອງວິທີການຕົວແປ CSS ທີ່ພັດທະນາຂອງ Bootstrap, pagination ໃນປັດຈຸບັນໃຊ້ຕົວແປ CSS ທ້ອງຖິ່ນ .paginationສໍາລັບການປັບແຕ່ງເວລາທີ່ແທ້ຈິງ. ຄ່າສໍາລັບຕົວແປ CSS ແມ່ນຖືກກໍານົດຜ່ານ Sass, ດັ່ງນັ້ນການປັບແຕ່ງ Sass ຍັງຖືກສະຫນັບສະຫນູນ, ເຊັ່ນກັນ.

  --#{$prefix}pagination-padding-x: #{$pagination-padding-x};
  --#{$prefix}pagination-padding-y: #{$pagination-padding-y};
  @include rfs($pagination-font-size, --#{$prefix}pagination-font-size);
  --#{$prefix}pagination-color: #{$pagination-color};
  --#{$prefix}pagination-bg: #{$pagination-bg};
  --#{$prefix}pagination-border-width: #{$pagination-border-width};
  --#{$prefix}pagination-border-color: #{$pagination-border-color};
  --#{$prefix}pagination-border-radius: #{$pagination-border-radius};
  --#{$prefix}pagination-hover-color: #{$pagination-hover-color};
  --#{$prefix}pagination-hover-bg: #{$pagination-hover-bg};
  --#{$prefix}pagination-hover-border-color: #{$pagination-hover-border-color};
  --#{$prefix}pagination-focus-color: #{$pagination-focus-color};
  --#{$prefix}pagination-focus-bg: #{$pagination-focus-bg};
  --#{$prefix}pagination-focus-box-shadow: #{$pagination-focus-box-shadow};
  --#{$prefix}pagination-active-color: #{$pagination-active-color};
  --#{$prefix}pagination-active-bg: #{$pagination-active-bg};
  --#{$prefix}pagination-active-border-color: #{$pagination-active-border-color};
  --#{$prefix}pagination-disabled-color: #{$pagination-disabled-color};
  --#{$prefix}pagination-disabled-bg: #{$pagination-disabled-bg};
  --#{$prefix}pagination-disabled-border-color: #{$pagination-disabled-border-color};

ຕົວແປ Sass

$pagination-padding-y:              .375rem;
$pagination-padding-x:              .75rem;
$pagination-padding-y-sm:           .25rem;
$pagination-padding-x-sm:           .5rem;
$pagination-padding-y-lg:           .75rem;
$pagination-padding-x-lg:           1.5rem;

$pagination-font-size:              $font-size-base;

$pagination-color:                  var(--#{$prefix}link-color);
$pagination-bg:                     $white;
$pagination-border-radius:          $border-radius;
$pagination-border-width:           $border-width;
$pagination-margin-start:           ($pagination-border-width * -1);
$pagination-border-color:           $gray-300;

$pagination-focus-color:            var(--#{$prefix}link-hover-color);
$pagination-focus-bg:               $gray-200;
$pagination-focus-box-shadow:       $input-btn-focus-box-shadow;
$pagination-focus-outline:          0;

$pagination-hover-color:            var(--#{$prefix}link-hover-color);
$pagination-hover-bg:               $gray-200;
$pagination-hover-border-color:     $gray-300;

$pagination-active-color:           $component-active-color;
$pagination-active-bg:              $component-active-bg;
$pagination-active-border-color:    $pagination-active-bg;

$pagination-disabled-color:         $gray-600;
$pagination-disabled-bg:            $white;
$pagination-disabled-border-color:  $gray-300;

$pagination-transition:              color .15s ease-in-out, background-color .15s ease-in-out, border-color .15s ease-in-out, box-shadow .15s ease-in-out;

$pagination-border-radius-sm:       $border-radius-sm;
$pagination-border-radius-lg:       $border-radius-lg;

Sass mixins

@mixin pagination-size($padding-y, $padding-x, $font-size, $border-radius) {
  --#{$prefix}pagination-padding-x: #{$padding-x};
  --#{$prefix}pagination-padding-y: #{$padding-y};
  @include rfs($font-size, --#{$prefix}pagination-font-size);
  --#{$prefix}pagination-border-radius: #{$border-radius};
}