Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

付録B Turbo 属性・イベント一覧

本書で扱った Turbo の主な属性・meta タグ・イベントを、引きやすいようにまとめます。網羅的な一覧と最新の仕様は、公式リファレンスで確認してください。

主な data 属性

属性役割主な登場章
data-turbo="false"要素や範囲で Turbo を無効化する(内側で "true" に戻せる)第7章
data-turbo-track="reload"追跡対象のアセットが変わったらフルリロードする第7章
data-turbo-action="advance"frame の差し替えで URL も更新する第14章・第23章
data-turbo-frameリンク/フォームの差し替え先 frame を指定(_top でページ全体)第11章
data-turbo-permanentページが変わっても要素を保持する(id が必要)第9章
data-turbo-temporaryキャッシュ前に要素を取り除く(プレビューに残さない)第9章
data-turbo-confirm操作前に確認ダイアログを出す第10章
data-turbo-methodリンクのリクエストメソッドを変える第10章
data-turbo-streamGET でも Turbo Streams を受け取る(opt-in)第15章・第24章
data-turbo-submits-with送信中の送信ボタンの文言を差し替える第25章

主な meta タグ

meta タグ役割主な登場章
<meta name="turbo-refresh-method" content="morph">page refresh を morph で行う(既定 replace第9章
<meta name="turbo-refresh-scroll" content="preserve">page refresh でスクロール位置を保つ(既定 reset第9章
<meta name="turbo-cache-control" content="no-cache">ページをキャッシュしない第9章
<meta name="turbo-cache-control" content="no-preview">プレビュー表示だけ止める第9章

主なイベント(すべて document で発火)

イベントタイミング主な登場章
turbo:clickTurbo 有効なリンクをクリックした第10章
turbo:before-visitvisit を始める直前(preventDefault で中断可)第10章
turbo:visitvisit を始めた第10章
turbo:before-render新しい body を描画する直前第10章
turbo:render描画した第10章
turbo:loadページ読み込みが完了した(初回と各 visit 後)第10章
turbo:before-cacheスナップショットを保存する直前第9章
turbo:submit-startフォーム送信が始まった第10章・第25章
turbo:submit-endフォーム送信が終わった(detail.success を含む)第10章
turbo:frame-loadframe の読み込みが完了した第29章
turbo:frame-renderframe を描画した第29章
turbo:before-morph-element要素を morph する直前(preventDefault でスキップ可)第10章
turbo:morphmorph が終わった第10章

値の正確な指定や、ここに載せていない属性・イベントは、必ず公式リファレンスで確認してください。Turbo のバージョンによって追加・変更されることがあります。