انتقل إلى المحتوى

ترقيم الصفحات

احصل على Ritla UI

يقسّم القوائم والجداول الطويلة إلى صفحات، ويبيّن العنصر المعروض في العروض المتتابعة.

فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:

افتح في Figma

المعاينة

«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.

المعاينةالكود
إنجليزيمعكوسعربي
← RTL

التثبيت

  1. أضف المكوّن

    npx ritla add pagination

    ويعمل أيضًا مع shadcn: npx shadcn@latest add @ritla/pagination

  2. الاعتماديات التي يضيفها

    @base-ui/react@phosphor-icons/react

  3. أو انسخه يدويًا

    التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.

الاستخدام

pagination.tsx
import { Pagination } from "@/components/ui/pagination";<Pagination pageCount={20} page={page} onPageChange={setPage} />

أمثلة

مختصر

السهمان وموقعك («صفحة 1 من 20»)، للمساحات الضيقة.

إنجليزيمعكوسعربي
← RTL

تحميل المزيد

العدد وزر «تحميل المزيد» للخلاصات؛ الزر يعرض مؤشر التحميل ويتعطل في الصفحة الأخيرة.

إنجليزيمعكوسعربي
← RTL

نقاط العناصر

‏PaginationDots: نقطة أو خط، بمقاسين، وعلى خلفية ضبابية فوق الصور. مع onCurrentChange تصبح كل نقطة زرًا.

إنجليزيمعكوسعربي
← RTL

مرجع الخصائص

Pagination

الخاصيةالنوعالافتراضيالوصف
variant"numbers" | "minimal" | "load-more""numbers"خاصية Style في Figma (‏style محجوز في React).
pageCountnumberلا يوجدعدد الصفحات.
page / defaultPagenumber1الصفحة الحالية، تبدأ من 1.
onPageChange(page: number) => voidلا يوجديُستدعى بالصفحة المختارة.
hrefPatternstringلا يوجدصفحات كروابط، مثل "/orders?page={page}".
onLoadMore / loading() => void / booleanلا يوجدلنمط تحميل المزيد.
numerals"latn" | "arab"لا يوجدنظام الأرقام؛ الافتراضي من RitlaProvider.

PaginationDots

الخاصيةالنوعالافتراضيالوصف
count / currentnumberلا يوجدعدد العناصر والعنصر الحالي (يبدأ من 0).
onCurrentChange(index: number) => voidلا يوجديجعل كل نقطة زرًا ينتقل إلى عنصرها.
variant"dot" | "line""dot"خاصية Style.
size"md" | "lg""md"خاصية Size.
framedbooleanfalseخاصية Framed: خلفية ضبابية للاستخدام فوق الصور.

إرشادات الاستخدام

ترقيم الصفحات يقسم قائمة طويلة إلى صفحات ويتيح التنقل بينها. هنا: أي نمط، وكيف تعرض أرقام الصفحات، وأين تضعه وما تحفظه، والعروض الدوّارة ونقاطها، وكيف يسير من اليمين في العربية، وما تتحقق منه قبل التسليم.

1. أي نمط

اختر حسب نوع القائمة والمساحة حولها. أرقام الصفحات تتيح القفز؛ والمختصر والتحميل التلقائي يوفّران المساحة؛ والنقاط للعروض الدوّارة لا للقوائم.

النمطالاستخدام
أرقام الصفحاتجداول الحاسوب ونتائج البحث، حيث يقفز الناس إلى صفحة أو يعودون إليها.
مختصرالمساحات الضيقة والهواتف: السابق والتالي و«صفحة 1 من 20».
تحميل تلقائيالخلاصات وقوائم النشاط تُقرأ من الأعلى إلى الأسفل؛ «تحميل المزيد» يضيف الصفحة التالية تحتها.
مجموعة نقاطالعروض الدوّارة والتعريف بالتطبيق، من 3 إلى 7 عناصر.

افعل

  • استخدم أرقام الصفحات للجداول التي يبحث فيها الناس.
  • استخدم المختصر على الهواتف وفي اللوحات الضيقة.
  • استخدم التحميل التلقائي للخلاصات التي تُقرأ بالترتيب.

تجنّب

  • تقسيم قائمة تتسع لشاشة واحدة.
  • الجمع بين ترقيم الصفحات والتمرير اللانهائي في قائمة واحدة.
  • استخدام النقاط لأكثر من سبعة عناصر تقريبًا.

2. أرقام الصفحات

أبقِ الصفحتين الأولى والأخيرة في المتناول، واعرض الصفحات حول الحالية، واطوِ البقية خلف «…» الذي يفتح قائمة بالصفحات المخفية. والصفحة الحالية معلَّمة بوضوح. و«السابق» و«التالي» عند الطرفين، ومعطّلان في الصفحة الأولى والأخيرة.

افعل

  • اعرض الأولى والأخيرة والصفحات حول الحالية.
  • اطوِ البقية خلف «…».
  • عطّل «السابق» في الصفحة الأولى و«التالي» في الأخيرة.
  • اعرض عدد النتائج قريبًا منه: «عرض 21 إلى 40 من 348».

تجنّب

  • عرض كل أرقام الصفحات في قائمة طويلة.
  • إخفاء الصفحة الأخيرة، فلا يعرف الناس طول القائمة.
  • حذف «السابق» أو «التالي» بدل تعطيلهما.

3. الموضع وما يُحفظ

