Pagination
روابط أو أزرار للتنقل بين صفحات النتائج.
- المتصفحات
- Chrome 123+Firefox 121+Safari 17.5+
- الفئة
- 0
- الحجم المضغوط
- 2.59 kB
- ميزانية التخطيط القسري
- 0 ms
- ميزانية axe
- 0
- متوافق مع SSR
- نعم
- العقد المنشور
- بيئة الاختبار
المختبر
Pagination
import { Pagination } from "@gunkin/uiify";
export default function Example() {
return (
<Pagination.Root className="" count={20} defaultPage={5}>
<Pagination.List />
</Pagination.Root>
);
}@layer components {
[data-uiify-pagination] ol {
display: flex;
flex-wrap: wrap;
align-items: center;
justify-content: center;
gap: 0.25rem;
list-style: none;
padding: 0;
margin: 0;
}
[data-uiify-pagination] li {
display: grid;
place-items: center;
}
/* Page links and the previous/next controls are Button-skinned (`ghost`); the current
page is the selected one. Links stay links, so only the pointer is restored here. */
[data-uiify-pagination] [data-type="ellipsis"] {
display: inline-grid;
place-items: center;
min-inline-size: 2.75rem;
color: var(--muted-foreground);
}
[data-uiify-pagination] span[data-uiify-button]:not([data-disabled]) {
cursor: default;
}
[data-uiify-pagination] svg {
inline-size: 1rem;
block-size: 1rem;
}
}import { Pagination } from "@gunkin/uiify";
export default function Example() {
return (
<Pagination.Root
className="
[&_ol]:flex [&_ol]:flex-wrap [&_ol]:items-center [&_ol]:justify-center [&_ol]:[gap:0.25rem] [&_ol]:list-none
[&_ol]:p-0 [&_ol]:m-0 [&_li]:grid [&_li]:place-items-center [&_[data-type=ellipsis]]:inline-grid
[&_[data-type=ellipsis]]:place-items-center [&_[data-type=ellipsis]]:[min-inline-size:2.75rem]
[&_[data-type=ellipsis]]:text-muted-foreground [&_span[data-uiify-button]:not([data-disabled])]:cursor-default
[&_svg]:[inline-size:1rem] [&_svg]:[block-size:1rem]
"
count={20}
defaultPage={5}
>
<Pagination.List />
</Pagination.Root>
);
}/* app.css */
@layer reset, ui, app, tokens, base, demo, components, utilities, theme;
@import "@gunkin/uiify/styles/reset";
@import "@gunkin/uiify/components/behavior.css";
@import "@gunkin/uiify/styles/tokens";
@import "@gunkin/uiify/styles/tailwind";
@import "tailwindcss/utilities.css";
@theme { --spacing: 0.25rem; --font-weight-normal: 400; --font-weight-medium: 500; --font-weight-semibold: 600; --font-weight-bold: 700; }
@source inline('[&_ol]:flex [&_ol]:flex-wrap [&_ol]:items-center [&_ol]:justify-center [&_ol]:[gap:0.25rem] [&_ol]:list-none [&_ol]:p-0 [&_ol]:m-0 [&_li]:grid [&_li]:place-items-center [&_[data-type=ellipsis]]:inline-grid [&_[data-type=ellipsis]]:place-items-center [&_[data-type=ellipsis]]:[min-inline-size:2.75rem] [&_[data-type=ellipsis]]:text-muted-foreground [&_span[data-uiify-button]:not([data-disabled])]:cursor-default [&_svg]:[inline-size:1rem] [&_svg]:[block-size:1rem]');
@layer base { :root { --uiify-control-text: var(--text-sm); } @media (pointer: coarse) { :root { --uiify-control-text: var(--text-base); } } }
/* Authored animation and registered properties used by the Tailwind skin.
* Visual rules belong in utility recipes; only at-rule definitions live here. */
@layer components {
@keyframes uiify-presence-in {
from {
opacity: 0;
scale: var(--presence-scale);
}
}
}
@layer components {
@keyframes uiify-presence-out {
to {
opacity: 0;
scale: var(--presence-scale);
}
}
}
@property --uiify-spinner-tail {
syntax: "<angle>";
inherits: false;
initial-value: 0deg;
}
@property --uiify-spinner-length {
syntax: "<angle>";
inherits: false;
initial-value: 36deg;
}
@layer components {
@keyframes uiify-spinner-rotate {
to {
transform: rotate(360deg);
}
}
}
@layer components {
@keyframes uiify-spinner-orbit {
0% {
--uiify-spinner-tail: 0deg;
--uiify-spinner-length: 36deg;
}
50% {
--uiify-spinner-tail: 90deg;
--uiify-spinner-length: 324deg;
}
100% {
--uiify-spinner-tail: 360deg;
--uiify-spinner-length: 36deg;
}
}
}
@layer components {
@keyframes uiify-skeleton-pulse {
50% {
opacity: 0.45;
}
}
}
@layer components {
@keyframes uiify-skeleton-shimmer {
to {
background-position: -200% 0;
}
}
}
@layer components {
@keyframes uiify-skeleton-reveal {
from {
opacity: 0;
}
to {
opacity: 1;
}
}
}
@property --candle-body-height {
syntax: "<percentage>";
inherits: true;
initial-value: 0%;
}
@property --candle-body-top {
syntax: "<percentage>";
inherits: true;
initial-value: 50%;
}
@property --candle-slot {
syntax: "<percentage>";
inherits: true;
initial-value: 100%;
}
@property --candle-wick-height {
syntax: "<percentage>";
inherits: true;
initial-value: 0%;
}
@property --candle-wick-top {
syntax: "<percentage>";
inherits: true;
initial-value: 50%;
}
@property --candle-x {
syntax: "<percentage>";
inherits: true;
initial-value: 0%;
}
@property --candle-scale {
syntax: "<number>";
inherits: true;
initial-value: 1;
}
@property --line-y {
syntax: "<percentage>";
inherits: true;
initial-value: 50%;
}
@property --line-prev-y {
syntax: "<percentage>";
inherits: true;
initial-value: 50%;
}
@property --line-count {
syntax: "<integer>";
inherits: false;
initial-value: 1;
}
@property --line-scale {
syntax: "<number>";
inherits: true;
initial-value: 1;
}
@layer components {
@keyframes uiify-otp-input-caret-blink {
50% {
opacity: 0;
}
}
}API
Pagination.Root
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
aria-label | string | "Pagination" | اسم مَعلم التنقل للتقنيات المساعدة. |
boundaryCount | number | 1 | عدد الصفحات المعروضة دائمًا عند كل طرف من النطاق. |
count* | number | — | إجمالي عدد الصفحات. |
defaultPage | number | 1 | الصفحة المحدّدة مبدئيًا حين يُترك المكوّن غير متحكّم به. |
disabled | boolean | false | يعطّل كل صفحة وكل عنصر تحكم للتنقل. |
onPageChange | (page: number) => void | — | تُستدعى برقم الصفحة الجديد كلما تغيّرت الصفحة. |
page | number | — | الصفحة الحالية، وتجعل المكوّن متحكّمًا به. |
showFirstLast | boolean | false | يضيف عنصرَي تحكم للصفحتين الأولى والأخيرة إلى العناصر المولّدة. |
siblingCount | number | 1 | عدد الصفحات المعروضة على كل جانب من الصفحة الحالية. |
children | ReactNode | — | بنية HTML مخصّصة للعناصر؛ وعند حذفها تُعرض قائمة الصفحات المولّدة. |
getPageHref | (page: number) => string | — | يبني href لكل صفحة، ليعرض هيكل الخادم روابط حقيقية تعمل دون JavaScript. |
render | ReactElement | ((props, state) => ReactElement) | — | استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول. |
Pagination.List
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
children | ReactNode | — | عناصر ترقيم الصفحات المعروضة داخل القائمة. |
render | ReactElement | ((props, state) => ReactElement) | — | استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول. |
Pagination.Item
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
children | ReactNode | — | محتوى عنصر واحد في قائمة ترقيم الصفحات. |
render | ReactElement | ((props, state) => ReactElement) | — | استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول. |
Pagination.Link
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
disabled | boolean | false | يعطّل عنصر التحكم ويحذف href الخاص به. |
getPageHref | (page: number) => string | — | يبني href لهذه الصفحة، فيحوّل عنصر التحكم إلى رابط حقيقي. |
page* | number | — | رقم الصفحة التي يختارها عنصر التحكم هذا. |
selected | boolean | false | يعلّم هذه الصفحة كالحالية ويعيّن aria-current عليها. |
render | ReactElement | ((props, state) => ReactElement) | — | استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول. |
Pagination.Ellipsis
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
children | ReactNode | — | محتوى علامة الحذف، ويُخفى عن التقنيات المساعدة. |
render | ReactElement | ((props, state) => ReactElement) | — | استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول. |
لوحة المفاتيح
| المفتاح | الإجراء |
|---|---|
| Tab | نقل التركيز إلى عنصر التحكم أو منه |
| Enter / Space | التفعيل عند التركيز (لعناصر التحكم الشبيهة بالأزرار) |
إمكانية الوصول
يستخدم HTML الدلالي متى أمكن. افحص بنية HTML المعروضة في المختبر؛ لا تُضاف ARIA إلا حين لا تكفي العناصر الأصلية.
نقاط التنسيق
data-disabled