תבנית, יחידת קיבולת (Slot) והצללה

היתרון של רכיבי אינטרנט הוא שאפשר להשתמש בהם שוב: אתם יכולים ליצור ווידג'ט של ממשק משתמש פעם אחת, ולהשתמש בו כמה פעמים. אמנם צריך JavaScript כדי ליצור רכיבי אינטרנט, אבל לא צריך ספריית JavaScript. HTML וממשקי ה-API המשויכים מספקים את כל מה שצריך.

תקן רכיבי האינטרנט מורכב משלושה חלקים: תבניות HTML, רכיבים בהתאמה אישית ו-Shadow DOM. כשמשלבים אותם, אפשר ליצור רכיבים מותאמים אישית, עצמאיים (מכילים) וניתנים לשימוש חוזר, שאפשר לשלב בצורה חלקה באפליקציות קיימות, בדיוק כמו רכיבי ה-HTML האחרים שכבר סקרנו.

בקטע הזה אנחנו יוצרים את הרכיב <star-rating>, רכיב אינטרנט שמאפשר למשתמשים לדרג חוויה בסולם של אחד עד חמישה כוכבים. כשנותנים שם לרכיב מותאם אישית, מומלץ להשתמש רק באותיות קטנות. צריך לכלול מקפים, כי הם עוזרים להבחין בין רכיבים רגילים לרכיבים בהתאמה אישית.

אנחנו מסבירים איך להשתמש ברכיבים <template> ו-<slot>, במאפיין slot וב-JavaScript כדי ליצור תבנית עם Shadow DOM מוכמס. אנחנו משתמשים שוב ברכיב שהוגדר, ומתאימים אישית קטע טקסט, בדיוק כמו כל רכיב או רכיב אינטרנט. אנחנו גם דנים בקצרה בשימוש ב-CSS מתוך הרכיב המותאם אישית ומחוצה לו.

הרכיב <template>

הרכיב <template> משמש להצהרה על קטעי HTML שצריך לשכפל ולהוסיף ל-DOM באמצעות JavaScript. כברירת מחדל, התוכן של הרכיב לא מוצג. במקום זאת, הם נוצרים באמצעות JavaScript.

<template id="star-rating-template">
  <form>
    <fieldset>
      <legend>Rate your experience:</legend>
      <rating>
        <input type="radio" name="rating" value="1" aria-label="1 star" required />
        <input type="radio" name="rating" value="2" aria-label="2 stars" />
        <input type="radio" name="rating" value="3" aria-label="3 stars" />
        <input type="radio" name="rating" value="4" aria-label="4 stars" />
        <input type="radio" name="rating" value="5" aria-label="5 stars" />
      </rating>
    </fieldset>
    <button type="reset">Reset</button>
    <button type="submit">Submit</button>
  </form>
</template>

התוכן של רכיב <template> לא נכתב במסך, ולכן הרכיב <form> והתוכן שלו לא מוצגים. הפלט של ה-CodePen הבא נראה ריק. פותחים את הכרטיסייה HTML כדי לראות את תגי העיצוב של <template>.

בדוגמה הזו, <form> הוא לא צאצא של <template> ב-DOM. במקום זאת, התוכן של רכיבי <template> הם צאצאים של DocumentFragment שמוחזר על ידי המאפיין HTMLTemplateElement.content. כדי להציג את התוכן, צריך להשתמש ב-JavaScript כדי לאחזר את התוכן ולהוסיף אותו ל-DOM.

ה-JavaScript הזה לא יצר רכיב בהתאמה אישית. במקום זאת, בדוגמה הזו התוכן של <template> נוסף ל-<body>. התוכן הפך לחלק מה-DOM הגלוי, שאפשר לעצב אותו.

ה-CodePen כפי שהוא מופיע ב-DOM.

לא ממש שימושי לדרוש JavaScript כדי להטמיע תבנית לדירוג כוכבים אחד, אבל שימושי ליצור רכיב אינטרנט לווידג'ט של דירוג כוכבים שניתן להתאמה אישית ומשתמשים בו שוב ושוב.

הרכיב <slot>

