GSAP Studio / Syntax Reference(構文リファレンス)

ScrollTrigger start・endの決め方

trigger要素とviewportの位置関係、scroll距離、pin・scrub・refresh方針を同じScroll Contractで管理します。

GST-REF-002 v1.0.0 ツールで試す

Direct answer

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

trigger要素とviewportの位置関係、scroll距離、pin・scrub・refresh方針を同じScroll Contractで管理します。

入力式を文字列として解析し、許可した構文だけを決定論的な結果へ変換します。任意JavaScript、function、外部URLの取得は行いません。

Reference facts

固定値・入力・判定結果

Start(開始)
例: top center / top top
End(終了)
例: +=2400 / bottom top
Preview(表示)
start・end markerとscene range
Production(本番)
markers false / resize・font・image load後にrefresh確認

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(ロールバック)は元に戻す手順です。