ข้ามไปที่เนื้อหาหลัก ข้ามไปที่การนำทางเอกสาร
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เพื่อพยายามปิดใช้งานฟังก์ชันลิงก์ของ<a>s คุณสมบัติ CSS นั้นยังไม่เป็นมาตรฐานและไม่ได้คำนึงถึงการนำทางด้วยแป้นพิมพ์ ดังนั้น คุณควรเพิ่ม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>

ซาส

ตัวแปร

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

มิกซ์อิน

@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);
      }
    }
  }
}