ประโยชน์ของคอมโพเนนต์เว็บคือความสามารถในการนำกลับมาใช้ใหม่ได้ กล่าวคือ คุณสามารถสร้างวิดเจ็ต UI เพียงครั้งเดียวและนำกลับมาใช้ซ้ำได้หลายครั้ง แม้ว่าคุณจะต้องใช้ JavaScript เพื่อสร้างคอมโพเนนต์เว็บ แต่คุณไม่จำเป็นต้องใช้ไลบรารี JavaScript HTML และ API ที่เกี่ยวข้อง มีทุกสิ่งที่คุณต้องการ
มาตรฐานคอมโพเนนต์เว็บประกอบด้วย 3 ส่วน ได้แก่ เทมเพลต HTML, องค์ประกอบที่กำหนดเอง และ Shadow DOM เมื่อรวมกันแล้ว คุณจะสร้างองค์ประกอบที่ปรับแต่งได้ มีทุกอย่างในตัว (แคปซูล) และนำกลับมาใช้ซ้ำได้ ซึ่งสามารถผสานรวมเข้ากับแอปพลิเคชันที่มีอยู่ได้อย่างราบรื่น เช่นเดียวกับองค์ประกอบ HTML อื่นๆ ที่เราได้กล่าวถึงไปแล้ว
ในส่วนนี้ เราจะสร้างองค์ประกอบ <star-rating> ซึ่งเป็นคอมโพเนนต์เว็บที่ช่วยให้ผู้ใช้ให้คะแนนประสบการณ์การใช้งานได้ตั้งแต่ 1-5 ดาว เมื่อตั้งชื่อองค์ประกอบที่กำหนดเอง ขอแนะนำให้ใช้ตัวอักษรพิมพ์เล็กทั้งหมด โดยต้องใส่ขีดกลางด้วยเพื่อช่วยแยกความแตกต่างระหว่างองค์ประกอบปกติกับองค์ประกอบที่กำหนดเอง
เราจะพูดถึงการใช้เอลิเมนต์ <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 ที่มองเห็นได้และจัดรูปแบบได้