אנחנו כוללים משבצת שבה אפשר להוסיף מקרא מותאם אישית לכל מופע. ב-HTML יש רכיב <slot> שמשמש כפלייסהולדר בתוך <template>. אם נותנים לו שם, הוא יוצר "מיקום בעל שם". אפשר להשתמש ב-named slot כדי להתאים אישית תוכן בתוך רכיב אינטרנט. הרכיב <slot> מאפשר לנו לשלוט במיקום שבו הצאצאים של רכיב מותאם אישית יוכנסו בתוך עץ ה-shadow שלו.

בתבנית שלנו, אנחנו משנים את <legend> ל-<slot>:

<template id="star-rating-template">
  <form>
    <fieldset>
      <slot name="star-rating-legend">
        <legend>Rate your experience:</legend>
      </slot>

המאפיין name משמש להקצאת מיקומים לרכיבים אחרים אם לרכיב יש מאפיין slot שהערך שלו תואם לשם של מיקום בעל שם. אם לרכיב המותאם אישית אין התאמה למיקום, התוכן של <slot> מוצג. לכן כללנו <legend> עם תוכן כללי שאפשר להציג כשמישהו מוסיף <star-rating></star-rating>, בלי תוכן, ב-HTML שלו.

<star-rating>
  <legend slot="star-rating-legend">Blendan Smooth</legend>
</star-rating>
<star-rating>
  <legend slot="star-rating-legend">Hoover Sukhdeep</legend>
</star-rating>
<star-rating>
  <legend slot="star-rating-legend">Toasty McToastface</legend>
  <p>Is this text visible?</p>
</star-rating>

המאפיין slot הוא מאפיין גלובלי שמשמש להחלפת התוכן של <slot> בתוך <template>. ברכיב המותאם אישית שלנו, הרכיב עם מאפיין המשבצת הוא <legend>. לא צריך. בתבנית שלנו, <slot name="star-rating-legend"> מוחלף ב-<anyElement slot="star-rating-legend">, כאשר <anyElement> יכול להיות כל רכיב, אפילו רכיב מותאם אישית אחר.

רכיבים לא מוגדרים

ב-<template> שלנו, השתמשנו ברכיב <rating>. זה לא רכיב בהתאמה אישית. במקום זאת, זהו רכיב לא ידוע. הדפדפנים לא נכשלים כשהם לא מזהים רכיב. הדפדפן מתייחס לרכיבי HTML לא מזוהים כרכיבים אנונימיים בתוך השורה, שאפשר לעצב אותם באמצעות CSS. בדומה ל-<span>, לרכיבים <rating> ו-<star-rating> אין סגנונות או סמנטיקה שמוחלים על ידי סוכן המשתמש.

ב-CodePen הזה, ה-<template> והתוכן לא מוצגים. הרכיב <template> הוא רכיב מוכר שמכיל תוכן שלא צריך לעבד. הרכיב <star-rating> עדיין לא הוגדר. עד שנגדיר רכיב, הדפדפן יציג אותו כמו כל הרכיבים הלא מזוהים. בינתיים, הרכיב הלא מזוהה <star-rating> מטופל כרכיב אנונימי בתוך השורה, כך שהתוכן, כולל המקראות והרכיב <p> ברכיב <star-rating> השלישי, מוצגים כאילו הם נמצאים ב-<span>.

כדי להמיר את הרכיב הלא מזוהה הזה לרכיב מותאם אישית, נגדיר את הרכיב שלנו.

רכיבים בהתאמה אישית

כדי להגדיר רכיבים מותאמים אישית, צריך להשתמש ב-JavaScript. כשהוא מוגדר, התוכן של הרכיב <star-rating> מוחלף ב-shadow root שמכיל את כל התוכן של התבנית שמשויכת אליו. הרכיבים <slot> מהתבנית מוחלפים בתוכן של הרכיב בתוך <star-rating>, שערך המאפיין slot שלו תואם לערך השם של <slot>, אם יש כזה. אם לא, מוצג התוכן של משבצות התבנית.

תוכן בתוך רכיב מותאם אישית שלא משויך למיקום – ה-<p>Is this text visible?</p> ב-<star-rating> השלישי שלנו – לא נכלל ב-shadow root ולכן לא מוצג.

אנחנו מגדירים את הרכיב המותאם אישית בשם star-rating על ידי הרחבת HTMLElement:

