Alpine.jsで軽量なインタラクションを実装するハンズオン

概要

「トグル表示」「タブ切り替え」「モーダル」程度のインタラクションのために、React や Vue をビルド込みで導入するのは重い——そんな場面で便利なのが Alpine.js です。

Alpine.js は、HTML 属性にそのままロジックを書ける軽量な JavaScript フレームワークです。CDN の <script> タグ1行で動き、ビルドツールも不要。Vue の Directive に近い書き味で、JavaScript のバンドルサイズは gzip でおよそ 15KB 前後と小さいのが特徴です。

この記事では、サーバーサイドレンダリング(Laravel の Blade や Rails の ERB、あるいは素の HTML)が主役のプロジェクトに「ちょい足し」でインタラクションを加えることを想定し、代表的なパターンを手を動かしながら実装していきます。

環境

  • Alpine.js v3 系(CDN 読み込み)
  • モダンブラウザ(ES6 対応環境)
  • ビルドツール不要

まずは最小構成です。defer 属性を付けて読み込むのがポイントで、これにより HTML のパースが完了してから Alpine が初期化されます。

<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Alpine.js Handson</title>
  <script defer src="https://cdn.jsdelivr.net/npm/alpinejs@3.x.x/dist/cdn.min.js"></script>
</head>
<body>
  <!-- ここに実装していく -->
</body>
</html>

本番運用では @3.x.x のようなワイルドカードではなく、@3.14.1 のように固定バージョンを指定するか、npm でインストールしてセルフホストするのが安全です。CDN の内容が予告なく変わるリスクを避けられます。

Alpine.js の基本ディレクティブ

ディレクティブ 役割
x-data コンポーネントのスコープと状態を定義する。Alpine の起点
x-show 真偽値で要素の表示/非表示を切り替える(display を操作)
x-if 真のときだけ DOM に要素を生成する(<template> 必須)
x-on: / @ イベントリスナを登録する(@click など)
x-bind: / : 属性を動的にバインドする(:class など)
x-model フォーム入力と状態を双方向バインドする
x-text / x-html 要素のテキスト/HTML を状態から描画する
x-transition 表示切り替えにアニメーションを付ける

x-data が全ての起点です。この属性を持つ要素とその子孫が、ひとつの Alpine コンポーネントのスコープになります。

実装例

1. トグル表示(アコーディオン)

<div x-data="{ open: false }">
  <button @click="open = !open">詳細を見る</button>
  <div x-show="open" x-transition>
    <p>ここに詳細な内容が入ります。open が true のときだけ表示されます。</p>
  </div>
</div>

x-transition を付けるだけで、フェードとスライドのアニメーションが自動で付きます。細かく制御したい場合は次のように書けます。

<div
  x-show="open"
  x-transition:enter="transition ease-out duration-300"
  x-transition:enter-start="opacity-0 transform -translate-y-2"
  x-transition:enter-end="opacity-100 transform translate-y-0"
  x-transition:leave="transition ease-in duration-200"
  x-transition:leave-start="opacity-100"
  x-transition:leave-end="opacity-0"
>
  内容
</div>

x-show と x-if の使い分け

  • x-show は要素を常に DOM に残し、CSS の display: none で隠す。切り替えが頻繁な UI 向き。
  • x-if は条件が偽のとき DOM から要素を取り除く。重い要素向き。<template> タグで包む必要がある。
<div x-data="{ open: false }">
  <button @click="open = !open">切り替え</button>
  <template x-if="open">
    <div>このブロックは open が true のときだけ DOM に生成されます</div>
  </template>
</div>

2. タブ切り替え

<div x-data="{ tab: 'profile' }">
  <nav>
    <button @click="tab = 'profile'" :class="{ 'active': tab === 'profile' }">プロフィール</button>
    <button @click="tab = 'settings'" :class="{ 'active': tab === 'settings' }">設定</button>
  </nav>
  <div x-show="tab === 'profile'">プロフィールの内容</div>
  <div x-show="tab === 'settings'">設定の内容</div>
