CSS: pagination

.instui-pagination — 分頁導覽：頁碼、第一頁、上一頁、下一頁與最後一頁箭頭，以及表示間隙的省略號。

個別分頁控制請參見 pagination.page 成員。

Source: page.css

無障礙

為 <nav> 加上 aria-label，將目前頁標記為 aria-current="page"，為每個箭頭加入 aria-label，並以 disabled 或 aria-disabled="true" 來停用首尾箭頭。

使用方法

@import "@pantoken/components/components.css";
@import "@pantoken/components/pagination.css";

範例

<nav class="instui-pagination" aria-label="Pagination">
  <button class="arrow" type="button" aria-label="First page" disabled><span class="instui-icon -icon-chevrons-left"></span></button>
  <button class="arrow" type="button" aria-label="Previous page" disabled><span class="instui-icon -icon-chevron-left"></span></button>
  <a class="page" href="#" aria-current="page">1</a>
  <a class="page" href="#">2</a>
  <a class="page" href="#">3</a>
  <span class="ellipsis">…</span>
  <a class="page" href="#">12</a>
  <a class="arrow" href="#" aria-label="Next page"><span class="instui-icon -icon-chevron-right"></span></a>
  <a class="arrow" href="#" aria-label="Last page"><span class="instui-icon -icon-chevrons-right"></span></a>
</nav>

結構

.instui-pagination
  .arrow
    [class*="-icon-"] (0..1)
  pagination.page (component, 0..n)
  .ellipsis (0..1)

flowchart TD n0[".instui-pagination"]:::cssdoc-root n1(".arrow"):::cssdoc-part n2("[class*="-icon-"]"):::cssdoc-part n3(["pagination.page"]):::cssdoc-component n4(".ellipsis"):::cssdoc-part n1 -.->|0..1| n2 n0 --> n1 n0 -->|0..n| n3 n0 -.->|0..1| n4 click n3 "/api/css/pagination.page.md" classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

修飾器

修飾器	說明
.-icon-*	在 first/prev/next/last 控制項內呈現箭頭字形圖示。
.-variant-input	帶頁碼輸入的緊湊版。

部件

部件	說明
.arrow	第一頁、上一頁、下一頁或最後一頁的控制項。
.ellipsis	頁範圍間的間隔標記。
.page-input-label	頁碼輸入欄位的標籤（輸入變體）。

狀態

狀態	說明
[aria-disabled="true"]	—
:disabled	—

已使用的代幣

Token	型別	值
--instui-border-width-md	<length>	0.125rem
--instui-color-background-muted	<color>	LightDarklight-dark(#F2F4F5, #273540)
--instui-color-text-interactive-navigation-primary-base	<color>	LightDarklight-dark(#2369A4, #7FB4F1)
--instui-color-text-interactive-navigation-primary-hover	<color>	LightDarklight-dark(#1A5281, #ACCDF7)
--instui-color-text-muted	<color>	LightDarklight-dark(#576773, #AAB0B5)
--instui-component-base-button-border-radius	<length>	0.75rem
--instui-component-pagination-page-indicator-gap	<length>	0.5rem
--instui-component-pagination-page-input-input-spacing	<length>	0.5rem
--instui-component-pagination-page-input-input-width	<length>	4.5rem
--instui-component-pagination-page-input-label-color	<color>	LightDarklight-dark(#273540, #F2F4F5)
--instui-font-family-base	[ <font-family-name> | <generic-font-family> ]#	Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-font-weight-interactive	<integer>	500
--instui-opacity-disabled	<number>	0.5
--instui-spacing-space-xs	<length>	0.25rem
--instui-spacing-space2xs	<length>	0.125rem

子元件

• pagination.page