Lorixen.
AR

رسوم بيانية عربية في لوحة المبيعات: إعداد Chart.js من اليمين

باختصار: إذا كانت لوحة المبيعات في موقعك أو تطبيقك تعرض الرسوم البيانية باتجاه إنجليزي، فتظهر وسيلة الإيضاح من اليسار والتلميح بنص مقلوب والأشهر تبدأ من اليسار، فالحل في Chart.js ليس قلب الصفحة كلها. توثيق المكتبة يوفّر خيار rtl وخيار textDirection لوسيلة الإيضاح وللتلميح، وخيار reverse لعكس المحور الأفقي، وخيار position لنقل المحور الرأسي إلى اليمين، وخيار locale لتنسيق الأرقام. اضبط هذه الخيارات معاً، واختبرها ببيانات عربية حقيقية قبل أن يراها فريقك.

لماذا تبدو الرسوم «إنجليزية» في لوحة عربية

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

السبب أن Chart.js يرسم على عنصر canvas، والرسم على canvas لا يتبع تلقائياً كل ما تعرفه الصفحة عن الاتجاه. ضبط dir="rtl" على الصفحة يعكس تخطيط الصفحة، لكنه لا يقرر وحده أين تبدأ وسيلة الإيضاح، ولا ترتيب أسطر التلميح، ولا من أي جهة يبدأ محور الزمن. هذه قرارات يتخذها المطوّر داخل إعدادات الرسم نفسه.

الأعراض التي يشتكي منها الموظفون عادة

قبل أي تعديل، اجمع الشكاوى كما يصفها من يستخدم اللوحة، لأنها تحدد أي خيار تحتاج:

  • أسماء الفروع في وسيلة الإيضاح تظهر بترتيب غريب، والمربع الملوّن على الجهة الخطأ من الاسم.
  • التلميح الذي يظهر عند لمس عمود يعرض «مبيعات: 120» بترتيب متداخل، أو تختلط فيه الكلمة العربية مع الرقم.
  • محور الأيام يبدأ من اليسار، فيقرأ المدير الأسبوع بالعكس ويظن أن المبيعات تنخفض وهي ترتفع.
  • محور القيم على اليسار بعيداً عن بداية القراءة.
  • الخط العربي في الرسم يختلف عن خط الصفحة، أو يظهر بخط النظام الافتراضي.

الخيارات التي يوفرها Chart.js للاتجاه

وسيلة الإيضاح (legend): تذكر صفحة الإعدادات في توثيق Chart.js خياراً اسمه rtl، وقيمته true تعني رسم وسيلة الإيضاح من اليمين إلى اليسار. وبجانبه خيار textDirection الذي يفرض اتجاه النص rtl أو ltr على canvas عند رسم وسيلة الإيضاح، بغض النظر عن CSS المحدد على العنصر.

التلميح (tooltip): صفحة التلميح في التوثيق تحمل الخيارين نفسيهما: rtl لرسم التلميح من اليمين إلى اليسار، وtextDirection لفرض اتجاه النص عند رسمه.

المحاور (scales): صفحة المحاور تذكر خيار reverse لعكس المقياس، وتوضح أن موضع المحور يحدد بخيار position، ومثالها يضع محوراً على الجهة اليمنى بقيمة 'right'. في لوحة عربية، عكس المحور الأفقي يجعل أول يوم في الأسبوع على اليمين، ووضع المحور الرأسي على اليمين يجعل القيم بجانب بداية القراءة.

تنسيق الأرقام (locale): صفحة Locale توضح أن خيار locale يقبل معرّف لغة بصيغة BCP 47، ويُستخدم لتنسيق أرقام علامات المحاور حسب اللغة. هنا قرار مهم: كثير من المواقع الأردنية تستخدم الأرقام الغربية 0 إلى 9 في الواجهة. اختر المعرّف الذي يعطي الأرقام التي اعتمدتموها في بقية اللوحة، وجرّب النتيجة فعلياً بدل افتراضها، لأن بعض المعرّفات العربية قد تعرض الأرقام بشكل مختلف عمّا في جداولك.

