GSAP Studio / Callback Contract(通知契約)

onInterrupt callback

中断時に通知するGSAP callbackです。関数本文は保存せず、安全なpayload契約だけを出力します。

GST-CALLBACK-ONINTERRUPT v1.0.0 ツールで試す

Direct answer

何を決めるための項目ですか?

中断時に通知するGSAP callbackです。関数本文は保存せず、安全なpayload契約だけを出力します。

onInterrupt は「中断時」の通知です。保存できるpayloadは event name only に限定し、任意の関数本文を実行しません。

Reference facts

固定値・入力・判定結果

Callback(通知名)
onInterrupt
Meaning(日本語)
中断時
Safe payload(許可データ)
event name only
Runtime(実装方針)
CustomEventへ変換し、任意codeを評価しない

Positive and negative examples

安全な入力と失敗時の扱い

  • 許可した値は固定IDとversionを保ったままAnimation Projectへ保存します。
  • 構文エラー、未知label、危険selector、非有限値は固定Rule ID付きfindingとして返します。
  • callbackはallowlist、easeはcatalog、positionはparserの対応文法に限定します。
  • 入力値をJavaScript、HTML、外部通信として実行せず、生成コードは文字列としてプレビューします。

Safe workflow

本番へ入れる前の共通確認

  1. TimelineをPlay・Pause・Reverse・Restart・Seekし、開始・終了時間とlabelを確認します。
  2. Scroll Storyはstart・end marker、scene範囲、pin、scrub、snapをDesktopとMobileで確認します。
  3. Reduced Motionでpin・scrubが無効になり、本文と操作要素が見える最終状態になることを確認します。
  4. Quality FindingのRule ID、evidence、severity、warning、lossを解消または記録します。
  5. 実サイト上でbrowser、resize、font・image load、性能、cleanup、rollbackを確認します。

Terms

英語表記の意味

Target(ターゲット)は動かす対象、Track(トラック)は対象ごとの時間レーン、Tween(トゥイーン)は値の変化、Scene(シーン)はScroll Storyの場面、Evidence(エビデンス)は判定根拠、Loss(ロス)は出力先で完全に表現できない差、Cleanup(クリーンアップ)はanimationとScrollTriggerを破棄する処理、Rollback(ロールバック)は元に戻す手順です。