</div>

<style>
  .active { font-weight: bold; border-bottom: 2px solid #3490dc; }
</style>

3. モーダルダイアログ

モーダルでは「背景クリックで閉じる」「Esc キーで閉じる」「本体クリックでは閉じない」を実装するのが定番です。Alpine ならイベント修飾子でシンプルに書けます。

<div x-data="{ modalOpen: false }">
  <button @click="modalOpen = true">モーダルを開く</button>

  <div
    x-show="modalOpen"
    @click.self="modalOpen = false"
    @keydown.escape.window="modalOpen = false"
    x-transition.opacity
    class="overlay"
  >
    <div class="modal" @click.stop>
      <h2>確認</h2>
      <p>この操作を実行してよろしいですか?</p>
      <button @click="modalOpen = false">閉じる</button>
    </div>
  </div>
</div>

<style>
  .overlay {
    position: fixed; inset: 0;
    background: rgba(0,0,0,.5);
    display: flex; align-items: center; justify-content: center;
  }
  .modal { background: #fff; padding: 2rem; border-radius: 8px; }
</style>
  • @click.self — イベントの target が要素自身のときだけ発火。子要素クリックでは発火しない
  • @click.stop — event.stopPropagation() の省略形。伝播を止める
  • @keydown.escape.window — window に対して Esc キーを監視

4. フォームのリアルタイムバリデーション

<div x-data="{
  email: '',
  get isValid() {
    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(this.email);
  }
}">
  <input type="email" x-model="email" placeholder="メールアドレス">
  <p x-show="email.length > 0 && !isValid" style="color: red;">
    メールアドレスの形式が正しくありません
  </p>
  <button :disabled="!isValid">送信</button>
</div>

get isValid() のように getter を定義すると、email が変わるたびに自動で再評価されます。

5. ロジックを外出しする(Alpine.data)

<div x-data="counter">
  <button @click="decrement">-</button>
  <span x-text="count"></span>
  <button @click="increment">+</button>
</div>

<script>
  document.addEventListener('alpine:init', () => {
    Alpine.data('counter', () => ({
      count: 0,
      increment() { this.count++; },
      decrement() { if (this.count > 0) this.count--; },
    }));
  });
</script>

alpine:init イベント内で登録するのがポイントです。Alpine の初期化前に Alpine.data() を呼ぶ必要があるためです。

確認方法

  1. 上記 HTML を1ファイルに保存し、ブラウザで直接開く(サーバー不要)。
  2. ボタンクリックで表示が切り替わること、モーダルが Esc とオーバーレイクリックで閉じること、フォームが入力に応じてバリデーションすることを確認する。
  3. 開発者ツールで、x-show が display: none を付け外ししていること、x-if が DOM ノードを生成/削除していることを確認する。

注意点

  • CDN のバージョン固定: ワイルドカードは本番では避け、固定バージョンかセルフホストにする。
  • FOUC(初期チラつき)対策: x-cloak 属性を付け、CSS で [x-cloak] { display: none !important; } を定義すると、初期化完了まで非表示にできる。
  • 大規模 SPA には不向き: ルーティングや複雑な状態管理が必要なアプリには React/Vue が適する。
  • x-html は XSS に注意: 外部由来の文字列を x-html に渡さない。必要なら x-text を使う。

まとめ

Alpine.js は「ビルドなしで、HTML に少しだけインタラクションを足す」用途に最適なフレームワークです。トグル・タブ・モーダル・簡易バリデーションといった定番 UI は、x-data / x-show / @click / x-model の数個のディレクティブで完結します。React や Vue を入れるほどではないが素の DOM 操作は書きたくない、というちょうど中間のニーズにきれいにハマります。まずは CDN 1行から試してみてください。

\ 最新情報をチェック /

コメントを残す

このサイトはスパムを低減するために Akismet を使っています。コメントデータの処理方法の詳細はこちらをご覧ください。