مثال توضيحي لإعدادات رسم مبيعات أسبوعية

مثال توضيحي لرسم أعمدة لمبيعات فرعين خلال أسبوع، مع الإعدادات التي تخص الاتجاه فقط:

new Chart(ctx, {
  type: 'bar',
  data: { labels: days, datasets: [branchA, branchB] },
  options: {
    locale: 'en-US',
    scales: {
      x: { reverse: true },
      y: { position: 'right' }
    },
    plugins: {
      legend: { rtl: true, textDirection: 'rtl' },
      tooltip: { rtl: true, textDirection: 'rtl' }
    }
  }
});

القيمة 'en-US' في هذا المثال اختيار مقصود لإبقاء الأرقام غربية كما في بقية الواجهة، وليست توصية عامة. إذا كانت لوحتكم تعتمد تنسيقاً آخر، غيّرها واختبر.

الخط العربي داخل الرسم

صفحة الخطوط في التوثيق توضح أن الإعدادات العامة للخط موجودة في Chart.defaults.font، وأن الخط الافتراضي عائلة لاتينية مثل Helvetica وArial. لذلك إن لم تحدد الخط، ستظهر أسماء الفروع والأصناف العربية بخط النظام، لا بخط موقعك.

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

اختبار سريع قبل التسليم

لا تعتمد على لقطة شاشة واحدة. جهّز بيانات تجريبية تشبه الواقع ومرّ على هذه النقاط:

  1. أسماء فروع وأصناف عربية طويلة، مثل «كعك بالسمسم والتمر»، لترى هل تُقص أو تتداخل في وسيلة الإيضاح.
  2. اسم صنف يجمع العربية مع رقم أو كلمة إنجليزية، مثل «علبة 12 قطعة» أو «Combo عائلي»، لأن الخلط هو أكثر ما يربك ترتيب النص.
  3. التلميح على الهاتف باللمس، لا بالفأرة فقط، لأن موظف الفرع غالباً يفتح اللوحة من جواله.
  4. شهر كامل على المحور الأفقي، للتأكد أن عكس المحور لا يجعل التواريخ تتزاحم بطريقة غير مقروءة.
  5. رسم دائري لحصة كل فرع، لأن وسيلة إيضاحه أطول عادة.
  6. وضع الطباعة أو حفظ الصورة إن كان المدير يرسل الرسم في تقرير.

متى لا تعكس المحور

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

وإذا كانت اللوحة ثنائية اللغة، فاجعل خيارات الاتجاه تتبع لغة الواجهة الحالية بدل تثبيتها في الكود، حتى لا يظهر رسم عربي الاتجاه لمستخدم اختار الإنجليزية.

أسئلة شائعة

هل يكفي dir="rtl" على الصفحة؟

لا. هذا يعكس تخطيط الصفحة، لكن الرسم داخل canvas تحكمه خيارات المكتبة. وسيلة الإيضاح والتلميح لهما خيار rtl وtextDirection، والمحاور لها reverse وposition.

لماذا يظهر الخط العربي صحيحاً بعد التحديث فقط؟

لأن الرسم ظهر قبل اكتمال تحميل الخط. توثيق Chart.js يوضح أن الرسوم تحتاج إلى تحديث بعد تحميل الخط، باستخدام واجهات تحميل الخطوط في المتصفح.

هل أستخدم الأرقام العربية الهندية في الرسوم؟

القرار لكم، لكن اجعله موحداً مع بقية الواجهة. خيار locale يتحكم في تنسيق أرقام المحاور، فاختبر المعرّف الذي تختاره ببيانات حقيقية.

هل هذه الخيارات موجودة في كل إصدارات Chart.js؟

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

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

المصادر

WhatsAppاحجز مكالمة