Halaman website yang ditampilkan terbentuk dari HTML. HTML sangat membantu kita karena ia cukup mudah dipelajari dan digunakan. HTML mudah dipahami oleh kita namun tidak untuk mesin.
sehingga terciptalah DOM (Document Object Model) sebagai penghubung antara HTML dengan bahasa pemrograman. 
Di dalam DOM seluruh struktur HTML dapat digambarkan dalam bentuk objek yang dapat dimanipulasi melalui bahasa pemrograman, salah satunya JavaScript.
Ketika browser memuat halaman, HTML akan secara otomatis dimodelkan menjadi sebuah object dan nodes hingga membentuk “DOM Tree”. Berikut contoh DOM Tree yang terbuat:
20200310203728706a9133fa852226f12e0fbff86a3c37.png
Dari struktur HTML berikut:



  2.   

  3.     Web Components

  4.   

  5.   

  6.     
    Mari belajar Shadow DOM

  7.   



Object dan nodes yang dihasilkan dari DOM akan memiliki properti dan method yang dapat kita manfaatkan untuk memanipulasi konten di dalamnya. 
Seluruh elemen dan style pada HTML (apapun yang berada di dalam DOM) akan terekspos secara global dan nilainya dapat kita peroleh dari mana saja. 
Biasanya untuk mendapatkan element kita gunakan document.querySelector, setelah itu kita dapat leluasa mengontrol elemen, mengubah konten di dalamnya ataupun mengubah styling yang diterapkan.

Encapsulation

Saat ini banyak web yang dibangun melalui arsitektur berbasis komponen sehingga diharapkan komponen tersebut dapat digunakan kembali. 
Namun bukankah tidak baik jika komponen tersebut dapat diganggu dan diubah dari luar? Sebaiknya komponen dapat bertahan dari gangguan luar agar secara visual atau fungsinya agar tetap dalam keadaan aslinya. Maka dari itu, kita perlu menerapkan konsep enkapsulasi pada komponen tersebut

What is Shadow DOM?

Saat ini kita mungkin bisa menerapkan konsep enkapsulasi dengan menggunakan agar komponen terpisah dari gangguan luar. Namun teknik ini bukan cara yang baik, berat, dan dapat menimbulkan masalah. Lantas bagaimana solusinya? Gunakanlah Shadow DOM.
Shadow DOM dapat mengisolasi sebagian struktur DOM di dalam komponen sehingga tidak dapat disentuh dari luar komponen atau nodenya. Singkatnya kita bisa sebut Shadow DOM sebagai “DOM dalam DOM”. Bagaimana ia bekerja? Perhatikan ilustrasi berikut:
Shadow DOM dapat membuat DOM Tree lain terbentuk secara terisolasi melalui host yang merupakan komponen dari regular DOM Tree (Document Tree). Shadow DOM Tree ini dimulai dari root bayangan (Shadow root), yang dibawahnya dapat memiliki banyak element lagi layaknya Document Tree.
Terdapat beberapa terminologi yang perlu kita ketahui dari ilustrasi di atas:
  • Shadow host : Merupakan komponen/node yang terdapat pada regular DOM di mana shadow DOM terlampir pada komponen/node ini.
  • Shadow tree : DOM Tree di dalam shadow DOM.
  • Shadow boundary : Batas dari shadow DOM dengan regular DOM.
  • Shadow root : Root node dari shadow tree.
Kita dapat memanipulasi elemen yang terdapat di dalam shadow tree layaknya pada document tree, namun cakupannya selama kita berada di dalam shadow boundary. Dengan kata lain, jika kita berada di document tree kita tidak dapat memanipulasi elemen bahkan menerapkan styling pada elemen yang terdapat di dalam shadow tree. Itulah mengapa shadow DOM dapat membuat komponen terenkapsulasi

Basic Usage

Potongan kode untuk materi ini:
Untuk melampirkan Shadow DOM pada elemen penggunaan sangat mudah, yaitu dengan menggunakan properti attachShadow pada elemen-nya seperti ini:


  1. // Shadow Host

  2. const divElement = document.createElement("div");

  3.  

  4.  

  5. // element yang berada di dalam Shadow DOM

  6. const headingElement = document.createElement("h1");

  7. headingElement.innerText = "Ini merupakan konten di dalam shadow DOM";

  8.  

  9.  

  10. // Melampirkan shadow root pada shadow host

  11. // Mengatur mode shadow dengan nilai open

  12. const shadowRoot = divElement.attachShadow({mode: "open"});

  13.  

  14.  

  15. // Memasukkan element heading ke dalam shadow root

  16. shadowRoot.appendChild(headingElement);

  17.  

  18.  

  19. // Memasukkan elemen shadow host ke regular DOM

  20. document.body.appendChild(divElement);





  3.  

  4.    <meta charset="utf-8">

  5.    <meta name="viewport" content="width=device-width">

  6.    Shadow DOM Basic Usage

  7.  

  8.  

  9.  <script src="main.js">

  10.  



