【JavaScript】dispatchEvent の使い方!プログラムからイベントを強制発火させるテクニックとデモ
JavaScriptのイベント処理といえば、ユーザーのクリックや文字入力をきっかけに動くのが基本ですが、開発をしていると「プログラム側から好きなタイミングで強制的にイベントを発生(発火)させたい!」という場面に出くわすことがあります。
例えば、ボタンを押したときにテキストボックスの値(.value)をJSで自動入力したのに、連動しているはずの文字数カウンターや検索フィルターが反応してくれない……といったケースです。
そんな時に活躍するのが、対象の要素に対してイベントを発生させる dispatchEvent() メソッド です! 今回は、dispatchEvent の基本的な書き方から、よく使われる「フォーム連動テクニック」や「独自イベント(CustomEvent)の送信方法」まで、簡単に試せるデモと一緒に解説します!
デモ動作
See the Pen dispatchEventとは?プログラムからイベントを発火させる使い方 by mikanbako (@mikanbako) on CodePen.
demo: dispatchEventとは?プログラムからイベントを発火させる使い方
実装コード紹介
【HTML】
<div class="l-wrap">
<h2>dispatchEvent 実践比較デモ</h2>
<p class="p-desc">プログラムから強制的にイベントを発火させる2つの実用パターンを試してみよう!</p>
<div class="p-demo-box">
<!-- 💡 デモ1:標準イベント(input)の強制発火 -->
<section class="p-section">
<h3 class="c-sec-title">① 定番:JSで値を書き換えて input イベントを連動させる</h3>
<p class="c-sec-desc">テキスト欄には <code>input</code> イベントで動く「文字数カウンター」と「プレビュー」が設定されています。</p>
<input type="text" class="c-input js-text-input" placeholder="ここに直接入力すると下がリアルタイム更新されます">
<div class="c-preview-bar">
<span>プレビュー: <strong class="js-preview-text">(未入力)</strong></span>
<span class="c-badge">文字数: <strong class="js-char-count">0</strong> 文字</span>
</div>
<div class="c-btn-group">
<button class="c-btn c-btn--bad js-btn-no-dispatch">
❌ 値(.value)だけ書き換える<br><small>※イベントが起きず表示がズレる!</small>
</button>
<button class="c-btn c-btn--good js-btn-with-dispatch">
⭕ 書き換え + dispatchEvent<br><small>※inputイベントが発火して連動!</small>
</button>
</div>
</section>
<!-- 💡 デモ2:CustomEvent(独自イベント+データ送信) -->
<section class="p-section">
<h3 class="c-sec-title">② 応用:CustomEvent で独自イベントとデータを飛ばす</h3>
<p class="c-sec-desc"><code>item-added</code> というオリジナルイベントを作り、商品名と価格データを乗せて発火させます。</p>
<div class="c-notify-box js-notify-box">
🛒 カート通知エリア(独自イベントを待機中...)
</div>
<div class="c-btn-group">
<button class="c-btn c-btn--item js-btn-custom" data-name="特製コーヒー" data-price="450">
☕ 特製コーヒー (450円) を発火
</button>
<button class="c-btn c-btn--item js-btn-custom" data-name="濃厚チーズケーキ" data-price="680">
🍰 濃厚チーズケーキ (680円) を発火
</button>
</div>
</section>
</div>
</div>
【CSS】
/* ベース装飾 */
.l-wrap {
padding: 30px 15px;
max-width: 650px;
margin: 0 auto;
color: #3e3e3e;
text-align: center;
}
h2 {
margin-bottom: 10px;
font-size: 16px;
color: #1bb4d4;
}
.p-desc {
margin-bottom: 25px;
font-size: 16px;
font-weight: bold;
color: #666;
line-height: 1.6;
}
.p-demo-box {
display: flex;
flex-direction: column;
gap: 30px;
padding: 30px;
text-align: left;
background: #fff;
border-radius: 12px;
box-shadow: 0 4px 15px rgb(0 0 0 / 5%);
}
/* セクション共通 */
.p-section {
padding: 20px;
background: #f8f9fa;
border: 1px solid #e9ecef;
border-radius: 8px;
}
.c-sec-title {
padding-left: 10px;
margin-bottom: 6px;
font-size: 16px;
color: #1bb4d4;
border-left: 4px solid #1bb4d4;
}
.c-sec-desc {
margin-bottom: 15px;
font-size: 14px;
color: #666;
}
.c-sec-desc code {
padding: 2px 6px;
font-size: 14px;
font-weight: bold;
color: #e83e8c;
background: #e9ecef;
border-radius: 4px;
}
/* デモ1:入力欄とプレビューバー */
.c-input {
width: 100%;
padding: 12px;
margin-bottom: 12px;
font-family: inherit;
font-size: 15px;
outline: none;
border: 2px solid #ccc;
border-radius: 6px;
transition: 0.2s;
}
.c-input:focus {
border-color: #1bb4d4;
}
.c-preview-bar {
display: flex;
align-items: center;
justify-content: space-between;
padding: 12px 15px;
margin-bottom: 15px;
font-size: 15px;
background: #fff;
border: 2px solid #dee2e6;
border-radius: 6px;
transition: 0.2s;
}
.c-preview-bar.is-updated {
background: #f0fbfc;
border-color: #1bb4d4;
}
.c-preview-bar strong {
color: #1bb4d4;
}
.c-badge {
padding: 4px 10px;
font-size: 14px;
color: #fff;
background: #333;
border-radius: 20px;
}
.c-badge strong {
font-family: monospace;
font-size: 16px;
color: #ffc107;
}
/* デモ2:通知ボックス */
.c-notify-box {
padding: 18px;
margin-bottom: 15px;
font-size: 14px;
font-weight: bold;
color: #555;
text-align: center;
background: #fff;
border: 2px dashed #adb5bd;
border-radius: 8px;
transition: 0.25s;
}
.c-notify-box.is-active {
color: #d6336c;
background: #fff0f6;
border-color: #e83e8c;
border-style: solid;
transform: scale(1.02);
}
/* ボタングループ */
.c-btn-group {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 10px;
}
.c-btn {
padding: 12px 10px;
font-family: inherit;
font-size: 14px;
font-weight: bold;
line-height: 1.4;
color: #fff;
cursor: pointer;
border: none;
border-radius: 6px;
transition: 0.2s;
}
.c-btn small {
font-size: 12px;
font-weight: normal;
opacity: 0.9;
}
.c-btn:hover {
opacity: 0.85;
transform: translateY(-2px);
}
.c-btn--bad {
background: #6c757d;
}
.c-btn--good {
background: #1bb4d4;
}
.c-btn--item {
background: #e83e8c;
}
【JavaScript】
// =========================================
// 💡 デモ1:input イベントの強制発火
// =========================================
const textInput = document.querySelector('.js-text-input');
const previewText = document.querySelector('.js-preview-text');
const charCount = document.querySelector('.js-char-count');
const previewBar = document.querySelector('.c-preview-bar');
// 通常の input イベントリスナー(手入力された時に動く処理)
textInput.addEventListener('input', (e) => {
const val = e.target.value;
previewText.textContent = val || '(未入力)';
charCount.textContent = val.length;
// 更新されたことがわかりやすいように一瞬ハイライト
previewBar.classList.add('is-updated');
setTimeout(() => previewBar.classList.remove('is-updated'), 300);
});
// ❌ パターンA:ただ .value を書き換えるだけ(イベントは発火しない)
document.querySelector('.js-btn-no-dispatch').addEventListener('click', () => {
textInput.value = '定型文A(イベント未発火)';
// ⚠️ ここで処理を終えると、上の addEventListener('input', ...) は動きません!
});
// ⭕ パターンB:.value を書き換えた後に dispatchEvent で input イベントを発火!
document.querySelector('.js-btn-with-dispatch').addEventListener('click', () => {
textInput.value = '定型文B(dispatchEventで連動!)';
// 1. 発生させたい「inputイベント」のオブジェクトを作成
const event = new Event('input', { bubbles: true });
// 2. テキスト入力欄に対してイベントを強制発火させる!
textInput.dispatchEvent(event);
});
// =========================================
// 💡 デモ2:CustomEvent(独自イベント+データ送信)
// =========================================
const notifyBox = document.querySelector('.js-notify-box');
const customBtns = document.querySelectorAll('.js-btn-custom');
// 1. 通知ボックス側で、独自イベント「item-added」を待ち受ける
notifyBox.addEventListener('item-added', (e) => {
// e.detail の中に、発火側から渡されたカスタムデータが入っている!
const { name, price } = e.detail;
notifyBox.textContent = `🎉 独自イベント受信!「${name}(${price}円)」が追加されました!`;
notifyBox.classList.remove('is-active');
setTimeout(() => notifyBox.classList.add('is-active'), 200);
});
// 2. ボタンクリック時に、データを乗せた CustomEvent を作成して発火させる
customBtns.forEach(btn => {
btn.addEventListener('click', () => {
const itemName = btn.dataset.name;
const itemPrice = Number(btn.dataset.price);
// detail プロパティに任意のオブジェクトデータを入れて独自イベントを作成!
const customEvent = new CustomEvent('item-added', {
detail: { name: itemName, price: itemPrice }
});
// 通知ボックスに対して独自イベントを発火!
notifyBox.dispatchEvent(customEvent);
});
});
dispatchEventの基本と2つの活用パターン
dispatchEvent() の基本構文(2ステップで発火!)
プログラムからイベントを発生させるには、「① イベントオブジェクトを作る(new Event)」 ➔ 「② 対象の要素で発火させる(要素.dispatchEvent)」という2ステップで行います。
// 1. 発生させたいイベント名('click', 'input', 'change' など)を指定して生成
const event = new Event('input', {
bubbles: true, // 親要素へイベントを伝播(バブリング)させるか(初期値: false)
cancelable: true // preventDefault() でキャンセル可能にするか(初期値: false)
});
// 2. 対象のDOM要素に対してイベントを発火!
targetElement.dispatchEvent(event);
※第2引数の { bubbles: true } は省略可能ですが、親要素でイベントをまとめて監視している場合(イベントデリゲーション)などにもしっかり届くよう、bubbles: true をつけておくのがおすすめです!
いつ使うの?活躍する場面①:JSでフォームの値を変えた時の連動
初心者が最もつまずきやすいのが、「JavaScriptで input.value = '〇〇' と値を書き換えても、input イベントや change イベントは自動では発火しない」というブラウザの仕様です。
例えば、手入力した時に文字数を数えたり入力チェックを行うイベントリスナーがすでにある場合、「クリアボタン」や「定型文挿入ボタン」を作った際に dispatchEvent を使うと、同じ処理を2回書くことなく既存のイベントリスナーをそのまま動かすことができます!
const searchInput = document.querySelector('#search');
// 検索窓を空にして、既存の input イベント(検索結果のリセット処理など)をそのまま動かす!
clearBtn.addEventListener('click', () => {
searchInput.value = '';
searchInput.dispatchEvent(new Event('input', { bubbles: true }));
});
※ちなみに「クリック(click)」だけは特別に element.click() という専用ショートカットメソッドが用意されていますが、input や change、focus などには専用の発火メソッドがないため、この dispatchEvent が必須になります!
いつ使うの?活躍する場面②:CustomEvent で独自イベント&データを送る
標準のイベントだけでなく、new CustomEvent() を使うことで、cart-updated や modal-closed といった「自分だけのオリジナルイベント」を作って発火させることも可能です。
最大のメリットは、第2引数の detail プロパティ に好きなデータ(オブジェクトや配列など)を乗せて、受け取り側の event.detail へ渡せる点です!
// 【受信側】独自イベント 'user-login' を待ち受ける
document.addEventListener('user-login', (event) => {
// event.detail から渡されたデータを取り出せる!
console.log(`${event.detail.userName} さんがログインしました!`);
});
// 【発火側】detail にデータを詰めて CustomEvent を発火する
const loginEvent = new CustomEvent('user-login', {
detail: { userName: '田中', role: 'admin' }
});
document.dispatchEvent(loginEvent);
複数のJSファイルや離れたUIパーツ同士で、「Aの処理が終わったらBにデータを渡して動かす」といった連携をスッキリ実装したい時に非常に重宝します。
補足:公式ドキュメント
まとめ
今回はプログラムから任意のタイミングでイベントを発生させる dispatchEvent() について解説しました。
- 基本は
new Event('イベント名')を作って要素.dispatchEvent(event)で発火させる - JSで
.valueを書き換えた後にinputやchangeイベントを連動させたい時に便利! new CustomEvent('独自名', { detail: データ })を使えば、データ付きのオリジナルイベントも作れる
一見マニアックに見えるメソッドですが、「JSから値を変更したのに画面の表示が連動しない!」というあるあるなトラブルをたった1行で解決してくれる頼もしい機能です。ぜひデモを動かして、その便利な挙動を体感してみてくださいね!