การกำหนดให้ใช้ JavaScript เพื่อใช้เทมเพลตสำหรับการให้ดาวเพียง 1 ดวงนั้นไม่มีประโยชน์มากนัก แต่การสร้างคอมโพเนนต์เว็บสำหรับวิดเจ็ตการให้ดาวที่ปรับแต่งได้ซึ่งใช้ซ้ำๆ นั้นมีประโยชน์
องค์ประกอบ <slot>
เรามีช่องสำหรับใส่คำอธิบายที่กำหนดเองต่อการเกิดเหตุการณ์แต่ละครั้ง HTML มีองค์ประกอบ <slot> เป็นตัวยึดตำแหน่งภายใน <template> ซึ่งหากมีการระบุชื่อไว้ก็จะสร้าง "ช่องที่มีชื่อ" คุณสามารถใช้ช่องที่มีชื่อเพื่อปรับแต่งเนื้อหาภายในคอมโพเนนต์เว็บได้ องค์ประกอบ <slot> ช่วยให้เราควบคุมตำแหน่งที่ควรแทรกองค์ประกอบย่อยขององค์ประกอบที่กำหนดเองภายใน Shadow Tree ได้
ในเทมเพลต เราจะเปลี่ยน <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> ในองค์ประกอบที่กำหนดเอง องค์ประกอบที่มีแอตทริบิวต์ slot คือ <legend> ไม่จำเป็นต้องเป็นเช่นนั้น ในเทมเพลตของเรา
<slot name="star-rating-legend"> จะถูกแทนที่ด้วย <anyElement slot="star-rating-legend">
โดยที่ <anyElement> อาจเป็นองค์ประกอบใดก็ได้ แม้แต่องค์ประกอบที่กำหนดเองอื่น
องค์ประกอบที่ไม่ได้กำหนด
ใน <template> เราใช้องค์ประกอบ <rating> นี่ไม่ใช่องค์ประกอบที่กำหนดเอง
แต่เป็นองค์ประกอบที่ไม่รู้จัก เบราว์เซอร์จะไม่ทำงานล้มเหลวเมื่อไม่รู้จักองค์ประกอบ เบราว์เซอร์จะถือว่าองค์ประกอบ HTML ที่ไม่รู้จักเป็นองค์ประกอบในบรรทัดที่ไม่ระบุชื่อซึ่งจัดรูปแบบด้วย CSS ได้ องค์ประกอบ <rating> และ <star-rating> ไม่มีสไตล์หรือความหมายที่ใช้ User Agent เช่นเดียวกับ <span>
ใน CodePen นี้ <template> และเนื้อหาจะไม่แสดงผล <template> เป็นองค์ประกอบที่รู้จักซึ่งมีเนื้อหาที่ไม่ควรแสดงผล ยังไม่ได้กำหนดองค์ประกอบ <star-rating> เบราว์เซอร์จะแสดงองค์ประกอบเหมือนกับองค์ประกอบทั้งหมดที่ไม่รู้จักจนกว่าเราจะกำหนดองค์ประกอบ ในตอนนี้ ระบบจะถือว่า <star-rating> ที่ไม่รู้จักเป็นองค์ประกอบในบรรทัดที่ไม่ระบุตัวตน ดังนั้นเนื้อหาซึ่งรวมถึงคำอธิบายและ <p> ใน <star-rating> ที่ 3 จะแสดงเหมือนกับว่าอยู่ใน <span> แทน
มากำหนดองค์ประกอบเพื่อแปลงองค์ประกอบที่ไม่รู้จักนี้เป็นองค์ประกอบที่กำหนดเองกัน
องค์ประกอบที่กำหนดเอง
ต้องใช้ JavaScript เพื่อกำหนดองค์ประกอบที่กำหนดเอง เมื่อกำหนดแล้ว เนื้อหาขององค์ประกอบ <star-rating> จะถูกแทนที่ด้วย Shadow Root ที่มีเนื้อหาทั้งหมดของเทมเพลตที่เราเชื่อมโยงด้วย ระบบจะแทนที่องค์ประกอบ <slot> จากเทมเพลตด้วยเนื้อหาขององค์ประกอบภายใน <star-rating> ซึ่งมีค่าแอตทริบิวต์ slot ตรงกับค่าชื่อของ <slot> (หากมี) หากไม่ ระบบจะแสดงเนื้อหาของช่องของเทมเพลต
เนื้อหาภายในองค์ประกอบที่กำหนดเองซึ่งไม่ได้เชื่อมโยงกับช่อง (
<p>Is this text visible?</p> ใน <star-rating> ที่ 3) จะไม่
รวมอยู่ใน 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 ให้กับ Shadow Tree แต่ละรายการ โดยแยกออกจากส่วนที่เหลือของเอกสาร ซึ่งหมายความว่า 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 ซึ่งเป็นจุดสิ้นสุดของ Shadow DOM และจุดเริ่มต้นของ DOM ปกติสามารถข้ามได้ แต่ต้องทำอย่างตั้งใจเท่านั้น
แผนผัง Shadow คือแผนผัง DOM ภายใน Shadow DOM Shadow Root คือโหนดรูทของ Shadow Tree
คลาสเทียม :host จะเลือก <star-rating> ซึ่งเป็นองค์ประกอบโฮสต์ Shadow
โฮสต์ Shadow คือโหนด DOM ที่แนบ Shadow DOM อยู่
หากต้องการกำหนดเป้าหมายเฉพาะโฮสต์บางเวอร์ชัน ให้ใช้ :host()
ซึ่งจะเลือกเฉพาะองค์ประกอบโฮสต์ Shadow ที่ตรงกับพารามิเตอร์ที่ส่ง เช่น ตัวเลือกคลาสหรือแอตทริบิวต์ หากต้องการเลือกองค์ประกอบที่กำหนดเองทั้งหมด คุณสามารถใช้ star-rating { /* styles */ } ใน CSS ส่วนกลาง หรือ :host(:not(#nonExistantId)) ในรูปแบบเทมเพลต ในแง่ของความเฉพาะเจาะจง CSS ส่วนกลางจะมีความสำคัญมากกว่า
องค์ประกอบเทียม ::slotted() จะข้ามขอบเขต Shadow DOM จากภายใน Shadow DOM โดยจะเลือกองค์ประกอบที่กำหนดช่องไว้หากตรงกับตัวเลือก ในตัวอย่างของเรา
::slotted(legend) ตรงกับคำอธิบายแผนภูมิทั้ง 3 รายการ
หากต้องการกำหนดเป้าหมาย Shadow DOM จาก CSS ในขอบเขตส่วนกลาง คุณต้องแก้ไขเทมเพลต คุณเพิ่มแอตทริบิวต์ part ลงในองค์ประกอบที่ต้องการจัดรูปแบบได้ จากนั้นใช้องค์ประกอบเทียม ::part() เพื่อจับคู่องค์ประกอบภายใน Shadow Tree ที่ตรงกับพารามิเตอร์ที่ส่งมา Anchor หรือองค์ประกอบต้นทางสำหรับองค์ประกอบจำลองคือโฮสต์หรือชื่อองค์ประกอบที่กำหนดเอง ซึ่งในกรณีนี้คือ 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 มีรายการตรวจสอบที่ยอดเยี่ยมสำหรับการสร้างองค์ประกอบที่กำหนดเอง คุณอาจต้องการดูข้อมูลเกี่ยวกับ Shadow DOM แบบประกาศด้วย
ทดสอบความเข้าใจ
ทดสอบความรู้เกี่ยวกับเทมเพลต, ช่อง และ Shadow
โดยค่าเริ่มต้น รูปแบบจากภายนอก Shadow DOM จะจัดรูปแบบองค์ประกอบภายใน
คำตอบใดเป็นคำอธิบายที่ถูกต้องขององค์ประกอบ <template>