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

الجدول

احصل على Ritla UI

صفوف من السجلات يقارنها المستخدم ويتصرف بناءً عليها: معاملات وطلبات ومستخدمون. جدول حقيقي بعناوين أعمدة وخلايا.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add table

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

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

    @phosphor-icons/react

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

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

الاستخدام

table.tsx
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table";<Table>  <TableHeader variant="gray">    <TableRow>      <TableHead sort="descending" onSort={toggle}>Date</TableHead>      <TableHead align="end">Amount</TableHead>    </TableRow>  </TableHeader>  <TableBody>    <TableRow>      <TableCell>12/09/2026</TableCell>      <TableCell numeric>+2,450.00 JOD</TableCell>    </TableRow>  </TableBody></Table>

أمثلة

تحديد الصفوف

مربع تفعيل في أول عمود (CheckboxBox باسمه)، وصورة رمزية ونص فرعي في الخلية؛ الصف المحدد يبقى ملوّنًا.

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

عنوان أبيض وتلميح

‏variant="white" (الافتراضي)، وأيقونة قبل العنوان، وتلميح معلومات، ودون فواصل الأعمدة (dividers={false}).

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

جدول بيانات

شريط أدوات (بحث وتصفية وتصدير)؛ ومربع «تحديد الكل» داخل خلية العنوان عبر leading؛ وTableSelectionBar للإجراءات الجماعية مع عدد يُعلن بأرقام الصفحة؛ وإجراءات الصف في آخر خلية (اثنان ظاهران على الأكثر والباقي في «المزيد»، وكل زر يسمّي صفه)؛ وTablePagination تحت الجدول.

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

صفوف قابلة للتوسيع

‏TableExpandToggle في أول خلية يفتح TableExpandedRow تحت صفه، بعد عمود الزر. أبقِ الصف المغلق بـhidden كي يصل إليه البحث في الصفحة.

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

أعمدة ثابتة

‏sticky="start" يُبقي أول عمود ظاهرًا، وsticky="end" عمود الإجراءات، على TableHead وTableCell معًا. يظهر الظل حين يمرّ شيء تحته فقط. مرّر الجدول أفقيًا.

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

مرجع الخصائص

Table

الخاصيةالنوعالافتراضيالوصف
dividersbooleantrueخاصية Show divider: خط عند نهاية كل عمود.
aria-label / TableCaptionstring / ReactNodeلا يوجداسم الجدول لقارئ الشاشة.

TableHeader

الخاصيةالنوعالافتراضيالوصف
variant"white" | "gray""white"خاصية Color في Table header cell.

TableRow

الخاصيةالنوعالافتراضيالوصف
selectedbooleanfalse‏State = Hover/selected ثابتة لصف محدد.

TableHead

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدخاصية Label.
sort"none" | "ascending" | "descending"لا يوجدعمود قابل للترتيب وحالته؛ اتركه للأعمدة الأخرى.
onSort / sortHref() => void / stringلا يوجدزر ترتيب (شيفرة العميل) أو رابط (صفحات الخادم).
leadingIconIconComponentلا يوجدخاصية Leading icon.
infoReactNodeلا يوجدخاصية Show tooltip: تلميح معلومات بعد العنوان.
align"start" | "end""start"‏end لأعمدة الأرقام.
leadingReactNodeلا يوجدخاصية Show checkbox: عنصر تحكم قبل العنوان (مربع «تحديد الكل»)، خارج زر الترتيب.
sticky"start" | "end"لا يوجديُبقي العمود ظاهرًا أثناء التمرير الأفقي.

TableCell

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدخاصية Cell Title.
subtitleReactNodeلا يوجدخاصية Cell Subtitle.
leading / trailingReactNodeلا يوجدالعنصر قبل النص وبعده: صورة رمزية، أيقونة، وسم، مربع تفعيل…
numericbooleanfalseمبلغ أو عدد: في نهاية العمود بأرقام متساوية العرض، ومن اليسار إلى اليمين.
sticky"start" | "end"لا يوجدمثل TableHead؛ ضعه على الاثنين.

TableSelectionBar

الخاصيةالنوعالافتراضيالوصف
countnumberلا يوجدعدد الصفوف المحددة؛ اعرض الشريط ما دام أكبر من صفر.
onClear() => voidلا يوجدزر «إلغاء التحديد»؛ بدونه يختفي الزر.
clearLabel / countLabelReactNode / (n) => ReactNodeلا يوجدبدل النصين الافتراضيين («تم تحديد ٣»).
childrenReactNodeلا يوجدالإجراءات الجماعية: أزرار Ghost sm، والحذف بـdanger.

