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() を呼ぶ必要があるためです。
確認方法
- 上記 HTML を1ファイルに保存し、ブラウザで直接開く(サーバー不要)。
- ボタンクリックで表示が切り替わること、モーダルが Esc とオーバーレイクリックで閉じること、フォームが入力に応じてバリデーションすることを確認する。
- 開発者ツールで、
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行から試してみてください。
