ترقيم الصفحات
يقسّم القوائم والجداول الطويلة إلى صفحات، ويبيّن العنصر المعروض في العروض المتتابعة.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add paginationويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/paginationالاعتماديات التي يضيفها
@base-ui/react@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Pagination } from "@/components/ui/pagination";<Pagination pageCount={20} page={page} onPageChange={setPage} />أمثلة
صفحات كروابط
hrefPattern يجعل كل صفحة رابطًا حقيقيًا (?page={page})، فتعمل صفحات الخادم دون شيفرة عميل.
تحميل المزيد
العدد وزر «تحميل المزيد» للخلاصات؛ الزر يعرض مؤشر التحميل ويتعطل في الصفحة الأخيرة.
نقاط العناصر
PaginationDots: نقطة أو خط، بمقاسين، وعلى خلفية ضبابية فوق الصور. مع onCurrentChange تصبح كل نقطة زرًا.
مرجع الخصائص
Pagination
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
variant | "numbers" | "minimal" | "load-more" | "numbers" | خاصية Style في Figma (style محجوز في React). |
pageCount | number | لا يوجد | عدد الصفحات. |
page / defaultPage | number | 1 | الصفحة الحالية، تبدأ من 1. |
onPageChange | (page: number) => void | لا يوجد | يُستدعى بالصفحة المختارة. |
hrefPattern | string | لا يوجد | صفحات كروابط، مثل "/orders?page={page}". |
onLoadMore / loading | () => void / boolean | لا يوجد | لنمط تحميل المزيد. |
numerals | "latn" | "arab" | لا يوجد | نظام الأرقام؛ الافتراضي من RitlaProvider. |
PaginationDots
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
count / current | number | لا يوجد | عدد العناصر والعنصر الحالي (يبدأ من 0). |
onCurrentChange | (index: number) => void | لا يوجد | يجعل كل نقطة زرًا ينتقل إلى عنصرها. |
variant | "dot" | "line" | "dot" | خاصية Style. |
size | "md" | "lg" | "md" | خاصية Size. |
framed | boolean | false | خاصية Framed: خلفية ضبابية للاستخدام فوق الصور. |
إرشادات الاستخدام
ترقيم الصفحات يقسم قائمة طويلة إلى صفحات ويتيح التنقل بينها. هنا: أي نمط، وكيف تعرض أرقام الصفحات، وأين تضعه وما تحفظه، والعروض الدوّارة ونقاطها، وكيف يسير من اليمين في العربية، وما تتحقق منه قبل التسليم.
1. أي نمط
اختر حسب نوع القائمة والمساحة حولها. أرقام الصفحات تتيح القفز؛ والمختصر والتحميل التلقائي يوفّران المساحة؛ والنقاط للعروض الدوّارة لا للقوائم.
| النمط | الاستخدام |
|---|---|
| أرقام الصفحات | جداول الحاسوب ونتائج البحث، حيث يقفز الناس إلى صفحة أو يعودون إليها. |
| مختصر | المساحات الضيقة والهواتف: السابق والتالي و«صفحة 1 من 20». |
| تحميل تلقائي | الخلاصات وقوائم النشاط تُقرأ من الأعلى إلى الأسفل؛ «تحميل المزيد» يضيف الصفحة التالية تحتها. |
| مجموعة نقاط | العروض الدوّارة والتعريف بالتطبيق، من 3 إلى 7 عناصر. |
افعل
- استخدم أرقام الصفحات للجداول التي يبحث فيها الناس.
- استخدم المختصر على الهواتف وفي اللوحات الضيقة.
- استخدم التحميل التلقائي للخلاصات التي تُقرأ بالترتيب.
تجنّب
- تقسيم قائمة تتسع لشاشة واحدة.
- الجمع بين ترقيم الصفحات والتمرير اللانهائي في قائمة واحدة.
- استخدام النقاط لأكثر من سبعة عناصر تقريبًا.
2. أرقام الصفحات
أبقِ الصفحتين الأولى والأخيرة في المتناول، واعرض الصفحات حول الحالية، واطوِ البقية خلف «…» الذي يفتح قائمة بالصفحات المخفية. والصفحة الحالية معلَّمة بوضوح. و«السابق» و«التالي» عند الطرفين، ومعطّلان في الصفحة الأولى والأخيرة.
افعل
- اعرض الأولى والأخيرة والصفحات حول الحالية.
- اطوِ البقية خلف «…».
- عطّل «السابق» في الصفحة الأولى و«التالي» في الأخيرة.
- اعرض عدد النتائج قريبًا منه: «عرض 21 إلى 40 من 348».
تجنّب
- عرض كل أرقام الصفحات في قائمة طويلة.
- إخفاء الصفحة الأخيرة، فلا يعرف الناس طول القائمة.
- حذف «السابق» أو «التالي» بدل تعطيلهما.
3. الموضع وما يُحفظ
ضع ترقيم الصفحات تحت القائمة، محاذيًا لها، واحفظ رقم الصفحة في الرابط ليعمل الرجوع والمشاركة. وحين تتغير الصفحة انتقل إلى أعلى القائمة، لا أعلى النافذة. واحفظ المرشّحات والترتيب حين يغيّر الناس الصفحة.
افعل
- ضعه تحت القائمة التي يتحكم بها.
- احفظ رقم الصفحة في الرابط.
- مرّر إلى أعلى القائمة عند تغيير الصفحة.
- احفظ المرشّحات والترتيب وحجم الصفحة بين الصفحات.
تجنّب
- وضعه بعيدًا عن القائمة، في تذييل الصفحة.
- إعادة ضبط المرشّحات حين يغيّر الناس الصفحة.
- ترك الناس في أسفل صفحة جديدة.
4. العروض الدوّارة والنقاط
تُظهر النقاط عدد العناصر وأيّها المعروض. واقرنها بسهمي السابق والتالي على الحاسوب؛ وعلى شاشات اللمس يسحب الناس أيضًا. ولا تجعلها تتقدّم وحدها، أو ضع زر إيقاف ظاهرًا حين لا بد من ذلك.
افعل
- النقاط لـ3 إلى 7 عناصر، مع أسهم على الحاسوب.
- اسمح بالسحب على شاشات اللمس.
- اعرض زر إيقاف إن كانت العناصر تتحرك وحدها.
تجنّب
- التشغيل التلقائي دون وسيلة لإيقافه.
- جعل النقاط الوسيلة الوحيدة للوصول إلى محتوى يحتاجه الناس.
5. العربية والاتجاه من اليمين إلى اليسار
تسير أرقام الصفحات في النسخ العربية من اليمين: الصفحة 1 على اليمين و«التالي» يشير إلى اليسار، نحو الصفحات الأعلى. ويكتب النمط المختصر «صفحة 1 من 20» بالعربية، وفق إعداد الأرقام. وتبدأ النقاط من اليمين، والعنصر الأول هو النقطة اليمنى.
«التالي» يشير إلى الصفحة التالية
أرقام الصفحات تحت جدول عربي.
قبل التسليم
- النمط يناسب القائمة: أرقام الصفحات أو المختصر أو التحميل التلقائي أو النقاط.
- الطرفان المعطّلان وعلامة الحذف وعدد النتائج مصمّمة.
- الصفحة والمرشّحات والترتيب محفوظة في الرابط.
- الشاشات العربية تستخدم النسخ العربية، و«التالي» يشير إلى اليسار.
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | بين السهمين وأرقام الصفحات وزر الصفحات الأخرى. |
| EnterSpace | ينتقل إلى الصفحة أو يفتح قائمة الصفحات المخفية. |
ARIA
- عنصر
navباسم «ترقيم الصفحات» بلغة الصفحة، والصفحة الحاليةaria-current="page". - السهمان باسم «الصفحة السابقة» و«الصفحة التالية»، ويتعطلان عند الطرفين.
- النقاط الزخرفية يصحبها نص مخفي «العنصر 1 من 3»؛ النقاط الأزرار باسم «انتقل إلى العنصر 2».
افعل
- ضع
aria-current="page"على الصفحة الحالية. - سمِّ السهمين بلغة الصفحة: «الصفحة السابقة» و«الصفحة التالية».
- سمِّ زر «…» «صفحات أخرى».
- أهداف لمس بارتفاع 48 بكسل على الهواتف.
تجنّب
- أسهم وحدها بلا اسم يُعلَن.
- نقل التركيز إلى أعلى الصفحة حين تتغير القائمة؛ انقله إلى القائمة.
ملاحظات العربية والاتجاه
ينعكس
- الصفحة 1 على اليمين، وسهم التالي على اليسار ويتجه لليسار.
- أول نقطة على اليمين.
لا ينعكس
- ترتيب الأرقام داخل الرقم الواحد (18 تبقى 18).
- الأرقام
- أرقام الصفحات و«صفحة 3 من 20» تتبع إعداد الأرقام (
0123456789أو٠١٢٣٤٥٦٧٨٩). - الخط العربي
-
body-14بوزن Medium.
افعل
- النسخ العربية: الصفحة 1 على اليمين، و«التالي» يشير إلى اليسار.
- تسميات الصفحات بالعربية، وفق إعداد الأرقام.
- نقاط العروض الدوّارة تبدأ من اليمين.
تجنّب
- إبقاء سهم «التالي» متجهًا إلى اليمين في الشاشات العربية.
- عكس الأرقام يدويًا في النسخة الإنجليزية.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.
- نصوص سمات غير مترجمة (placeholder وalt وtitle وaria-label وقيمة الزر)
- نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
- حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة
- نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
- تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)
- أرقام مشرقية وغربية مختلطة في السياق نفسه
- flex بقيمة row-reverse تصطنع الاتجاه من اليمين بدل dir (ترتيب التنقل بالمفتاح Tab يعاكس الترتيب المرئي)