قالب:عد آلي/شرح

هذه صفحة توثيق قالب:عد آلي الفرعية، لشرح القالب وتصنيفه، وهي لا تدخل في استخدامه.

هذا القالب يستعمل لوا:

Module:Row numbers

قالب "عد آلي" هو حلاً مؤقتًا يستخدم كواجهة للوحدة "وحدة:Row numbers".

يسمح هذا القالب في العديد من الحالات بإنشاء مؤشر تصاعدي للصفوف في الجداول، حيث يتم ضبط ترقيم الصفوف التالية تلقائيًا عند إضافة أو حذف الصفوف. ومن المهم ملاحظة أن هذا القالب سيصبح غير ضروري في حال توفر دعم ميدياويكي لإضافة أرقام الصفوف تلقائيًا. يمكنك الاطلاع على مشروع فيفابريكاتور المشار إليه برقم T42618 لمزيد من المعلومات حول "jquery.tablesorter: Add support for a "fixed" column of row numbers. ". كما يمكنك قراءة صفحة المساعدة المتعلقة بفرز الجداول والترتيب التلقائي، والتي تحتوي على أقسام تشرح طرق ترقيم الصفوف والترتيب التلقائي.

الاستخدام

{{color box striped|wikitable|index = }}

وسيط		وصف	نوع	حالة
جدول الويكي	`1`	Either the whole wiki table surrounded by <nowiki>… </nowiki> tags, or the first section, when split by \| characters	نص	مطلوب
فهرس البدء	`index`	starting index of row count which is useful when table is split by headings. See List of highest-funded crowdfunding projects غيابي 1 مثال 50	رقم	اختياري

Format: inline

هذا القالب يستخدم لتوليد ترقيم تلقائي للصفوف في الجداول. يقبل القالب معاملين: الجدول الذي ترغب في ترقيم صفوفه وفهرس البدء.

عند استخدام القالب، سيقوم النظام بإعداد عداد داخلي يزداد تدريجيًا لترقيم الصفوف. سيتم البحث عن الكلمات المفتاحية المعينة مثل _row_count و _row_count_hold في الجدول. عندما يتم العثور على _row_count، سيتم استبدالها بقيمة العداد التالية، وعند العثور على _row_count_hold، سيتم استبدالها بالقيمة من آخر استبدال لـ _row_count.

من المهم أن تضع في اعتبارك أنه يجب لف الجدول بداخل القالب دون تهريب أحرف |. ويجب تهريب علامات المساواة العارية باستخدام {{[[قالب:{{{1}}}|{{{1}}}]]}}. وهذا يتيح للوحدة التعامل بشكل صحيح مع تلك الأحرف والعلامات في الجدول.

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

امثلة عامة

النتيجة

الكود

عنوان
الرقم	عنوان1
1	خلية1
2	خلية2
3	خلية3
3	خلية4
5	خلية5

{{عد آلي|
{| class{{=}}"wikitable"
|+عنوان
!الرقم !! عنوان1
|-
|_row_count || خلية1
|-
|_row_count || خلية2
|-
|_row_count || خلية3
|-
|_row_count_hold || خلية4
|-
|_row_count || خلية5
|}}}

قائمة الطلاب
الترتيب	الاسم	العمر
1	أحمد	20
2	سارة	22
2	جميل	18 (طالب جديد)
4	محمد	21

{{عد آلي|
{| class{{=}}"wikitable"
|+قائمة الطلاب
!الترتيب !! الاسم !! العمر
|-
|_row_count || أحمد || 20
|-
|_row_count || سارة || 22
|-
|_row_count_hold || جميل || 18 '''(طالب جديد)'''
|-
|_row_count || محمد || 21
|}}}

قائمة المدن
الترتيب	المدينة	الدولة
1	لندن	المملكة المتحدة
2	باريس	فرنسا
2	روما	إيطاليا (العاصمة التاريخية)
4	مدريد	إسبانيا

{{عد آلي|
{| class{{=}}"wikitable"
|+قائمة المدن
!الترتيب !! المدينة !! الدولة
|-
|_row_count || لندن || المملكة المتحدة
|-
|_row_count || باريس || فرنسا
|-
|_row_count_hold || روما || إيطاليا '''(العاصمة التاريخية)'''
|-
|_row_count || مدريد || إسبانيا
|}}}

جدول الأفلام
الترتيب	الفيلم	النوع
1	Avengers: Endgame	حركة وخيال علمي
2	The Shawshank Redemption	دراما وجريمة
2	The Exorcist	رعب (تراث)
4	La La Land	رومانسي وموسيقى

{{عد آلي|
{| class{{=}}"wikitable"
|+جدول الأفلام
!الترتيب !! الفيلم !! النوع
|-
|_row_count || Avengers: Endgame || حركة وخيال علمي
|-
|_row_count || The Shawshank Redemption || دراما وجريمة
|-
|_row_count_hold || The Exorcist || رعب '''(تراث)'''
|-
|_row_count || La La Land || رومانسي وموسيقى
|}}}

عنوان
الرقم	عنوان1
50	خلية1
51	خلية2
52	خلية3
52	خلية4
54	خلية5

{{عد آلي|
{| class{{=}}"wikitable"
|+عنوان
!الرقم !! عنوان1
|-
|_row_count || خلية1
|-
|_row_count || خلية2
|-
|_row_count || خلية3
|-
|_row_count_hold || خلية4
|-
|_row_count || خلية5
|}|index =50}}