ضع ترقيم الصفحات تحت القائمة، محاذيًا لها، واحفظ رقم الصفحة في الرابط ليعمل الرجوع والمشاركة. وحين تتغير الصفحة انتقل إلى أعلى القائمة، لا أعلى النافذة. واحفظ المرشّحات والترتيب حين يغيّر الناس الصفحة.

افعل

  • ضعه تحت القائمة التي يتحكم بها.
  • احفظ رقم الصفحة في الرابط.
  • مرّر إلى أعلى القائمة عند تغيير الصفحة.
  • احفظ المرشّحات والترتيب وحجم الصفحة بين الصفحات.

تجنّب

  • وضعه بعيدًا عن القائمة، في تذييل الصفحة.
  • إعادة ضبط المرشّحات حين يغيّر الناس الصفحة.
  • ترك الناس في أسفل صفحة جديدة.

4. العروض الدوّارة والنقاط

تُظهر النقاط عدد العناصر وأيّها المعروض. واقرنها بسهمي السابق والتالي على الحاسوب؛ وعلى شاشات اللمس يسحب الناس أيضًا. ولا تجعلها تتقدّم وحدها، أو ضع زر إيقاف ظاهرًا حين لا بد من ذلك.

افعل

  • النقاط لـ3 إلى 7 عناصر، مع أسهم على الحاسوب.
  • اسمح بالسحب على شاشات اللمس.
  • اعرض زر إيقاف إن كانت العناصر تتحرك وحدها.

تجنّب

  • التشغيل التلقائي دون وسيلة لإيقافه.
  • جعل النقاط الوسيلة الوحيدة للوصول إلى محتوى يحتاجه الناس.

5. العربية والاتجاه من اليمين إلى اليسار

تسير أرقام الصفحات في النسخ العربية من اليمين: الصفحة 1 على اليمين و«التالي» يشير إلى اليسار، نحو الصفحات الأعلى. ويكتب النمط المختصر «صفحة 1 من 20» بالعربية، وفق إعداد الأرقام. وتبدأ النقاط من اليمين، والعنصر الأول هو النقطة اليمنى.

«التالي» يشير إلى الصفحة التالية

أرقام الصفحات تحت جدول عربي.

افعل: النسخة العربيةالصفحة 1 على اليمين و«التالي» يشير إلى اليسار، نحو الصفحات الأعلى.
تجنّب: الترقيم الإنجليزي في شاشة عربية«التالي» يشير إلى اليمين، أي عائدًا نحو الصفحة 1 عند القارئ العربي.

قبل التسليم

  • النمط يناسب القائمة: أرقام الصفحات أو المختصر أو التحميل التلقائي أو النقاط.
  • الطرفان المعطّلان وعلامة الحذف وعدد النتائج مصمّمة.
  • الصفحة والمرشّحات والترتيب محفوظة في الرابط.
  • الشاشات العربية تستخدم النسخ العربية، و«التالي» يشير إلى اليسار.

إمكانية الوصول

لوحة المفاتيح

المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.

المفتاحما يفعله
Tabبين السهمين وأرقام الصفحات وزر الصفحات الأخرى.
EnterSpaceينتقل إلى الصفحة أو يفتح قائمة الصفحات المخفية.

ARIA

  • عنصر nav باسم «ترقيم الصفحات» بلغة الصفحة، والصفحة الحالية aria-current="page".
  • السهمان باسم «الصفحة السابقة» و«الصفحة التالية»، ويتعطلان عند الطرفين.
  • النقاط الزخرفية يصحبها نص مخفي «العنصر 1 من 3»؛ النقاط الأزرار باسم «انتقل إلى العنصر 2».

افعل

  • ضع aria-current="page" على الصفحة الحالية.
  • سمِّ السهمين بلغة الصفحة: «الصفحة السابقة» و«الصفحة التالية».
  • سمِّ زر «…» «صفحات أخرى».
  • أهداف لمس بارتفاع 48 بكسل على الهواتف.

تجنّب

  • أسهم وحدها بلا اسم يُعلَن.
  • نقل التركيز إلى أعلى الصفحة حين تتغير القائمة؛ انقله إلى القائمة.

ملاحظات العربية والاتجاه

ينعكس

  • الصفحة 1 على اليمين، وسهم التالي على اليسار ويتجه لليسار.
  • أول نقطة على اليمين.

لا ينعكس

  • ترتيب الأرقام داخل الرقم الواحد (18 تبقى 18).
الأرقام
أرقام الصفحات و«صفحة 3 من 20» تتبع إعداد الأرقام (0123456789 أو ٠١٢٣٤٥٦٧٨٩).
الخط العربي
‏body-14 بوزن Medium.

افعل

  • النسخ العربية: الصفحة 1 على اليمين، و«التالي» يشير إلى اليسار.
  • تسميات الصفحات بالعربية، وفق إعداد الأرقام.
  • نقاط العروض الدوّارة تبدأ من اليمين.

تجنّب

  • إبقاء سهم «التالي» متجهًا إلى اليمين في الشاشات العربية.
  • عكس الأرقام يدويًا في النسخة الإنجليزية.

الفحوص التي يجتازها

فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.

  • R012نصوص سمات غير مترجمة (placeholder وalt وtitle وaria-label وقيمة الزر)
  • R042نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
  • R043حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة
  • R050نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
  • R051تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)
  • R061أرقام مشرقية وغربية مختلطة في السياق نفسه
  • R081flex بقيمة row-reverse تصطنع الاتجاه من اليمين بدل dir (ترتيب التنقل بالمفتاح Tab يعاكس الترتيب المرئي)