TableExpandToggle

الخاصيةالنوعالافتراضيالوصف
expandedbooleanلا يوجدهل التفاصيل ظاهرة.
onExpandedChange(expanded: boolean) => voidلا يوجديُستدعى بالحالة التالية.
controlsstringلا يوجدمعرّف TableExpandedRow.
labelstringلا يوجداسم الزر يسمّي الصف («تفاصيل عمر حداد»)؛ والحالة في aria-expanded.

TableExpandedRow

الخاصيةالنوعالافتراضيالوصف
idstringلا يوجدالمعرّف الذي يشير إليه الزر.
colSpannumberلا يوجدعدد أعمدة الجدول.

TablePagination

الخاصيةالنوعالافتراضيالوصف
pageCountnumberلا يوجدعدد الصفحات.
page / defaultPage / onPageChangenumber / number / (page) => voidلا يوجدالصفحة الحالية، من 1.
pageSize / defaultPageSize / onPageSizeChangenumber / number / (size) => voidلا يوجدالصفوف في الصفحة.
pageSizesnumber[][10, 20, 50]الخيارات في القائمة.
selected / totalnumberلا يوجد«تم تحديد 2 من 248 صفًا»؛ اتركهما لإخفائه.
numerals"latn" | "arab"لا يوجدنظام الأرقام؛ الافتراضي من RitlaProvider.

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

الجدول يقارن الحقائق نفسها عبر سجلات كثيرة. هنا: الجدول أم القائمة أم البطاقات، ومحاذاة النصوص والأرقام، والرؤوس والترتيب، وما يحمله الصف، والشاشات الصغيرة، وانعكاسه في العربية، وما تتحقق منه قبل التسليم.

1. جدول أم قائمة أم بطاقات

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

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

2. محاذاة النصوص والأرقام

يحاذي النص بداية السطر. والمبالغ وغيرها من الأرقام التي يقارنها الناس تصطف عند الفواصل العشرية، بعدد المنازل العشرية نفسه في كل صف، فتصطف الأرقام حسب منازلها. واستخدم صيغة تاريخ واحدة وصيغة عملة واحدة في الجدول كله.

المبالغ تصطف عند النهاية

معاملات البطاقة.

افعل: مبالغ محاذية للنهايةالآلاف والمئات والكسور في المكان نفسه، فتُقارن الأحجام بنظرة.
تجنّب: مبالغ محاذية للبدايةالأرقام المختلفة الطول تتعرج، والمبلغ الأكبر لا يبرز.

افعل

  • حاذِ المبالغ والأعداد إلى اليمين لتصطف الفواصل العشرية.
  • المنازل العشرية وصيغة العملة نفسها في العمود.
  • صيغة تاريخ واحدة في الجدول.
  • خلايا العمود بالعرض نفسه.

تجنّب

  • محاذاة المبالغ إلى البداية، فلا يصطف 85.500 و12,400.000.
  • الجمع بين 1.2k و1,200 في عمود واحد.
  • توسيط أعمدة النص.

3. الرؤوس والترتيب

لكل عمود رأس قصير. واعرض أيقونة الترتيب فقط على الأعمدة القابلة للترتيب، مع الاتجاه الحالي على العمود المرتّب. وضع مربع «تحديد الكل» في أول رأس حين يمكن تحديد الصفوف.

افعل

  • الرؤوس كلمة أو كلمتان.
  • أيقونة الترتيب على الأعمدة القابلة للترتيب فقط.
  • رتّب افتراضيًا بالعمود الأنفع، غالبًا التاريخ، الأحدث أولًا.

تجنّب

  • أيقونة ترتيب على كل عمود.
  • رؤوس تلتف إلى سطرين.
  • ترك الناس لا يعرفون بأي عمود رُتّب الجدول.

4. ما يحمله الصف

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

افعل

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

تجنّب

  • عدة أزرار في كل صف.
  • عرض رموز خام حيث يتوقع الناس أسماء.
  • عرض شبكة فارغة بلا رسالة.

5. الشاشات الصغيرة

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

افعل

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

تجنّب

  • حشر كل الأعمدة في شاشة هاتف.
  • إخفاء أعمدة مهمة دون وسيلة لرؤيتها.

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

