مقدمة
"مكوّنات الويب" هي مجموعة من المعايير المتطوّرة التي:
- إتاحة إنشاء تطبيقات مصغّرة
- …يمكن إعادة استخدامها بشكل موثوق
- …ولن تؤدي إلى تعطُّل الصفحات إذا غيّر الإصدار التالي من المكوّن تفاصيل طريقة التنفيذ الداخلية.
هل يعني ذلك أنّه عليك تحديد متى تستخدم HTML/JavaScript ومتى تستخدم Web Components؟ لا يمكن أن تجعل HTML وJavaScript الأشياء المرئية التفاعلية. التطبيقات المصغّرة هي عناصر مرئية تفاعلية. من المنطقي الاستفادة من مهاراتك في HTML وJavaScript عند تطوير تطبيق مصغّر. تم تصميم معايير مكوّنات الويب لمساعدتك في ذلك.
ولكن هناك مشكلة أساسية تجعل من الصعب استخدام التطبيقات المصغّرة التي تم إنشاؤها باستخدام HTML وJavaScript، وهي أنّ شجرة نموذج العناصر في المستند (DOM) داخل التطبيق المصغّر ليست معزولة عن بقية الصفحة. يعني عدم التغليف هذا أنّ ورقة أنماط المستند قد تنطبق عن طريق الخطأ على أجزاء داخل التطبيق المصغّر، وقد يعدّل JavaScript عن طريق الخطأ أجزاء داخل التطبيق المصغّر، وقد تتداخل المعرّفات مع المعرّفات داخل التطبيق المصغّر، وما إلى ذلك.
تتألف مكوّنات الويب من ثلاثة أجزاء:
يعالج Shadow DOM مشكلة تغليف شجرة نموذج العناصر في المستند. تم تصميم الأجزاء الأربعة من مكونات الويب لتعمل معًا، ولكن يمكنك أيضًا اختيار الأجزاء التي تريد استخدامها من مكونات الويب. يوضّح لك هذا البرنامج التعليمي كيفية استخدام Shadow DOM.
مرحبًا بكم في عالم الظلال
باستخدام Shadow DOM، يمكن أن تحصل العناصر على نوع جديد من العُقد المرتبطة بها. يُطلق على هذا النوع الجديد من العُقد اسم جذر الظل. يُطلق على العنصر الذي يحتوي على جذر ظل مرتبط به اسم مضيف الظل. لا يتم عرض محتوى مضيف الظل، بل يتم عرض محتوى جذر الظل بدلاً منه.
على سبيل المثال، إذا كان لديك ترميز مثل:
<button>Hello, world!</button>
<script>
var host = document.querySelector('button');
var root = host.createShadowRoot();
root.textContent = 'こんにちは、影の世界!';
</script>
بدلاً من
<button id="ex1a">Hello, world!</button>
<script>
function remove(selector) {
Array.prototype.forEach.call(
document.querySelectorAll(selector),
function (node) { node.parentNode.removeChild(node); });
}
if (!HTMLElement.prototype.createShadowRoot) {
remove('#ex1a');
document.write('<img src="SS1.png" alt="Screenshot of a button with \'Hello, world!\' on it.">');
}
</script>
كيف تبدو صفحتك
<button id="ex1b">Hello, world!</button>
<script>
(function () {
if (!HTMLElement.prototype.createShadowRoot) {
remove('#ex1b');
document.write('<img src="SS2.png" alt="Screenshot of a button with \'Hello, shadow world!\' in Japanese on it.">');
return;
}
var host = document.querySelector('#ex1b');
var root = host.createShadowRoot();
root.textContent = 'こんにちは、影の世界!';
})();
</script>
بالإضافة إلى ذلك، إذا سأل JavaScript في الصفحة عن قيمة textContent للزر، لن يحصل على "こんにちは、影の世界!"، بل على "Hello, world!" لأنّ الشجرة الفرعية لنموذج DOM ضمن جذر الظل تكون مغلَّفة.
فصل المحتوى عن العرض التقديمي
سنلقي الآن نظرة على استخدام Shadow DOM لفصل المحتوى عن العرض التقديمي. لنفترض أنّ لدينا هذه البطاقة التعريفية:
<style>
.ex2a.outer {
border: 2px solid brown;
border-radius: 1em;
background: red;
font-size: 20pt;
width: 12em;
height: 7em;
text-align: center;
}
.ex2a .boilerplate {
color: white;
font-family: sans-serif;
padding: 0.5em;
}
.ex2a .name {
color: black;
background: white;
font-family: "Marker Felt", cursive;
font-size: 45pt;
padding-top: 0.2em;
}
</style>
<div class="ex2a outer">
<div class="boilerplate">
Hi! My name is
</div>
<div class="name">
Bob
</div>
</div>
في ما يلي الترميز. هذا ما ستكتبه اليوم. لا تستخدم Shadow DOM:
<style>
.outer {
border: 2px solid brown;
border-radius: 1em;
background: red;
font-size: 20pt;
width: 12em;
height: 7em;
text-align: center;
}
.boilerplate {
color: white;
font-family: sans-serif;
padding: 0.5em;
}
.name {
color: black;
background: white;
font-family: "Marker Felt", cursive;
font-size: 45pt;
padding-top: 0.2em;
}
</style>
<div class="outer">
<div class="boilerplate">
Hi! My name is
</div>
<div class="name">
Bob
</div>
</div>
نظرًا لأن شجرة نموذج العناصر في المستند تفتقر إلى التغليف، فإن البنية الكاملة لبطاقة التعريفية يتم كشفها للمستند. إذا كانت العناصر الأخرى في الصفحة تستخدم عن طريق الخطأ أسماء الفئات نفسها للتصميم أو البرمجة، فسنواجه مشكلة.
يمكننا تجنُّب قضاء وقت سيئ.
الخطوة 1: إخفاء تفاصيل العرض التقديمي
من الناحية الدلالية، ربما نهتم فقط بما يلي:
- إنّها بطاقة تعريفية.
- الاسم هو "Bob".
أولاً، نكتب ترميزًا أقرب إلى الدلالات الحقيقية التي نريدها:
<div id="nameTag">Bob</div>
بعد ذلك، نضع جميع الأنماط وعناصر div المستخدَمة للعرض التقديمي في عنصر <template>:
<div id="nameTag">Bob</div>
<template id="nameTagTemplate">
<span class="unchanged"><style>
.outer {
border: 2px solid brown;
… same as above …
</style>
<div class="outer">
<div class="boilerplate">
Hi! My name is
</div>
<div class="name">
Bob
</div>
</div></span>
</template>
في هذه المرحلة، يكون "Bob" هو الشيء الوحيد الذي يتم عرضه. بما أنّنا نقلنا عناصر DOM الخاصة بالعرض إلى داخل عنصر <template>، لن يتم عرضها، ولكن يمكن الوصول إليها من JavaScript. سنفعل ذلك الآن لملء جذر الظل:
<script>
var shadow = document.querySelector('#nameTag').createShadowRoot();
var template = document.querySelector('#nameTagTemplate');
var clone = document.importNode(template.content, true);
shadow.appendChild(clone);
بعد أن أعددنا جذر الظل، يتم عرض البطاقة التعريفية مرة أخرى. إذا نقرت بزر الماوس الأيمن على البطاقة التعريفية وفحصت العنصر، ستظهر لك علامات دلالية رائعة:
<div id="nameTag">Bob</div>
يوضح هذا أنه باستخدام Shadow DOM، قمنا بإخفاء تفاصيل العرض لبطاقة التعريف من المستند. يتم تضمين تفاصيل العرض التقديمي في Shadow DOM.
الخطوة 2: فصل المحتوى عن العرض التقديمي
تخفي بطاقة التعريف الآن تفاصيل العرض من الصفحة، ولكنها لا تفصل العرض عن المحتوى فعليًا، لأنه على الرغم من أن المحتوى (الاسم "Bob") موجود في الصفحة، فإن الاسم الذي يتم عرضه هو الاسم الذي قمنا بنسخه في جذر الظل. إذا أردنا تغيير الاسم على بطاقة التعريف، سنحتاج إلى إجراء ذلك في مكانين، وقد لا تتم مزامنتهما.
عناصر HTML تركيبية، فيمكنك وضع زر داخل جدول، على سبيل المثال. التكوين هو ما نحتاجه هنا: يجب أن تكون بطاقة تعريفية عبارة عن تركيب من الخلفية الحمراء، والنص "مرحبًا!"، والمحتوى الموجود على بطاقة تعريفية.
أنت، مؤلف المكوّن، تحدد كيفية عمل التركيب مع
عنصر واجهة المستخدم باستخدام عنصر جديد يسمى <content>. يؤدي ذلك إلى إنشاء نقطة إدراج في عرض التطبيق المصغّر، وتختار نقطة الإدراج المحتوى من المضيف الظل لعرضه في تلك النقطة.
إذا غيّرنا الترميز في Shadow DOM إلى ما يلي:
<span class="unchanged"><template id="nameTagTemplate">
<style>
…
</style></span>
<div class="outer">
<div class="boilerplate">
Hi! My name is
</div>
<div class="name">
<content></content>
</div>
</div>
<span class="unchanged"></template></span>
عند عرض بطاقة تعريفية، يتم عرض محتوى المضيف المخفي في المكان الذي يظهر فيه العنصر <content>.
أصبحت بنية المستند الآن أبسط لأنّ الاسم موجود في مكان واحد فقط، وهو المستند. إذا احتاجت صفحتك في أي وقت إلى تحديث اسم المستخدم، فما عليك سوى كتابة:
document.querySelector('#nameTag').textContent = 'Shellie';
وهذا كل ما في الأمر. يتم تحديث عرض البطاقة التعريفية تلقائيًا بواسطة المتصفح، لأننا نعرض محتوى البطاقة التعريفية في مكانها باستخدام <content>.
<div id="ex2b">
الآن حققنا الفصل بين المحتوى والعرض التقديمي. يكون المحتوى في المستند، ويكون العرض في Shadow DOM. ويتم الاحتفاظ بها تلقائيًا في المزامنة بواسطة المتصفح عندما يحين الوقت لتقديم شيء ما.
الخطوة 3: الربح
من خلال فصل المحتوى عن العرض، يمكننا تبسيط الرمز البرمجي الذي يعالج المحتوى. في مثال البطاقة التعريفية، يحتاج هذا الرمز البرمجي فقط إلى التعامل مع بنية بسيطة تحتوي على عنصر <div> واحد بدلاً من عدة عناصر.
الآن، إذا غيّرنا طريقة العرض، لن نحتاج إلى تغيير أي من الرموز البرمجية.
على سبيل المثال، لنفترض أنّنا نريد أقلمة بطاقة تعريفية. لا يزال علامة اسم، لذا لا يتغير المحتوى الدلالي في المستند:
<div id="nameTag">Bob</div>
يبقى رمز إعداد جذر الظل كما هو. ما يتم وضعه في جذر الظل يتغير:
<template id="nameTagTemplate">
<style>
.outer {
border: 2px solid pink;
border-radius: 1em;
background: url(sakura.jpg);
font-size: 20pt;
width: 12em;
height: 7em;
text-align: center;
font-family: sans-serif;
font-weight: bold;
}
.name {
font-size: 45pt;
font-weight: normal;
margin-top: 0.8em;
padding-top: 0.2em;
}
</style>
<div class="outer">
<div class="name">
<content></content>
</div>
と申します。
</div>
</template>
هذا تحسُّن كبير مقارنةً بالوضع الحالي على الويب، لأنّ رمز تعديل الاسم يمكن أن يعتمد على بنية المكوّن، وهي بسيطة ومتسقة. لا يحتاج رمز تعديل الاسم إلى معرفة البنية المستخدمة للعرض. إذا نظرنا إلى ما يتم عرضه، يظهر الاسم ثانيًا باللغة الإنجليزية (بعد "مرحبًا! My name is")، ولكن أولاً باللغة اليابانية (قبل "と申します"). هذا التمييز لا معنى له من الناحية الدلالية من وجهة نظر تحديث الاسم الذي يتم عرضه، لذلك لا يحتاج رمز تحديث الاسم إلى معرفة هذه التفاصيل.
مهمة إضافية: الإسقاط المتقدم
في المثال أعلاه، يختار العنصر <content> كل المحتوى من مضيف الظل. باستخدام السمة select، يمكنك التحكّم في ما يعرضه عنصر المحتوى. يمكنك أيضًا استخدام عناصر
محتوى متعددة.
على سبيل المثال، إذا كان لديك مستند يحتوي على ما يلي:
<div id="nameTag">
<div class="first">Bob</div>
<div>B. Love</div>
<div class="email">bob@</div>
</div>
وجذر ظل يستخدم أدوات اختيار لغة CSS لاختيار محتوى معيّن:
<div style="background: purple; padding: 1em;">
<div style="color: red;">
<content **select=".first"**></content>
</div>
<div style="color: yellow;">
<content **select="div"**></content>
</div>
<div style="color: blue;">
<content **select=".email">**</content>
</div>
</div>
يتطابق العنصر <div class="email"> مع كل من العنصرين <content select="div"> و<content
select=".email">. كم مرة يظهر عنوان البريد الإلكتروني
لبوب، وبأي ألوان؟
الإجابة هي أن عنوان البريد الإلكتروني الخاص بـ Bob يظهر مرة واحدة، وهو باللون الأصفر.
والسبب هو أنّ الأشخاص الذين يطوّرون Shadow DOM يعرفون أنّ إنشاء شجرة ما يتم عرضه فعليًا على الشاشة يشبه حفلة ضخمة. عنصر المحتوى هو الدعوة التي تسمح
للمحتوى من المستند بالدخول إلى حفلة عرض Shadow DOM
في الكواليس. يتم إرسال هذه الدعوات بالترتيب، ويعتمد تحديد من يتلقّى الدعوة على الشخص الذي تم توجيهها إليه (أي السمة select). بمجرد دعوة المحتوى، فإنه يقبل الدعوة دائمًا (من لا يقبل؟!) وينطلق. إذا تم إرسال دعوة لاحقة إلى هذا العنوان مرة أخرى،
فلن يكون هناك أحد في المنزل، ولن تأتي إلى حفلتك.
في المثال أعلاه، يتطابق <div class="email"> مع كل من أداة الاختيار div وأداة الاختيار .email، ولكن لأنّ عنصر المحتوى الذي يتضمّن أداة الاختيار div يظهر في وقت سابق في المستند، يذهب <div class="email"> إلى الحفلة الصفراء، ولا يتوفّر أي شخص للحضور إلى الحفلة الزرقاء. (قد يكون هذا سبب كونه حزينًا جدًا، على الرغم من أنّ المصائب تجمع، لذا لا يمكن معرفة ذلك).
إذا لم تتم دعوة عنصر إلى أي حفلة، لن يتم عرضه على الإطلاق. هذا ما حدث للنص "Hello, world" في المثال الأول. ويكون ذلك مفيدًا عندما تريد تحقيق عرض مختلف جذريًا: اكتب النموذج الدلالي في المستند، وهو ما يمكن الوصول إليه من خلال النصوص البرمجية في الصفحة، ولكن يمكنك إخفاؤه لأغراض العرض وربطه بنموذج عرض مختلف تمامًا في Shadow DOM باستخدام JavaScript.
على سبيل المثال، تحتوي لغة HTML على أداة اختيار تاريخ جيدة. إذا كتبت <input
type="date">، سيظهر لك تقويم منبثق منظّم. ولكن ماذا لو أردت السماح للمستخدم باختيار نطاق من التواريخ لعطلته في جزيرة الحلويات (مثلاً… مع أراجيح شبكية مصنوعة من حلوى Red Vines)؟ يمكنك إعداد المستند على النحو التالي:
<div class="dateRangePicker">
<label for="start">Start:</label>
<input type="date" name="startDate" id="start">
<br>
<label for="end">End:</label>
<input type="date" name="endDate" id="end">
</div>
بل تنشئ Shadow DOM يستخدم جدولاً لإنشاء تقويم أنيق يبرز نطاق التواريخ وما إلى ذلك. عندما ينقر المستخدم على الأيام في التقويم، يحدّث المكوّن الحالة في حقلَي startDate وendDate. وعندما يرسل المستخدم النموذج، يتم إرسال القيم من عناصر الإدخال هذه.
لماذا قمت بتضمين تسميات في المستند إذا لم يتم عرضها؟ والسبب في ذلك هو أنه إذا شاهد المستخدم النموذج باستخدام متصفح لا يدعم Shadow DOM، فسيظل النموذج قابلاً للاستخدام، ولكنه ليس جميلاً. يرى المستخدم شيئًا مثل:
<div class="dateRangePicker">
<label for="start">Start:</label>
<input type="date" name="startDate" id="start">
<br>
<label for="end">End:</label>
<input type="date" name="endDate" id="end">
</div>
لقد اجتزت اختبار Shadow DOM 101
لقد تعرّفت للتو على أساسيات Shadow DOM. يمكنك القيام بالمزيد باستخدام Shadow DOM، على سبيل المثال، يمكنك استخدام عدة ظلال على مضيف ظل واحد، أو ظلال متداخلة للتغليف، أو تصميم صفحتك باستخدام طرق العرض المستندة إلى النموذج (MDV) وShadow DOM. ومكوّنات الويب هي أكثر من مجرد Shadow DOM.
وسنشرح ذلك في منشورات لاحقة.