customElements.define('star-rating',
  class extends HTMLElement {
    constructor() {
      super(); // Always call super first in constructor
      const starRating = document.getElementById('star-rating-template').content;
      const shadowRoot = this.attachShadow({
        mode: 'open'
      });
      shadowRoot.appendChild(starRating.cloneNode(true));
    }
  });

עכשיו, כשהרכיב מוגדר, בכל פעם שהדפדפן נתקל ברכיב <star-rating>, הרכיב מוצג כפי שהוגדר על ידי הרכיב עם ה-#star-rating-template, שהוא התבנית שלנו. הדפדפן מצרף עץ shadow DOM לצומת, ומוסיף עותק של תוכן התבנית ל-shadow DOM הזה.

const shadowRoot = this.attachShadow({mode: 'open'});
shadowRoot.appendChild(starRating.cloneNode(true));

אם תסתכלו על הכלים למפתחים, תראו שה-<form> מה-<template> הוא חלק מה-shadow root של כל רכיב מותאם אישית. עותק של התוכן של <template> מופיע בכל רכיב בהתאמה אישית בכלי למפתחים וגלוי בדפדפן, אבל התוכן של הרכיב בהתאמה אישית עצמו לא מוצג במסך.

צילום מסך של כלי הפיתוח שמציג את תוכן התבנית המשוכפלת בכל רכיב מותאם אישית.

בדוגמה של <template>, הוספנו את תוכן התבנית לגוף המסמך, והוספנו את התוכן ל-DOM הרגיל. בהגדרה של customElements, השתמשנו באותו appendChild(), אבל התוכן של התבנית המשוכפלת נוסף ל-shadow DOM מובנה.

שמתם לב שהכוכבים חזרו להיות כפתורי בחירה לא מעוצבים? הוא חלק מ-shadow DOM ולא מה-DOM הרגיל, ולכן העיצוב בכרטיסייה CSS של CodePen לא חל. סגנונות ה-CSS של הכרטיסייה הזו מוגדרים למסמך, ולא ל-shadow DOM, ולכן הסגנונות לא מוחלים. אנחנו צריכים ליצור סגנונות מוכמסים כדי לעצב את תוכן ה-Shadow DOM המוכמס שלנו.

Shadow DOM

ה-Shadow DOM מגדיר את היקף הסגנונות של CSS לכל עץ צל, ומבודד אותו משאר המסמך. כלומר, CSS חיצוני לא חל על הרכיב, והסגנונות של הרכיב לא משפיעים על שאר המסמך, אלא אם אנחנו מכוונים אותם לכך באופן מכוון.

מכיוון שהוספנו את התוכן ל-shadow DOM, אנחנו יכולים לכלול רכיב <style> שמספק CSS מוכלל לרכיב המותאם אישית.

מכיוון שהסגנון הזה מוגדר לרכיב המותאם אישית, אנחנו לא צריכים לדאוג שהסגנונות יזלגו לשאר המסמך. אנחנו יכולים לצמצם באופן משמעותי את הספציפיות של הסלקטורים. לדוגמה, מכיוון שהקלט היחיד שמשמש ברכיב המותאם אישית הוא כפתורי בחירה, אפשר להשתמש ב-input במקום ב-input[type="radio"] כבורר.

 <template id="star-rating-template">
  <style>
    rating {
      display: inline-flex;
    }
    input {
      appearance: none;
      margin: 0;
      box-shadow: none;
    }
    input::after {
      content: '\2605'; /* solid star */
      font-size: 32px;
    }
    rating:hover input:invalid::after,
    rating:focus-within input:invalid::after {
      color: #888;
    }
    input:invalid::after,
      rating:hover input:hover ~ input:invalid::after,
      input:focus ~ input:invalid::after  {
      color: #ddd;
    }
    input:valid {
      color: orange;
    }
    input:checked ~ input:not(:checked)::after {
      color: #ccc;
      content: '\2606'; /* hollow star */
    }
  </style>
  <form>
    <fieldset>
      <slot name="star-rating-legend">
        <legend>Rate your experience:</legend>
      </slot>
      <rating>
        <input type="radio" name="rating" value="1" aria-label="1 star" required/>
        <input type="radio" name="rating" value="2" aria-label="2 stars"/>
        <input type="radio" name="rating" value="3" aria-label="3 stars"/>
        <input type="radio" name="rating" value="4" aria-label="4 stars"/>
        <input type="radio" name="rating" value="5" aria-label="5 stars"/>
      </rating>
    </fieldset>
    <button type="reset">Reset</button>
    <button type="submit">Submit</button>
  </form>