استخدم الخلايا العربية في الجداول العربية: العمود الأول على اليمين والنص يحاذي اليمين. والمبالغ لا تنعكس: أرقامها تُقرأ من اليسار إلى اليمين، فتبقى محاذية لليمين وتصطف عند الفواصل العشرية، مثل المحور الرقمي في رسم بياني. ولا تجمع بين خلايا إنجليزية وعربية في جدول واحد أبدًا.

الأعمدة تنعكس، والمبالغ لا

معاملات البطاقة بالعربية.

افعل: خلايا عربية، والمبالغ عند الفواصلالتاريخ أولًا على اليمين؛ والمبالغ تبقى محاذية لليمين، فيقع 85.500 تحت مئات 12,400.000.
تجنّب: عمود مبالغ معكوسالمبالغ المحاذية لليسار تبدأ من الحافة نفسها، فلا يصطف 85.500 و12,400.000 حسب المنازل.

قبل التسليم

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

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

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

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

المفتاحما يفعله
Tabإلى أزرار الترتيب وعناصر التحكم داخل الخلايا فقط.
EnterSpaceيرتّب العمود.

ARIA

  • جدول حقيقي: table وth scope="col" وtd، وقارئ الشاشة يربط كل خلية بعنوانها.
  • العمود القابل للترتيب زر داخل th الذي يحمل aria-sort.
  • مربعات التحديد لها أسماء («تحديد الكل»، اسم الصف).
  • شريط التحديد منطقة اسمها «التحديد»، وعدده يُعلن بلطف حين يتغيّر.
  • زر التوسيع يحمل aria-expanded وaria-controls، واسمه ثابت يسمّي الصف.
  • ترقيم الجدول عنصر nav باسمه؛ أزرار الأطراف تبقى قابلة للتركيز وهي معطّلة، فلا يضيع التركيز في الصفحة الأولى، و«الصفحة 1 من 25» يُعلن بلطف.

افعل

  • خلية رأس لكل عمود.
  • aria-sort على العمود المرتّب.
  • سمِّ مربع اختيار الصف باسم الصف: «تحديد Cozmo، 3 مارس».
  • عنوان ظاهر للجدول أو caption.

تجنّب

  • بناء الجداول من صناديق عامة بدل ترميز الجدول.
  • الاعتماد على اللون وحده للمبالغ السالبة؛ أضف علامة الناقص.

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

ينعكس

  • أول عمود على اليمين، والنص في بداية الخلية (يمينها)، والفاصل في نهايتها (يسارها).
  • أعمدة الأرقام في نهاية الخلية (يسارها في العربية).
  • العمود الثابت start على اليمين وظله إلى يساره؛ وزر التوسيع يشير إلى اليسار وهو مغلق؛ وأسهم الترقيم تنقلب («التالية» إلى اليسار).

لا ينعكس

  • المبالغ تبقى من اليسار إلى اليمين، فتبقى الإشارة بجانب الرقم.
  • البريد الإلكتروني والأرقام التعريفية في <bdi dir="ltr">.
الأرقام
التواريخ والمبالغ بنظام الأرقام المختار؛ لا تخلط الصيغ في العمود الواحد. عدد التحديد والترقيم بأرقام الصفحة، و«صف» يتّفق مع العدد (٣ صفوف، ١١ صفًا، ١٠٠ صف).
الخط العربي
‏body-12 بوزن Semibold للعناوين، وbody-14 بوزن Medium للخلايا، وbody-12 للنص الفرعي.
النص ثنائي الاتجاه
لا تخلط خلايا LTR وRTL في جدول واحد: الاتجاه يأتي من الصفحة.

افعل

  • خلايا الرأس والخلايا بالنسخة العربية في الجدول كله.
  • تبدأ الأعمدة من اليمين، بترتيب الإنجليزية نفسه.
  • أبقِ المبالغ محاذية لليمين كي تصطف الفواصل العشرية، فالأرقام تُقرأ من اليسار إلى اليمين.
  • اكتب العملة في رأس العمود حين يشترك فيها العمود كله.
  • أبقِ الأرقام وأرقام الآيبان والرموز من اليسار إلى اليمين داخل خلاياها.

تجنّب

  • الجمع بين خلايا إنجليزية وعربية في جدول واحد.
  • عكس أعمدة المبالغ إلى اليسار، فلا تعود المنازل تصطف.

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

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

  • R021مخاطر اتجاه غير معزولة: أرقام هواتف وبريد إلكتروني ومقاطع لاتينية داخل نص عربي
  • R022text-align: left مضبوطة صراحة على نص عربي في معظمه
  • R042نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
  • R043حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة
  • R050نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
  • R051تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)