Jika kita lihat pada browser, maka struktur HTML yang akan dihasilkan adalah seperti ini:
2020031020442138d22cf8f4814aacc795f563c3015892.png
Dan struktur DOM tree yang terbentuk akan tampak seperti ini:
20200310204452a9e4788ac5f7f206c20debfa0bc87524.png
Dalam penggunaan attachShadow() kita melampirkan objek dengan properti mode yang memiliki nilai ‘open’. Sebenarnya terdapat dua opsi nilai yang dapat digunakan dalam properti mode, yaitu “open” dan “closed”. 
Menggunakan nilai open berarti kita memperbolehkan untuk mengakses properti shadowRoot melalui elemen yang melampirkan Shadow DOM. 


  1. divElement.attachShadow;


properti shadowRoot mengembalikan struktur DOM yang berada pada shadow tree.
20200310204643a7a1f999761eaf74f9476e50013bb373.gif
Namun jika kita menggunakan nilai closed maka properti shadowRoot akan mengembalikan nilai null. 


  1. const shadowRoot = divElement.attachShadow({mode: "closed"});

  2. divElement.shadowRoot // null;


Hal ini berarti kita sama sekali tidak dapat mengakses Shadow Tree selain melalui variabel yang kita definisikan ketika melampirkan Shadow DOM.


  1. const shadowRoot = divElement.attachShadow({mode: "closed"});

  2. divElement.shadowRoot // null;

  3. shadowRoot // # shadow-root (closed)


2020031020483296ef7fce493fd7c0528697c3fa03565b.gif
Karena Shadow DOM terisolasi dari document tree maka element yang terdapat di dalamnya pun tidak akan terpengaruh oleh styling yang berada diluar dari shadow root-nya.




  3.  

  4.    <meta charset="utf-8">

  5.    <meta name="viewport" content="width=device-width">

  6.    Shadow DOM Basic Usage

  7.    

  8.        h1 {

  9.          color: red;

  10.        }

  11.    

  12.  

  13.  

  14.    
    Ini merupakan konten yang berada di Document tree

  15.    <script src="main.js">

  16.  




  1. // Shadow Host

  2. const divElement = document.createElement("div");

  3.  

  4.  

  5. // element yang berada di dalam Shadow DOM

  6. const headingElement = document.createElement("h1");

  7. headingElement.innerText = "Ini merupakan konten di dalam shadow DOM";

  8.  

  9.  

  10. // Melampirkan shadow root pada shadow host

  11. // Mengatur mode shadow dengan nilai open

  12. const shadowRoot = divElement.attachShadow({mode: "open"});

  13.  

  14.  

  15. // Memasukkan element heading ke dalam shadow root

  16. shadowRoot.appendChild(headingElement);

  17.  

  18.  

  19. // Memasukkan elemen shadow host ke regular DOM

  20. document.body.appendChild(divElement);


Jika dilihat pada browser maka hasilnya akan seperti ini:
20200310205023649403bfa8d61e879afc65f4a050c502.png
Berdasarkan hasil di atas, styling hanya akan diterapkan pada elemen 

 yang berada di document tree. Sedangkan elemen 

 yang berada pada shadow dom tidak akan terpengaruh dengan styling tersebut. Lantas, bagaimana caranya kita melakukan styling pada Shadow DOM?

Kita dapat melakukannya dengan menambahkan template  di dalam shadowRoot.innerHTML.  Contohnya seperti ini:


  1. // menetapkan styling pada Shadow DOM

  2. shadowRoot.innerHTML += `

  3.  

  4.    h1 {

  5.      color: green;

  6.    }

  7.  

  8. `;


Maka element  tersebut akan berada di dalam shadow tree dan akan berdampak pada elemen yang ada di dalamnya.
20200310205206823dcc0fb3c6ef38cb5e0a7563f0590d.png

Shadow DOM in Web Components

