classを切り替えて表示を変える

メニューの開閉のような表示の切り替えは、JavaScriptでclassを付け外しし、見た目はCSSで指定する形が基本です。

まずこれだけ

開いた状態などの見た目はCSSでclassごとに用意し、JavaScriptはclassListでclassを付け外しするだけにします。役割を分けると修正しやすくなります。

表示の変更はclassの付け外しで行う

JavaScriptで見た目を変える方法はいくつかありますが、基本はclassの付け外しです。変化した後の見た目をCSSでclassとして用意しておき、JavaScriptはそのclassを要素に付けたり外したりします。

こうすると、見た目はCSS、切り替えのタイミングはJavaScriptと役割がはっきり分かれます。デザインを変えたいときは、CSSだけを直せば済みます。

簡単にいうと

見た目はCSSで用意し、JavaScriptはclassを付け外しして切り替えるだけにします。

classListでclassを操作する

要素のclassは classList を使って操作します。取得した要素の後に点を付けて、次の命令を書きます。

  • add("is-open"):classを追加する
  • remove("is-open"):classを外す
  • toggle("is-open"):付いていれば外し、なければ付ける
  • contains("is-open"):付いているかを調べる

classListで操作すると、要素にもともと付いている他のclassはそのまま残ります。追加や削除の対象になるのは、指定したclassだけです。

class名を指定するときは、CSSのセレクタのような先頭の点は付けません。".is-open" と書くと、点を含んだ別の名前として扱われます。

メニュー開閉の基本の形

ボタンを押すとメニューが開き、もう一度押すと閉じる動きは、次の3つの部分で作ります。

HTML
開閉ボタンと、メニュー本体の要素を用意する
CSS
通常は非表示、is-openが付いたら表示する指定を書く
JavaScript
ボタンのクリックでメニューのis-openを切り替える

アコーディオンやタブ、モーダルも、対象とclassが変わるだけで同じ形で作れます。

CSSで切り替え後の見た目を用意する

CSSでは、メニューの通常の状態を display: none などで非表示にしておきます。そのうえで、.menu.is-open のように、classが付いたときの指定を別に書きます。

classが付いたときだけ display: block にすれば、JavaScriptがclassを付けた瞬間にメニューが表示されます。表示の切り替えに動きを付けたい場合も、CSSの指定を変えるだけで対応できます。

JavaScriptでclassを切り替える

JavaScript側では、ボタンとメニューをquerySelectorで取得します。次に、ボタンにクリックのイベント処理を登録し、その中で menu.classList.toggle() を実行します。

toggleを使えば、開いているか閉じているかを自分で判定する必要がありません。クリックのたびにclassが付いたり外れたりして、開閉が交互に切り替わります。

「閉じる」ボタンのように、必ず閉じたい場面ではremoveを使います。目的に合わせてtoggleとadd、removeを使い分けます。

開閉の状態を属性でも伝える

見た目だけでなく、ボタンに aria-expanded 属性を付けて開閉の状態を示しておくと、読み上げソフトを使う人にも状態が伝わります。

開いたときは値を「true」、閉じたときは「false」にします。classを切り替える処理の中で、setAttributeを使って一緒に書き換えるのが一般的です。

styleを直接書き換えない理由

JavaScriptでは、menu.style.display のように見た目を直接書き換えることもできます。しかしこの方法では、見た目の指定がJavaScriptの中に散らばり、デザインを変えるたびにコードを探して直す必要があります。

また、直接書き換えた指定は優先順位が高く、CSSでの調整が効きにくくなります。表示の切り替えは、classを使う方法を基本にします。

まとめ

表示の切り替えは、切り替え後の見た目をCSSでclassとして用意し、JavaScriptのclassListで付け外しする形が基本です。メニュー、アコーディオン、タブなど多くの動きがこの同じ形で作れます。