Pagination

Cov ntaub ntawv thiab cov piv txwv rau kev qhia pagination los qhia txog cov ntsiab lus cuam tshuam muaj nyob thoob plaws ntau nplooj ntawv.

Ntawm nplooj ntawv no

Txheej txheem cej luam

Peb siv qhov thaiv loj ntawm kev sib txuas rau peb cov pagination, ua cov kev sib txuas nyuaj kom tsis nco qab thiab yooj yim scalable-tag nrho thaum muab cov cheeb tsam loj. Pagination yog tsim nrog cov npe HTML cov ntsiab lus kom cov neeg nyeem ntawv tuaj yeem tshaj tawm cov xov tooj ntawm cov ntawv txuas. Siv cov txheej txheem qhwv <nav>los txheeb xyuas nws ua ntu kev taw qhia los tshuaj xyuas cov neeg nyeem thiab lwm yam cuab yeej pabcuam.

Tsis tas li ntawd, raws li cov nplooj ntawv yuav muaj ntau tshaj li ib qho kev taw qhia, nws raug nquahu kom muab cov lus piav qhia aria-labelrau qhov <nav>xav txog nws lub hom phiaj. Piv txwv li, yog hais tias cov pagination tivthaiv yog siv los mus rau ntawm ib pawg ntawm kev tshawb nrhiav, ib daim ntawv lo tsim nyog yuav yog 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>

Ua haujlwm nrog cov cim

Nrhiav siv lub cim lossis cim rau hauv qhov chaw ntawm cov ntawv nyeem rau qee qhov kev sib txuas ntawm pagination? Nco ntsoov muab kev txhawb nqa nyeem ntawv zoo nrog cov ariacwj pwm.

<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 thiab active xeev

Pagination txuas yog customizable rau cov xwm txheej sib txawv. Siv .disabledrau cov kev sib txuas uas tshwm sim un-clickable thiab .activeqhia rau nplooj ntawv tam sim no.

Thaum cov .disabledchav kawm siv pointer-events: nonelos sim lov tes taw qhov txuas kev ua haujlwm ntawm <a>s, cov cuab yeej CSS tseem tsis tau ua qauv thiab tsis suav rau cov keyboard navigation. Yog li ntawd, koj yuav tsum ib txwm ntxiv tabindex="-1"rau cov neeg xiam oob khab txuas thiab siv kev cai JavaScript kom ua tiav lawv cov haujlwm.

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

Koj tuaj yeem xaiv hloov pauv cov khoom siv lossis cov neeg xiam oob khab rau <span>, lossis tshem lub thauj tog rau nkoj nyob rau hauv rooj plaub ntawm cov xub ua ntej / tom ntej, kom tshem tawm cov nyem ua haujlwm thiab tiv thaiv cov keyboard tsom thaum khaws cov hom phiaj.

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

Qhov loj me

Xav kom loj dua lossis me dua pagination? Ntxiv .pagination-lglossis .pagination-smrau qhov ntau thiab tsawg.

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

Kev sib tw

Hloov cov kev sib raug zoo ntawm pagination Cheebtsam nrog 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" aria-disabled="true">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" aria-disabled="true">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>

Sass

Hloov pauv

$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-color:                  $link-color;
$pagination-bg:                     $white;
$pagination-border-width:           $border-width;
$pagination-border-radius:          $border-radius;
$pagination-margin-start:           -$pagination-border-width;
$pagination-border-color:           $gray-300;

$pagination-focus-color:            $link-hover-color;
$pagination-focus-bg:               $gray-200;
$pagination-focus-box-shadow:       $input-btn-focus-box-shadow;
$pagination-focus-outline:          0;

$pagination-hover-color:            $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;

Mixins

@mixin pagination-size($padding-y, $padding-x, $font-size, $border-radius) {
  .page-link {
    padding: $padding-y $padding-x;
    @include font-size($font-size);
  }

  .page-item {
    @if $pagination-margin-start == (-$pagination-border-width) {
      &:first-child {
        .page-link {
          @include border-start-radius($border-radius);
        }
      }

      &:last-child {
        .page-link {
          @include border-end-radius($border-radius);
        }
      }
    } @else {
      //Add border-radius to all pageLinks in case they have left margin
      .page-link {
        @include border-radius($border-radius);
      }
    }
  }
}