Untuk membantu menerapkan enkapsulasi pada custom element, Shadow DOM berperan sebagai salah satu API standar yang digunakan dalam membuat Web Component (Hal ini distandarisasi oleh W3C). Kita sudah belajar bagaimana menerapkan Shadow DOM pada elemen yang berada pada Document Tree, namun bagaimana caranya bila itu diterapkan pada custom element?
Jawabannya cukup mudah! Mari kita lihat kembali contoh custom element yang pernah kita buat pada materi Styling Custom Element without Shadow DOM




  3.  

  4.    <meta charset="utf-8">

  5.    <meta name="viewport" content="width=device-width">

  6.    Styling without Shadow DOM

  7.    <link rel="stylesheet" href="style.css"/>

  8.  


  10.    <image-figure

  11.      src="https://i.imgur.com/iJq78XH.jpg"

  12.      alt="Dicoding Logo"

  13.      caption="Huruf g dalam logo Dicoding">

  14.      

  15.  

  16.  

  17.      

  18.      

  19.        <img src="https://i.imgur.com/iJq78XH.jpg"

  20.        alt="Dicoding logo"/>

  21.        
    Huruf g dalam logo Dicoding

  22.      

  23.    <script src="image-figure.js">

  24.  




  1. class ImageFigure extends HTMLElement {

  2.  

  3.  

  4.  connectedCallback() {

  5.    this.src = this.getAttribute("src") || null;

  6.    this.alt = this.getAttribute("alt") || null;

  7.    this.caption = this.getAttribute("caption") || null;

  8.    this.render();

  9.  }

  10.  

  11.  

  12.  render() {

  13.    this.innerHTML = `

  14.      

  15.        figure {

  16.          border: thin #c0c0c0 solid;

  17.          display: flex;

  18.          flex-flow: column;

  19.          padding: 5px;

  20.          max-width: 220px;

  21.          margin: auto;

  22.        }

  23.  

  24.  

  25.        figure > img {

  26.          max-width: 220px;

  27.        }

  28.  

  29.  

  30.        figure > figcaption {

  31.          background-color: #222;

  32.          color: #fff;

  33.          font: italic smaller sans-serif;

  34.          padding: 3px;

  35.          text-align: center;

  36.        }

  37.      

  38.  

  39.  

  40.      

  41.        <img src="${this.src}"

  42.            alt="${this.alt}">

  43.        
    ${this.caption}

  44.      

  45.    `;

  46.  }

  47.  

  48.  

  49.  attributeChangedCallback(name, oldValue, newValue) {

  50.    this[name] = newValue;

  51.    this.render();

  52.  }

  53.  

  54.  

  55.  static get observedAttributes() {

  56.    return ["caption"];

  57.  }

  58. }

  59.  

  60.  

  61. customElements.define("image-figure", ImageFigure);


Ketika kode tersebut dijalankan pada browser, kita bisa melihat terdapat dua komponen 

 yang ditampilkan, salah satunya adalah custom element.
20200310205631fa13fdb32383c4c52b3566d37527bf5e.png
Kita bisa melihat juga bahwa keduanya memiliki styling yang sama, padahal kita hanya menetapkan styling di dalam komponen ImageFigure saja. 
Yup, hal tersebut wajar terjadi karena pada custom element kita tidak menetapkan Shadow DOM sehingga styling pada custom element akan berdampak juga terhadap komponen di luarnya.
Dalam melampirkan Shadow DOM pada custom element sama seperti pada elemen biasanya, yaitu menggunakan attachShadow. 
Namun dalam custom element, kita lakukan pada constructor class-nya seperti ini:


  1. class ImageFigure extends HTMLElement {

  2.  

  3.  constructor() {

  4.    super();

  5.    this._shadowRoot = this.attachShadow({mode: "open"});

  6.  }

  7.  

  8.   .....

  9. }


