Pagination
روابط أو أزرار للتنقل بين صفحات النتائج.
- المتصفحات
- Chrome 123+Firefox 121+Safari 17.5+
- الفئة
- 0
- الحجم المضغوط
- 2.59 kB
- ميزانية التخطيط القسري
- 0 ms
- ميزانية axe
- 0
- متوافق مع SSR
- نعم
- العقد المنشور
- بيئة الاختبار
المختبر
Pagination
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