Documentation menu

عنصر جدول الترتيب

جدول ترتيب موسمي لفريق رياضي أو نادٍ: اسم الفريق، ومباريات لُعبت/فاز/تعادل/خسر، والنقاط المسجَّلة له وعليه، والنقاط، مرتَّبًا تنازليًا حسب النقاط مع تمييز الصفوف الثلاثة الأولى. وعلى عكس كل عنصر في صفحة عناصر التحليلات والمخططات، لا يُعرض هذا العنصر صورةً أبدًا — فالعنصر بأكمله جدول HTML <table> حقيقي، في كل تطبيقات البريد بما فيها Outlook.

آلية العمل

تعرض كل واحدة من عناصر المخططات الثلاث عشرة في عائلة التحليلات صورة نقطية يولّدها الخادم مع بديل نصي بجانبها. والسبب أن المخطط الشريطي أو الخطي ليس له فعلًا ترميز HTML مكافئ يُعرض بشكل متّسق عبر تطبيقات البريد. أما الجدول المرتّب فلا يعاني هذه المشكلة: فالصفوف والأعمدة المرتّبة هي تحديدًا ما يعرضه ترميز <table> أصلًا وبشكل متّسق في كل مكان، بما في ذلك محرك Outlook المبني على Word. لا يوجد هنا انقسام بين الصورة والبديل — مسار عرض واحد، يُستخدم دون شرط.

تُكتب الصفوف مباشرة في محرّر الصفوف في لوحة الخصائص، فريق واحد في كل صف. لا يوجد ربط حيّ بمصدر بيانات بعد، لذا تحدّث العنصر يدويًا بعد كل مباراة — وهو نموذج التحديث اليدوي نفسه الذي تتبعه قيمة value المكتوبة لبطاقة مؤشرات الأداء قبل ربطها بمصدر بيانات. يحدث الترتيب وقت العرض: تُرتَّب الصفوف تنازليًا حسب عمود النقاط، وتحتفظ الصفوف المتعادلة بترتيبها الأصلي كما كُتبت بدلًا من إعادة خلطها، لأن Array.prototype.sort ترتيب مستقر. وتحصل الصفوف الثلاثة الأولى بعد الترتيب على شارة مركز (🥇🥈🥉) بدلًا من رقم عادي؛ ويحصل كل صف دون المركز الثالث على رقم مركز عادي.

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

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

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

جدول الترتيب محتوى خالص: لا شيء يُجاب عنه، لذا — مثل المكان — لا يظهر أبدًا في لوحة الردود أو تصدير CSV أو الخريطة الحرارية للنقرات. ولا يوجد فيه أي رابط.

الحقول القابلة للضبط:

  • العنوان — يظهر فوق الجدول؛ احذفه فلا يُعرض إلا الجدول.
  • الفرق — قائمة الصفوف: الفريق، ولُعبت، وفاز، وتعادل، وخسر، والنقاط له، والنقاط عليه، والنقاط.
  • إظهار عمود التعادلات — يشغّل العمود "D" أو يوقفه.
  • تمييز فريق (مطابقة الاسم الدقيق) — مطابقة مع عمود الفريق دون التمييز بين الأحرف الكبيرة والصغيرة.
  • لون الخلفية، والحشو، والحدّ، واستدارة الزوايا على البطاقة.
  • لون العنوان وحجمه، ولون نص الجدول وحجمه.

أمثلة

Subject

Season standings after Week 10

يبدأ غرض المشروع «فريق رياضي» مشروعًا جديدًا يحتوي مسبقًا على جدول ترتيب إلى جانب المكان، والإضافة إلى التقويم، وتأكيد الحضور. أرسل ملخصًا أسبوعيًا يحدّث العنصر نفسه بأحدث النتائج — راجع الفرق والأندية الرياضية للنمط كاملًا، بما في ذلك كيفية الإبقاء على قائمة جهات اتصال مشتركة واحدة عبر عدة فرق أو فئات عمرية. وتلخّص نشرة دوري نتائج قسم كامل في رسالة واحدة، مع ترك «تمييز فريق» فارغًا إذ لا يوجد فريق «محلي» واحد يُبرَز. ويرسل نادٍ للناشئين رسالة الترتيب نفسها إلى كل أولياء الأمور، مع ضبط «تمييز فريق» لكل فريق عبر عامل تصفية الجمهور visibleWhen بدلًا من إرسال رسالة منفصلة لكل فريق.

كيف يبدو البديل الثابت

<div style="margin:12px 0;background-color:#ffffff;padding:16px;border-radius:8px">
  <p style="margin:0 0 8px;font-weight:600;font-size:15px;color:#111827">Standings</p>
  <table style="width:100%;border-collapse:collapse;margin-top:4px">
    <tr>
      <th style="text-align:left;padding:4px 8px;border-bottom:1px solid #e5e7eb;font-weight:600">#</th>
      <th style="text-align:left;padding:4px 8px;border-bottom:1px solid #e5e7eb;font-weight:600">Team</th>
      <th style="text-align:right;padding:4px 8px;border-bottom:1px solid #e5e7eb;font-weight:600">Pts</th>
    </tr>
    <tr style="background-color:#eef2ff">
      <td style="padding:4px 8px;border-bottom:1px solid #e5e7eb;font-weight:700">🥇 1</td>
      <td style="padding:4px 8px;border-bottom:1px solid #e5e7eb;font-weight:700">Eagles</td>
      <td style="text-align:right;padding:4px 8px;border-bottom:1px solid #e5e7eb;font-weight:700">23</td>
    </tr>
  </table>
</div>

هذا هو العرض الحقيقي والوحيد للعنصر — لا يوجد مستوى بديل منفصل، لأن الجدول هو الترميز نفسه في كل تطبيقات البريد. (أُسقطت أعمدة لُعبت/فاز/تعادل/خسر/PF/PA هنا للإيجاز؛ ويُظهر الصف الذي يحمل الميدالية لون تمييز الفريق مطبَّقًا على الصف نفسه.)

انظر أيضًا