Agar nilai shadowRoot dapat diakses pada fungsi mana saja di class, maka kita perlu memasukkan nilai shadowRoot pada properti class menggunakan this. 
Kita bebas menentukan nama properti sesuai keinginan, namun untuk memudahkan kita gunakan nama _shadowRoot. Lalu mengapa penamaannya menggunakan tanda underscore (_) di depannya? Jawabannya, this pada konteks class ini merupakan HTMLElement dan ia sudah memiliki properti dengan nama shadowRoot. 
Untuk membedakan properti _shadowRoot asli dengan properti baru yang kita buat, kita bisa tambahkan underscore di awal penamaannya. 
Hal ini dibutuhkan karena jika kita menerapkan mode closed pada Shadow DOM, nilai properti shadowRoot akan mengembalikan null, sehingga tidak ada cara lain untuk kita mengakses Shadow Tree.
Setelah menerapkan Shadow DOM pada constructor, ketika ingin mengakses apapun yang merupakan properti dari DOM kita harus melalui _shadowRoot. 
Contohnya ketika ingin menerapkan template HTML, kita tidak bisa menggunakan langsung this.innerHTML, namun perlu melalui this._shadowRoot.innerHTML.
Sehingga kita perlu menyesuaikan kembali beberapa kode yang terdapat pada fungsi render menjadi seperti ini:
  1. render() {
  2.    this._shadowRoot.innerHTML = `
  3.      
  4.        figure {
  5.          border: thin #c0c0c0 solid;
  6.          display: flex;
  7.          flex-flow: column;
  8.          padding: 5px;
  9.          max-width: 220px;
  10.          margin: auto;
  11.        }
  12.  
  13.        figure > img {
  14.          max-width: 220px;
  15.        }
  16.  
  17.        figure > figcaption {
  18.          background-color: #222;
  19.          color: #fff;
  20.          font: italic smaller sans-serif;
  21.          padding: 3px;
  22.          text-align: center;
  23.        }
  24.      
  25.  
  26.      
  27.        <img src="${this.src}"
  28.            alt=”${this.alt}”>
  29.        
    ${this.caption}
  30.      

  31.    `;
  32. }
Dengan begitu sekarang styling pada komponen hanya berlaku pada komponen itu sendiri. Begitu juga sebaliknya, styling yang dituliskan di luar dari komponen tidak akan berdampak pada elemen di dalam komponen.
20200310210356544578a1669328f878cb86f6e1ff1d35.png

Solution: Menerapkan Shadow DOM pada Proyek Club Finder

Apakah Anda berhasil menerapkan shadow DOM pada custom element di proyek Club Finder? Jika belum, mari kita lakukan bersama-sama.

Menerapkan Shadow DOM pada App Bar

Kita mulai dari  component yuk. Pertama kita buka dulu proyek club finder dengan text editor yang kita gunakan.
20200313095904249af3ba1d687f1216c8dc44d5fa11fc.png
Kemudian buka berkas script -> component -> app-bar.js, buat constructor dari class tersebut dan di dalamnya kita tetapkan shadow root seperti ini:
  1. class AppBar extends HTMLElement {
  2.  
  3.    constructor() {
  4.        super();
  5.        this.shadowDOM = this.attachShadow({mode: “open”});
  6.    }
  7.  
  8.    connectedCallback(){
  9.        this.render();
  10.    }
  11.  
  12.    render() {
  13.        this.innerHTML = `

    Club Finder

    `;

  14.    }
  15. }
  16.  
  17. customElements.define(“app-bar”, AppBar);
Karena kita sudah menerapkan Shadow DOM pada AppBar, jangan lupa pada fungsi render(), kita ubah this.innerHTML menjadi this.shadowDOM.innerHTML.


  1. class AppBar extends HTMLElement {

  2.  

  3.    constructor() {

  4.        super();

  5.        this.shadowDOM = this.attachShadow({mode: "open"});

  6.    }

  7.  

  8.    connectedCallback(){

  9.        this.render();

  10.    }

  11.  

  12.    render() {

  13.        this.shadowDOM.innerHTML = `
    Club Finder
    `    ;

  14.    }

  15. }

  16.  

  17. customElements.define("app-bar", AppBar);


Kemudian buka berkas style -> appbar.css dan pindahkan (cut) seluruh kode yang ada pada berkas tersebut.

  1. app-bar {

  2.    display: block;

  3.    padding: 16px;

  4.    width: 100%;

  5.    background-color: cornflowerblue;

  6.    color: white;

  7.    box-shadow: 0 4px 8px 0 rgba(0, 0, 0, 0.2);

  8. }


