Giới thiệu
Thành phần web là một tập hợp các tiêu chuẩn tiên tiến:
- Cho phép tạo tiện ích
- …có thể được sử dụng lại một cách đáng tin cậy
- …và không làm hỏng trang nếu phiên bản tiếp theo của thành phần thay đổi thông tin triển khai nội bộ.
Điều này có nghĩa là bạn phải quyết định thời điểm sử dụng HTML/JavaScript và thời điểm sử dụng Thành phần web? Không! HTML và JavaScript có thể tạo ra nội dung hình ảnh tương tác. Tiện ích là các thành phần hình ảnh có tính tương tác. Bạn nên tận dụng các kỹ năng HTML và JavaScript khi phát triển tiện ích. Các tiêu chuẩn về Thành phần web được thiết kế để giúp bạn làm việc đó.
Tuy nhiên, có một vấn đề cơ bản khiến các tiện ích được tạo từ HTML và JavaScript khó sử dụng: Cây DOM bên trong một tiện ích không được đóng gói khỏi phần còn lại của trang. Việc thiếu tính năng đóng gói này có nghĩa là biểu định kiểu tài liệu của bạn có thể vô tình áp dụng cho các phần bên trong tiện ích; JavaScript của bạn có thể vô tình sửa đổi các phần bên trong tiện ích; mã nhận dạng của bạn có thể trùng lặp với mã nhận dạng bên trong tiện ích; v.v.
Thành phần web bao gồm ba phần:
DOM tối giải quyết vấn đề đóng gói cây DOM. Bốn phần của Thành phần web được thiết kế để hoạt động cùng nhau, nhưng bạn cũng có thể chọn phần nào của Thành phần web để sử dụng. Hướng dẫn này cho bạn biết cách sử dụng Shadow DOM.
Xin chào, Thế giới bóng tối
Với Shadow DOM, các phần tử có thể nhận được một loại nút mới liên kết với chúng. Loại nút mới này được gọi là gốc bóng. Phần tử có gốc bóng liên kết với nó được gọi là máy chủ bóng. Nội dung của máy chủ bóng không được hiển thị; thay vào đó, nội dung của gốc bóng sẽ được hiển thị.
Ví dụ: nếu bạn có mã đánh dấu như sau:
<button>Hello, world!</button>
<script>
var host = document.querySelector('button');
var root = host.createShadowRoot();
root.textContent = 'こんにちは、影の世界!';
</script>
thì thay vì
<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>
trang của bạn trông như thế nào
<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>
Không chỉ vậy, nếu JavaScript trên trang hỏi textContent của nút là gì, thì JavaScript sẽ không nhận được "こんにちは、影の世界!" mà là "Hello, world!" vì cây con DOM trong gốc bóng được đóng gói.
Tách nội dung khỏi bản trình bày
Bây giờ, chúng ta sẽ xem xét việc sử dụng Shadow DOM để tách biệt nội dung khỏi bản trình bày. Giả sử chúng ta có thẻ tên sau:
<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>
Sau đây là mã đánh dấu. Đây là nội dung bạn sẽ viết hôm nay. Không sử dụng 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>
Vì cây DOM thiếu tính năng đóng gói, nên toàn bộ cấu trúc của thẻ tên sẽ hiển thị trong tài liệu. Nếu các phần tử khác trên trang vô tình sử dụng cùng tên lớp để tạo kiểu hoặc viết tập lệnh, thì chúng ta sẽ gặp rắc rối.
Chúng ta có thể tránh được những điều tồi tệ.
Bước 1: Ẩn thông tin chi tiết về bản trình bày
Về mặt ngữ nghĩa, chúng ta có thể chỉ quan tâm đến việc:
- Đây là thẻ tên.
- Tên là "Bob".
Trước tiên, chúng ta viết mã đánh dấu gần hơn với ngữ nghĩa thực sự mà chúng ta muốn:
<div id="nameTag">Bob</div>
Sau đó, chúng ta đặt tất cả kiểu và div dùng cho bản trình bày vào
phần tử <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>
Tại thời điểm này, "Bob" là nội dung duy nhất được hiển thị. Vì chúng ta đã di chuyển các phần tử DOM trình bày vào bên trong một phần tử <template>, nên các phần tử này không được hiển thị, nhưng có thể truy cập được từ JavaScript. Bây giờ, chúng ta sẽ làm việc đó
để điền vào shadow root:
<script>
var shadow = document.querySelector('#nameTag').createShadowRoot();
var template = document.querySelector('#nameTagTemplate');
var clone = document.importNode(template.content, true);
shadow.appendChild(clone);
Bây giờ, chúng ta đã thiết lập một gốc bóng, thẻ tên sẽ được kết xuất lại. Nếu bạn nhấp chuột phải vào thẻ tên và kiểm tra phần tử, bạn sẽ thấy đó là mã đánh dấu ngữ nghĩa, gọn gàng:
<div id="nameTag">Bob</div>
Điều này cho thấy rằng bằng cách sử dụng Shadow DOM, chúng ta đã ẩn thông tin chi tiết về bản trình bày của thẻ tên khỏi tài liệu. Thông tin chi tiết về bản trình bày được đóng gói trong Shadow DOM.
Bước 2: Tách nội dung khỏi bản trình bày
Thẻ tên của chúng ta hiện ẩn thông tin chi tiết về bản trình bày khỏi trang, nhưng không thực sự tách biệt bản trình bày khỏi nội dung, vì mặc dù nội dung (tên "Bob") nằm trong trang, nhưng tên được hiển thị là tên mà chúng ta đã sao chép vào gốc bóng. Nếu muốn thay đổi tên trên thẻ tên, chúng ta cần thực hiện ở hai nơi và chúng có thể không đồng bộ.
Các phần tử HTML có tính kết hợp, ví dụ: bạn có thể đặt một nút bên trong bảng. Thành phần là thứ chúng ta cần ở đây: Thẻ tên phải là một thành phần của nền đỏ, văn bản "Xin chào!" và nội dung trên thẻ tên.
Bạn (tác giả thành phần) xác định cách hoạt động của thành phần kết hợp với tiện ích bằng một phần tử mới có tên là <content>. Thao tác này sẽ tạo một điểm chèn trong bản trình bày của tiện ích và điểm chèn này sẽ chọn nội dung từ máy chủ bóng để trình bày tại điểm đó.
Nếu chúng ta thay đổi mã đánh dấu trong Shadow DOM thành như sau:
<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>
Khi thẻ tên được hiển thị, nội dung của máy chủ bóng sẽ được chiếu vào vị trí mà phần tử <content> xuất hiện.
Giờ đây, cấu trúc của tài liệu đã đơn giản hơn vì tên chỉ nằm ở một nơi — tài liệu. Nếu trang của bạn cần cập nhật tên người dùng, bạn chỉ cần viết:
document.querySelector('#nameTag').textContent = 'Shellie';
và thế là xong. Trình duyệt sẽ tự động cập nhật kết xuất của thẻ tên vì chúng ta đang chiếu nội dung của thẻ tên vào vị trí bằng <content>.
<div id="ex2b">
Bây giờ, chúng ta đã tách biệt được nội dung và bản trình bày. Nội dung nằm trong tài liệu; bản trình bày nằm trong Shadow DOM. Trình duyệt sẽ tự động đồng bộ hoá các luồng này khi đến lúc kết xuất nội dung nào đó.
Bước 3: Lợi nhuận
Bằng cách tách riêng nội dung và cách trình bày, chúng ta có thể đơn giản hoá mã thao tác với nội dung. Trong ví dụ về thẻ tên, mã đó chỉ cần xử lý một cấu trúc đơn giản chứa một <div> thay vì nhiều cấu trúc.
Giờ đây, nếu thay đổi bản trình bày, chúng ta không cần thay đổi bất kỳ mã nào!
Ví dụ: giả sử chúng ta muốn bản địa hoá thẻ tên. Đây vẫn là thẻ tên, vì vậy, nội dung ngữ nghĩa trong tài liệu không thay đổi:
<div id="nameTag">Bob</div>
Mã thiết lập gốc bóng vẫn giữ nguyên. Chỉ những gì được đưa vào gốc bóng thay đổi:
<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>
Đây là một điểm cải tiến lớn so với tình hình trên web hiện nay, vì mã cập nhật tên của bạn có thể phụ thuộc vào cấu trúc của thành phần, vốn đơn giản và nhất quán. Mã cập nhật tên của bạn không cần biết cấu trúc dùng để kết xuất. Nếu xem xét nội dung được hiển thị, tên sẽ xuất hiện ở vị trí thứ hai trong tiếng Anh (sau "Hi! My name is"), nhưng lại đứng đầu trong tiếng Nhật (trước "と申します"). Sự khác biệt đó không có ý nghĩa về mặt ngữ nghĩa từ quan điểm cập nhật tên đang hiển thị, vì vậy, mã cập nhật tên không cần biết về chi tiết đó.
Mở rộng kiến thức: Phép chiếu nâng cao
Trong ví dụ trên, phần tử <content> chọn tất cả nội dung từ máy chủ bóng. Bằng cách sử dụng thuộc tính select, bạn có thể kiểm soát nội dung mà một phần tử nội dung chiếu. Bạn cũng có thể sử dụng nhiều phần tử nội dung.
Ví dụ: nếu bạn có một tài liệu chứa nội dung sau:
<div id="nameTag">
<div class="first">Bob</div>
<div>B. Love</div>
<div class="email">bob@</div>
</div>
và một gốc bóng sử dụng bộ chọn CSS để chọn nội dung cụ thể:
<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>
Phần tử <div class="email"> được so khớp bởi cả phần tử <content select="div"> và <content
select=".email">. Địa chỉ email của Bob xuất hiện bao nhiêu lần và có những màu nào?
Câu trả lời là địa chỉ email của Bob xuất hiện một lần và có màu vàng.
Lý do là, như những người can thiệp vào Shadow DOM đều biết, việc xây dựng cây của những gì thực sự hiển thị trên màn hình giống như một bữa tiệc lớn. Phần tử nội dung là lời mời cho phép nội dung từ tài liệu vào phần kết xuất DOM tối ở hậu trường. Các lời mời này được gửi theo thứ tự; người nhận được lời mời phụ thuộc vào người được mời (tức là thuộc tính select). Nội dung, sau khi được mời, luôn chấp nhận lời mời (ai mà không chấp nhận chứ?!) và bắt đầu. Nếu một lời mời tiếp theo được gửi lại đến địa chỉ đó, thì không có ai ở nhà và lời mời đó sẽ không đến được bữa tiệc của bạn.
Trong ví dụ trên, <div class="email"> khớp với cả bộ chọn div và bộ chọn .email, nhưng vì phần tử nội dung có bộ chọn div xuất hiện sớm hơn trong tài liệu, nên <div class="email"> sẽ chuyển đến bữa tiệc màu vàng và không có ai tham dự bữa tiệc màu xanh dương. (Đó có thể là lý do khiến nó có màu xanh lam, mặc dù đau khổ thích bầu bạn, vì vậy bạn không bao giờ biết được.)
Nếu một thành phần không được mời tham gia bất kỳ bên nào, thì thành phần đó sẽ không được kết xuất. Đó là điều đã xảy ra với văn bản "Hello, world" trong ví dụ đầu tiên. Điều này rất hữu ích khi bạn muốn đạt được một kết xuất hoàn toàn khác: Viết mô hình ngữ nghĩa trong tài liệu, đây là nội dung mà tập lệnh trong trang có thể truy cập, nhưng ẩn để hiển thị và kết nối với một trang thực sự khác mô hình kết xuất trong Shadow DOM bằng JavaScript.
Ví dụ: HTML có một bộ chọn ngày rất tiện lợi. Nếu viết <input
type="date">, bạn sẽ thấy một lịch bật lên gọn gàng. Nhưng nếu bạn muốn cho phép người dùng chọn một khoảng ngày cho kỳ nghỉ trên đảo sa mạc của họ (bạn biết đấy… với những chiếc võng làm từ Red Vines.) Bạn thiết lập tài liệu theo cách sau:
<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>
nhưng tạo Shadow DOM sử dụng bảng để tạo lịch đẹp mắt, làm nổi bật phạm vi ngày, v.v. Khi người dùng nhấp vào các ngày trong lịch, thành phần này sẽ cập nhật trạng thái trong các giá trị đầu vào startDate và endDate; khi người dùng gửi biểu mẫu, các giá trị từ những phần tử đầu vào đó sẽ được gửi.
Tại sao tôi lại đưa nhãn vào tài liệu nếu chúng không được hiển thị? Lý do là nếu người dùng xem biểu mẫu bằng một trình duyệt không hỗ trợ Shadow DOM, thì biểu mẫu đó vẫn có thể sử dụng được, chỉ là không đẹp mắt. Người dùng sẽ thấy nội dung như sau:
<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>
Bạn đã vượt qua bài kiểm tra Kiến thức cơ bản về Shadow DOM
Đó là những kiến thức cơ bản về Shadow DOM — bạn đã vượt qua bài học cơ bản về Shadow DOM! Bạn có thể làm nhiều việc hơn với Shadow DOM, ví dụ: bạn có thể sử dụng nhiều bóng trên một máy chủ bóng hoặc bóng lồng nhau để đóng gói hoặc thiết kế trang của bạn bằng Chế độ xem dựa trên mô hình (MDV) và Shadow DOM. Và Thành phần web không chỉ là DOM tối.
Chúng tôi sẽ giải thích những vấn đề đó trong các bài đăng sau.