dialog要素を使う今後のモーダル実装


こんにちハ！　こんばんハ！
フロントエンドエンジニアとして働いている[あんころもちたろう](https://twitter.com/KL2J3BsTnbc7VD8)です。

初めて記事を書くので緊張気味です・・・:eyes:

## 対象ブラウザにIE11が含まれない時代へ・・・

そろそろIE１１対象外のweb制作が増えてくるのかなと思ってます。
遅れを取らないようにCSS・JSの情報をキャッチアップをしていましたが、HTMLを疎かにしておりました:bow_tone2:

というわけで！
そろそろ業務でも使われるdialog要素を実際に使ってモーダルを実装してみましたので、共有させていただきます。

[can i use](https://caniuse.com/dialog)

## HTMLの記述
まずはdialog要素をどのように記述するか確認します。

```html
<dialog class="dialog">
  <div class="dialog_inner">
    <p>dialog内のテキスト</p>
    <button class="btn close" type="button">閉じる</button>
  </div><!-- /.dialog_inner -->
</dialog>
```

モーダルとして表示させるものをdialog要素内に記述します。
これだけ記述してもブラウザには表示されません。

## 実装
まず、モーダルを開くためのボタンを用意します。

```html
<dialog class="dialog" open>
  <div class="dialog_inner">
    <p>dialog内のテキスト</p>
    <button class="btn close" type="button">閉じる</button>
  </div><!-- /.dialog_inner -->
</dialog>

<button class="btn open" type="button">モーダル</button>
```

`.btn.open`をクリックしたらモーダル（dialog要素）を見えるようにします。

```javascript
      const modal = document.querySelector(".dialog");
      const openTrigger = document.querySelector(".btn.open");

      openTrigger.addEventListener("click", () => {
        modal.showModal();
      });
```

モーダルを開くときは、`showModal()`メソッドを使います。
`showModal()`メソッドを使ってモーダルを開くとdialog要素に`::backdrop`という疑似要素がつき、これがオーバーレイになります！:clap:
今までクラスの付け替えやスタイルの変更をしていた箇所がこんなにわかりやすくなるとは。。

オーバーレイにスタイルを当てたいときは、CSSでスタイルを当てることができます！

```css
      dialog::backdrop {
        background: rgba(94, 94, 94, 0.5);
        backdrop-filter: blur(4px);
      }
```

今度は`.btn.close`をクリックしたらモーダルを閉じられるようにします。

```javascript
      const modal = document.querySelector(".dialog");
      const openTrigger = document.querySelector(".btn.open");
      const closeTrigger = document.querySelector(".btn.close"); // <-追加

      openTrigger.addEventListener("click", () => {
        modal.showModal();
      });
      closeTrigger.addEventListener("click", () => { // <-追加
        modal.close();
      });
```

モーダルを閉じるときは、`close()`メソッドを使います。

ここまでで簡単なモーダルを実装できました。
dialog要素を使うと、
モーダルを開いた状態でescキーを押すとモーダルが閉じてくれるので、
今までJSでやっていたものが不要になります:clap:
さらに、モーダルを開いているとき、tabキーでオーバーレイより下の要素にフォーカスが当たらないので、面倒だったJSの処理も不要になります！

しかし、このままだとモーダル開いたときに、オーバーレイより下がスクロールしてしまったり、
オーバーレイをクリックしてもモーダルが閉じないので、それらを実装してみます。

### スクロールしないように

CSSでbody要素に`overflow: hidden;`を当てるためのクラスを用意します。

```css
      dialog::backdrop {
        background: rgba(94, 94, 94, 0.5);
        backdrop-filter: blur(4px);
      }
      body.is-modal { /* 追加 */
        overflow: hidden;
      }
```

JSでモーダルを開いているときは、body要素に`.is-modal`が付与され、
閉じたときは、body要素から`.is-modal`を削除するようにします。

```javascript
      const modal = document.querySelector(".dialog");
      const openTrigger = document.querySelector(".btn.open");
      const closeTrigger = document.querySelector(".btn.close");
      const { body } = document; // <-追加
      const MODAL_CLASS = "is-modal"; // <-追加

      openTrigger.addEventListener("click", () => {
        body.classList.add(MODAL_CLASS); // <-追加
        modal.showModal();
      });
      closeTrigger.addEventListener("click", () => {
        body.classList.remove(MODAL_CLASS); // <-追加
        modal.close();
      });
```

このままだと、escキーでモーダルを閉じたときにbody要素から`.is-modal`が削除されないので、
escキーを押したときの処理を追加します。

```javascript
      const modal = document.querySelector(".dialog");
      const openTrigger = document.querySelector(".btn.open");
      const closeTrigger = document.querySelector(".btn.close");
      const { body } = document;
      const MODAL_CLASS = "is-modal";

      openTrigger.addEventListener("click", () => {
        body.classList.add(MODAL_CLASS);
        modal.showModal();
      });
      closeTrigger.addEventListener("click", () => {
        body.classList.remove(MODAL_CLASS);
        modal.close();
      });
      modal.addEventListener("cancel", () => { // <-追加
        body.classList.remove(MODAL_CLASS);
      });
```

`cancel`イベントを使うことで対応できます！

### オーバーレイをクリックしたら閉じるように

モーダルを開いているときに、クリックした要素を取得してオーバーレイ箇所かどうか判定します。

まずCSSを準備します。

```css
      dialog::backdrop {
        background: rgba(94, 94, 94, 0.5);
        backdrop-filter: blur(4px);
      }
      body.is-modal {
        overflow: hidden;
      }
      dialog { /* 追加 */
        padding: 0;
      }
      .dialog_inner { /* 追加 */
        padding: 16px;
      }
```

JSでモーダルを開いているときに、クリックした要素を判定して、親要素に`.dialog_inner`がなければ閉じるようにします。

```javascript
      const modal = document.querySelector(".dialog");
      const openTrigger = document.querySelector(".btn.open");
      const closeTrigger = document.querySelector(".btn.close");
      const { body } = document;
      const MODAL_CLASS = "is-modal";

      openTrigger.addEventListener("click", () => {
        body.classList.add(MODAL_CLASS);
        modal.showModal();
      });
      closeTrigger.addEventListener("click", () => {
        body.classList.remove(MODAL_CLASS);
        modal.close();
      });
      modal.addEventListener("cancel", () => {
        body.classList.remove(MODAL_CLASS);
      });
      modal.addEventListener("click", (e) => { // <-追加
        if (!e.target.closest(".dialog_inner")) {
          body.classList.remove(MODAL_CLASS);
          modal.close();
        }
      });
```


## 補足
### open属性
dialog要素にはopen属性があります。

```html
<dialog class="dialog" open>
  <div class="dialog_inner">
    <p>dialog内のテキスト</p>
    <button class="btn close" type="button">閉じる</button>
  </div><!-- /.dialog_inner -->
</dialog>
```

open属性を付与するとモーダルが表示されますが、`::backdrop`（オーバーレイ）がない状態で表示されます。

### `show()`メソッド
`modal.showModal();`ではなく、`modal.show();`でもモーダルを開くことはできますが、
`::backdrop`（オーバーレイ）がない状態で表示されます。

### `open`プロパティ
`modal.open`でモーダルが開いているか閉じているか判定することができます。
`modal.open`の戻り値はboolean。

## まとめ
今までJSでやっていたことが、不要になるってスバラシイです！
dialog要素を使った実装についてまとめてみます。

### dialog要素の良いところ
- tabキーでモーダル開いた後に、tabキーを押すとオーバーレイより**下のレイヤーにフォーカスが当たらない**ので便利！（今までJSでやっていたものが不要に）
- 今までモーダルを開いたり閉じたりする実装は、クラスの付け替えで実装していたが、以下だけでモーダルを開いたり閉じたりできるのが直感的で便利！
    - `modal.close();`
    - `modal.showModal();`
    - `modal.show();`
- `showMolda()`で開いた時に疑似要素のbackdropがつく。CSSの`dialog::backdrop`でスタイリング可能！
- `modal.open`でモーダルが開いているか閉じているか判定ができる
- モーダル開いた状態で**ESCキーを押すとモーダルを閉じることができる！**（今までJSでやっていたものが不要に）
- ESCキーで閉じた時のイベントがある！`cancel`イベント

### 惜しいところ
- モーダルより下がスクロールしてしまうので、結局bodyのクラス付け替えが必要。。。
- オーバーレイ箇所をクリックした時の判定がないため、自作しなければならない。。。