Lorixen.
AR

بطاقة الفرع مرة واحدة في كل الصفحات: العناصر المخصصة

باختصار: إذا كان رقم الفرع وساعات دوامه ورابط موقعه مكتوبة يدوياً في عشر صفحات من موقعك، فستنسى تحديث واحدة منها عند أول تغيير. العناصر المخصصة (Custom Elements) في المتصفح تتيح لك أن تبني مكوّناً صغيراً مثل بطاقة الفرع مرة واحدة، ثم تضعه في أي صفحة بوسم بسيط مثل branch-card، وتأتي بياناته من مصدر واحد. لا تحتاج إطار عمل كاملاً، لكن احرص على أن يبقى المحتوى الأساسي مقروءاً حتى لو لم يعمل الكود.

المشكلة التي يعرفها كل من عنده فرعان

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

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

ما هو العنصر المخصص

تشرح وثائق MDN أن العنصر المخصص صنف (class) في جافاسكربت يُعرَّف مرة ويُسجَّل في المتصفح باسم، ثم يُستخدم في الصفحة كأي وسم HTML. والاسم له شروط: يبدأ بحرف إنجليزي صغير، ويحتوي على شرطة، مثل branch-card أو opening-hours، حتى لا يتعارض مع عناصر HTML الحالية أو المستقبلية.

وتذكر الوثائق نوعين:

  • عناصر مستقلة ترث من HTMLElement، وتبني سلوكها كاملاً بنفسك.
  • عناصر توسّع عنصراً موجوداً، مثل الصورة أو الفقرة. وتنبّه MDN إلى أن متصفح Safari لا يخطط لدعم هذا النوع، لذلك اعتمد على النوع الأول في المواقع التي يزورها أصحاب الآيفون، أي معظم المواقع.

بطاقة الفرع كمثال

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

const BRANCHES = {
  khalda: { name: 'فرع خلدا', phone: '+9627XXXXXXXX', map: 'https://maps.example/khalda' },
  zarqa:  { name: 'فرع الزرقاء', phone: '+9627XXXXXXXX', map: 'https://maps.example/zarqa' }
};
class BranchCard extends HTMLElement {
  static observedAttributes = ['branch'];
  connectedCallback() { this.render(); }
  attributeChangedCallback() { this.render(); }
  render() {
    const b = BRANCHES[this.getAttribute('branch')];
    if (!b) return;
    this.innerHTML = `<h3>${b.name}</h3>
      <a href="tel:${b.phone}">اتصل</a> · <a href="${b.map}">الموقع على الخريطة</a>`;
  }
}
customElements.define('branch-card', BranchCard);

وفي أي صفحة تكتب فقط: branch-card مع السمة branch="zarqa". الأرقام هنا أماكن فارغة، وتأتي في موقعك من بياناتك الحقيقية.

دورة الحياة بكلمات بسيطة

توضح MDN أن المتصفح يستدعي دوال معينة في أوقات معينة:

  • connectedCallback عند إضافة العنصر إلى الصفحة، وتوصي المواصفة بوضع الإعداد هنا لا في الدالة البانية.
  • disconnectedCallback عند إزالته.
  • attributeChangedCallback عند تغيّر إحدى السمات المذكورة في القائمة الثابتة observedAttributes.

هذا يعني أنك إذا غيّرت سمة branch بالكود لاحقاً، تتحدث البطاقة وحدها.

المحتوى لا يجب أن يختفي

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

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

مصدر واحد للبيانات

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

التنسيق والاتجاه

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

انتبه لما تضعه في innerHTML

في المثال تأتي القيم من ملفك أنت. لا تضع أبداً بنفس الطريقة نصاً كتبه زائر، كاسم في تقييم أو رسالة، لأن ذلك يفتح باباً لحقن كود في صفحتك. للنصوص القادمة من المستخدمين استخدم textContent أو أنشئ العناصر واحداً واحداً.

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

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

مكوّنات أخرى تستحق الفكرة نفسها

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

مثال توضيحي: مطعم بفرعين

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

أسئلة شائعة

بحتاج React أو إطار عمل عشان أعمل مكوّن يتكرر؟

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

ليش اسم العنصر لازم يكون فيه شرطة؟

لأن المواصفة تشترط ذلك لتمييز العناصر المخصصة عن عناصر HTML الأصلية، حسب وثائق MDN.

هل بتشتغل على الآيفون؟

العناصر المستقلة التي ترث من HTMLElement تعمل. أما توسيع العناصر الموجودة فلا يخطط Safari لدعمه.

شو بصير إذا الكود ما اشتغل عند الزائر؟

يرى ما وضعته داخل الوسم مسبقاً. لذلك ضع الرقم والعنوان كنص احتياطي دائماً.

إذا كانت معلومات فروعك مكررة ومتضاربة بين صفحات موقعك، تواصل معنا ونجمعها في مصدر واحد يحدّث كل الصفحات.

المصادر

WhatsAppاحجز مكالمة