Nando Muñoz

المدونةالكود والإدارة

تعلّم Web Components

ما هي Web Components؟ Web Components مجموعة من تقنيات الويب القياسية تتيح إنشاء عناصر مخصّصة قابلة لإعادة الاستخدام، لكلٍّ منها بنيته وأسلوبه ووظيفته، مغلّفة بالكامل ومعزولة…

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

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

ما هي Web Components؟

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

بحسب توثيق MDN:

«مكوّنات الويب حزمة من التقنيات المختلفة تتيح لك إنشاء عناصر مخصّصة قابلة لإعادة الاستخدام — مع وظائفها المغلّفة بمعزل عن بقية الشيفرة — واستخدامها في تطبيقات الويب.»

تقوم Web Components أساسًا على ثلاث تقنيات رئيسية:

  1. Custom Elements: تتيح لنا تعريف عناصر HTML خاصة بنا بسلوك مخصّص.
  2. Shadow DOM: يوفّر تغليفًا حقيقيًا لـ DOM، يمنع تضارب الأنماط ويُبقي الشيفرة نمطية بحقّ.
  3. HTML Templates: تتيح تعريف بُنى من الترميز يمكن إعادة استخدامها واستنساخها دون الحاجة إلى إعادة رسم مكلفة.

خطوات إنشاء Web Component دون أطر عمل، باستخدام vanilla JS

1. استخدام معيار وحدات JavaScript (JS Modules)

وحدات JavaScript ميزة أصلية تتيح تقسيم الشيفرة إلى ملفات منفصلة، لكلٍّ منها نطاقه الخاص، مما يسهّل إعادة استخدامها وصيانتها.

بحسب توثيق MDN:

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

البنية الأساسية للوحدة:

  • تعريف الوحدة من ملف HTML: <script type="module" src="js/wcicon.js"></script>
  • تعريف شيفرة الوحدة مباشرة في ملف .js: // Ejemplo: module.js export function saludar() { console.log("Hola desde un módulo!"); } ثم، في ملف JS آخر أو في HTML: import { saludar } from './module.js'; saludar(); // "Hola desde un módulo!"

2. البنية الأساسية لـ Web Component

في البداية، تكتفي كثير من الشروحات بعرض «Hello World» داخل مكوّن. أما هنا فسنذهب خطوة أبعد: لنفترض أننا نحتاج إلى مكوّن مخصّص يعرض أيقونة معيّنة بحسب سمة. مثلًا، أيقونة Twitter:

<wc-icon typeicon="twitter"></wc-icon>

قواعد عند إنشاء Custom Element (Web Component):

  • يجب أن يحتوي اسم الوسم المخصّص على شرطة (-). مثلًا: <wc-icon> يلتزم بهذه القاعدة. وهذا يمنع التعارض مع عناصر HTML الأصلية.
  • يمكنك إضافة ما تحتاجه من السمات: <wc-icon typeicon="twitter" size="large"></wc-icon>.

استدعاء Web Component كوحدة:

في ملف HTML الذي يُستخدم فيه المكوّن، يجب أن نستورد ملف المكوّن كوحدة ES6:

<script type="module" src="js/wcicon.js"></script>

البنية الأساسية في JavaScript:

// wcicon.js

class WcIcon extends HTMLElement {
  constructor() {
    super();
    // Definir atributos por defecto
    this.typeicon = "default";
  }

  // Lista de atributos a observar
  static get observedAttributes() {
    return ["typeicon"];
  }

  // Se dispara cuando el elemento es insertado en el DOM
  connectedCallback() {
    this.render();
  }

  // Se dispara cuando el elemento es removido del DOM
  disconnectedCallback() {
    // Aquí podrías limpiar listeners u otros recursos
  }

  // Se dispara cuando alguno de los atributos en observedAttributes cambia
  attributeChangedCallback(name, oldValue, newValue) {
    if (name === "typeicon") {
      this.typeicon = newValue;
      this.render();
    }
  }

  // Método para actualizar la representación del componente
  render() {
    this.innerHTML = `
      <span class="icon-${this.typeicon}">[icono: ${this.typeicon}]</span>
    `;
  }
}

// Definir el elemento personalizado
window.customElements.define("wc-icon", WcIcon);

// Exportar la clase (opcional, pero recomendable para organización del código)
export default WcIcon;

ملاحظة: ليس إلزاميًا استخدام JS Modules مع Web Components، لكنه ممارسة جيدة لأنه يسهّل تنظيم المشروع وقابليته للتوسّع.

3. الإجراءات الداخلية الخاصة بـ Web Component