Lalu tempel (paste) pada nilai this.shadowDOM.innerHTML dengan dibungkus oleh element  tepat sebelum element 

 pada fungsi render() di berkas app-bar.js seperti ini:

  1. class AppBar extends HTMLElement {
  2.  
  3.    constructor() {
  4.        super();
  5.        this.shadowDOM = this.attachShadow({mode: “open”});
  6.    }
  7.  
  8.    connectedCallback(){
  9.        this.render();
  10.    }
  11.  
  12.    render() {
  13.        this.shadowDOM.innerHTML = `
  14.        
  15.            app-bar {
  16.                display: block;
  17.                padding: 16px;
  18.                width: 100%;
  19.                background-color: cornflowerblue;
  20.                color: white;
  21.                box-shadow: 0 4px 8px 0 rgba(0, 0, 0, 0.2);
  22.            }
  23.        
  24.        

    Club Finder

    `;

  25.    }
  26. }
  27.  
  28. customElements.define(“app-bar”, AppBar);
Coba kita simpan perubahan yang diterapkan kemudian lihat perubahannya pada browser.

202003131025191a8dcdd75e697b30cba119d06defa3e1.png
Ups, pada browser kita dapat melihat title yang ditampilkan pada  tampak berantakan. Untuk menanganinya, kita perlu menyesuaikan kembali style yang diterapkan pada custom element menjadi seperti ini:
  1. class AppBar extends HTMLElement {
  2.  
  3.    constructor() {
  4.        super();
  5.        this.shadowDOM = this.attachShadow({mode: “open”});
  6.    }
  7.  
  8.    connectedCallback(){
  9.        this.render();
  10.    }
  11.  
  12.    render() {
  13.        this.shadowDOM.innerHTML = `
  14.        
  15.            * {
  16.                margin: 0;
  17.                padding: 0;
  18.                box-sizing: border-box;
  19.            }
  20.            :host {
  21.                display: block;
  22.                width: 100%;
  23.                background-color: cornflowerblue;
  24.                color: white;
  25.                box-shadow: 0 4px 8px 0 rgba(0, 0, 0, 0.2);
  26.            }
  27.            h2 {
  28.                padding: 16px;
  29.            }
  30.        
  31.        

    Club Finder

    `;

  32.    }
  33. }
  34.  
  35. customElements.define(“app-bar”, AppBar);
Pada perubahan styling tersebut kita menambahkan


  1. * {

  2.     margin: 0;

  3.     padding: 0;

  4.     box-sizing: border-box;

  5.  }


Yang digunakan untuk menghilangkan seluruh margin dan padding standar yang diterapkan pada element html. Dan kita juga mengubah pengaturan box-sizing menjadi border-box.
Lalu kode pada kode styling lainnya juga kita melihat bahwa selector app-bar digantikan dengan :host. Apa itu :host? Selector :host merupakan selector yang digunakan untuk menunjuk element :host yang menerapkan Shadow DOM. Pada host kita tidak dapat mengatur padding sehingga kita perlu memindahkannya pada elemen 

.

Setelah melakukan perubahan tersebut simpan (save) kembali perubahannya dan lihat hasilnya pada browser, seharusnya  sudah ditampilkan dengan baik.
20200313102750873f1782c7d560202cb13b08a7eb95ea.png
Karena kita sudah tidak membutuhkan lagi berkas src -> styles -> appbar.css, kita dapat menghapus berkas tersebut. 
20200313102817f716d852a60606d8028fd6f20b702380.png
Jangan lupa untuk menghapus import css tersebut pada src -> styles -> style.css.


  1. @import "clublist.css";

  2. @import "searchbar.css";

  3.  

  4. * {

  5.    padding: 0;

  6.    margin: 0;

  7.    box-sizing: border-box;

  8. }

  9.  

  10. body {

  11.    font-family: sans-serif;

  12. }

  13.  

  14. main {

  15.    width: 90%;

  16.    max-width: 800px;

  17.    margin: 32px auto;

  18. }


Menerapkan Shadow DOM pada Search Bar

Setelah berhasil menerapkan Shadow DOM pada App Bar, selanjutnya kita terapkan Shadow DOM pada search bar. Silakan buka berkas src -> script -> component -> search-bar.js, kemudian buat constructor dan terapkan Shadow DOM di dalamnya.
  1. class SearchBar extends HTMLElement {
  2.  
  3.    constructor() {
  4.        super();
  5.        this.shadowDOM = this.attachShadow({mode: “open”});
  6.    }
  7.  
  8.    connectedCallback(){
  9.        this.render();
  10.    }
  11.   
  12.    set clickEvent(event) {
  13.        this._clickEvent = event;
  14.        this.render();
  15.    }
  16.  
  17.    get value() {
  18.        return this.querySelector(“#searchElement”).value;
  19.    }
  20.  
  21.    render() {
  22.        this.innerHTML = `
  23.        
  24.            
  25.            Search
  26.