</template>

רכיבי אינטרנט מוקפים בתגי עיצוב של <template>, וסגנונות CSS מוגדרים ל-shadow DOM ומוסתרים מכל מה שמחוץ לרכיבים. לעומת זאת, תוכן המשבצת שעובר עיבוד, החלק של <anyElement slot="star-rating-legend"> ב-<star-rating>, לא מוקף בתגי עיצוב.

עיצוב מחוץ להיקף הנוכחי

אפשר לעצב את המסמך מתוך shadow DOM ולעצב את התוכן של shadow DOM מהסגנונות הגלובליים, אבל זה לא פשוט. אפשר לחצות את גבול הצל, שבו ה-shadow DOM מסתיים וה-DOM הרגיל מתחיל, אבל רק באופן מכוון מאוד.

עץ ה-shadow הוא עץ ה-DOM בתוך ה-shadow DOM. שורש הצל הוא צומת הבסיס של עץ הצל.

הפסאודו-מחלקה :host בוחרת את <star-rating>, רכיב המארח של ה-shadow DOM. המארח של ה-shadow הוא צומת ה-DOM שאליו מצורף ה-shadow DOM. כדי לטרגט רק גרסאות ספציפיות של המארח, משתמשים ב-:host(). האפשרות הזו בוחרת רק את רכיבי המארח של ה-shadow DOM שתואמים לפרמטר שהועבר, כמו סלקטור של מחלקה או מאפיין. כדי לבחור את כל הרכיבים בהתאמה אישית, אפשר להשתמש ב-star-rating { /* styles */ } ב-CSS הגלובלי או ב-:host(:not(#nonExistantId)) בסגנונות התבנית. מבחינת ספציפיות, ה-CSS הגלובלי מנצח.

הרכיב המדומה ::slotted() חוצה את הגבול של ה-shadow DOM מתוך ה-shadow DOM. הוא בוחר רכיב עם משבצת אם הוא תואם לסלקטור. בדוגמה שלנו, ::slotted(legend) תואם לשלושת המקראות.

כדי לטרגט עץ DOM מוסתר מ-CSS בהיקף הגלובלי, צריך לערוך את התבנית. אפשר להוסיף את המאפיין part לכל רכיב שרוצים לעצב. אחר כך משתמשים ברכיב המדומה ::part() כדי להתאים רכיבים בתוך עץ צל שמתאימים לפרמטר שהועבר. הרכיב המקורי או העוגן של הרכיב המדומה הוא המארח, או שם הרכיב בהתאמה אישית, במקרה הזה star-rating. הפרמטר הוא הערך של המאפיין part.

אם תגי העיצוב של התבנית שלנו התחילו כך:

<template id="star-rating-template">
  <form part="formPart">
    <fieldset part="fieldsetPart">

אנחנו יכולים לטרגט את <form> ו-<fieldset> באמצעות:

star-rating::part(formPart) { /* styles */ }
star-rating::part(fieldsetPart) { /* styles */ }

שמות של חלקים פועלים באופן דומה למחלקות: לרכיב יכולים להיות כמה שמות של חלקים שמופרדים ברווחים, ולכמה רכיבים יכול להיות אותו שם של חלק.

ל-Google יש רשימת משימות מצוינת ליצירת רכיבים מותאמים אישית. כדאי גם לקרוא על עצי DOM הצהרתיים של Shadow.

בדיקה של רמת ההבנה שלך

בדקו את הידע שלכם בנושאים template,‏ slot ו-shadow.

כברירת מחדל, סגנונות מחוץ ל-shadow DOM מעצבים רכיבים בפנים.

True.
אפשר לנסות שוב.
לא נכון.
תשובה נכונה!

איזו תשובה מתארת נכון את הרכיב <template>?

רכיב כללי שמשמש להצגת כל תוכן בדף.
אפשר לנסות שוב.
רכיב פלייסהולדר.
אפשר לנסות שוב.
רכיב שמשמש להצהרה על קטעי HTML, שלא יעובדו כברירת מחדל.
תשובה נכונה!