داخل constructor والدوال الأصلية، ندير خصائص المكوّن ودورة حياته.

  • Constructor: هنا نهيّئ الخصائص وننشئ Shadow DOM إن احتجنا إليه. مثلًا: constructor() { super(); this.typeicon = "default"; }
  • إدارة السمات والتعامل معها: يمكن أن تتغيّر سمات مثل typeicon. وعندما يحدث ذلك، تتيح لنا attributeChangedCallback الاستجابة لهذه التغييرات. مثال: attributeChangedCallback(attr, oldValue, newValue) { if (attr === "typeicon") { this.typeicon = newValue; this.render(); } }
  • connectedCallback(): تُنفَّذ عند إضافة العنصر إلى DOM.
  • disconnectedCallback(): تُنفَّذ عند إزالة العنصر من DOM.
  • observedAttributes(): هي getter من نوع static تُرجع قائمة السمات التي نريد مراقبتها. في حالتنا: static get observedAttributes() { return ["typeicon"]; }

تتيح لنا هذه الدوال بناء مكوّنات ديناميكية، والتفاعل مع التغييرات، والحفاظ على شيفرة مرتّبة ومتّسقة.

ما هو Shadow DOM؟

Shadow DOM جزء أساسي من Web Components. يتيح لنا تغليف الترميز والنمط والوظيفة الخاصة بالمكوّن، بحيث لا تؤثر CSS و JavaScript الخاصتان بالبيئة التي يُستخدم فيها المكوّن على داخله، والعكس صحيح.

  • التعريف:
    ينشئ Shadow DOM شجرة DOM مغلّفة مرتبطة بعنصر ما، لا تتأثر بالنمط أو السكربت العام للصفحة. وهذا يضمن أن يكون المكوّن نمطيًا بحقّ.
  • ما فائدته؟:
    يفيد في تجنّب تعارض أسماء الـ class، وأنماط CSS العامة التي تطغى على المظهر الداخلي للمكوّن، أو السلوكيات غير المرغوب فيها. وهذا يجعل صيانة المكوّن وإعادة استخدامه أسهل.
  • كيف نطبّقه؟:
    داخل constructor الخاص بـ Custom Element، يمكننا إرفاق shadow root بالعنصر: constructor() { super(); // Creamos un shadow root en modo 'open' this.attachShadow({ mode: 'open' }); this.shadowRoot.innerHTML = ` <style> .icon { color: #1da1f2; /* Ejemplo: color Twitter */ font-size: 24px; } </style> <span class="icon">[icon]</span> `; }

بهذا تُغلَّف <span class="icon"> وأنماطها داخل shadow root، فيُتجنَّب التعارض مع بقية الصفحة.

4. LitElement: أسهل طريقة لإنشاء Web Components دون أن تموت في المحاولة

مع أن إنشاء Web Components باستخدام vanilla JS ممكن تمامًا، فقد طوّر المجتمع مكتبات لتبسيط العملية. ومن أشهرها LitElement (من عائلة Lit)، التي تتيح:

  • تعريف المكوّنات بشيفرة «boilerplate» أقل.
  • استخدام قوالب مبنية على `template literals` لتوليد DOM.
  • التفاعل تلقائيًا مع تغيّرات خصائص المكوّن.
  • دمج shadow DOM دون احتكاك.

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

ما فائدته؟:
يجعل LitElement إنشاء Custom Element أسرع، بشيفرة متكرّرة أقل، ويسهّل إدارة الخصائص التفاعلية والأنماط ودوال دورة حياة المكوّن.

كيف نطبّقه؟:
مثال أساسي باستخدام LitElement:

import { LitElement, html, css } from 'lit';

class MyIcon extends LitElement {
  static properties = {
    typeicon: { type: String },
  };

  static styles = css`
    .icon {
      font-size: 24px;
      color: #1da1f2;
    }
  `;

  constructor() {
    super();
    this.typeicon = 'default';
  }

  render() {
    return html`
      <span class="icon">[Icono: ${this.typeicon}]</span>
    `;
  }
}

customElements.define('my-icon', MyIcon);

مع LitElement تصبح الشيفرة أكثر إيجازًا وأكثر تصريحية، مما يسرّع تطوير مكوّنات تزداد تعقيدًا. العيب الوحيد أن Google (الشركة التي أنشأت المكتبة) تهملها قليلًا في الآونة الأخيرة. ومع ذلك، استخدامها موصى به بنسبة 100 %، وإن كنت ستنشئ مشروعًا كبيرًا، فما أجمل أن تبني أدواتك الخاصة على المعايير باستخدام JS كما اعتدنا عليها منذ زمن 😀

الخلاصة

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

بقلم

Nando Muñoz

قائد تقني للواجهات الأمامية · AEM و EDS و SFCC · قادس · مدريد