アニメーション・オン・スクロール スキル
ワークフロー
- アニメーションのスタイル、タイミング、およびアニメーションを1回だけ実行するか繰り返すかを確認します。
- キーフレームと JS オブザーバースニペット、および適用する正確な Tailwind クラスを提供します。
- しきい値、rootMargin、持続時間、遅延、transform/blur 値などの調整のみに集中します。
使用チェックリスト
- JS スニペットをキーフレームの後に
<head> 内に挿入します。
- 要素にアニメーションクラスと
animate-on-scroll を追加します。
- キーフレーム名が Tailwind アニメーションの参照と一致していることを確認します。
IntersectionObserver トリガー
<script>
(function () {
const style = document.createElement("style");
style.textContent = `
/* デフォルト:一時停止 */
.animate-on-scroll { animation-play-state: paused !important; }
/* JS によってアクティブ化 */
.animate-on-scroll.animate { animation-play-state: running !important; }
`;
document.head.appendChild(style);
const once = true;
if (!window.__inViewIO) {
window.__inViewIO = new IntersectionObserver((entries) => {
entries.forEach((entry) => {
if (entry.isIntersecting) {
entry.target.classList.add("animate");
if (once) window.__inViewIO.unobserve(entry.target);
}
});
}, { threshold: 0.2, rootMargin: "0px 0px -10% 0px" });
}
window.initInViewAnimations = function (selector = ".animate-on-scroll") {
document.querySelectorAll(selector).forEach((el) => {
window.__inViewIO.observe(el);
});
};
document.addEventListener("DOMContentLoaded", () => initInViewAnimations());
})();
</script>
キーフレーム
<style>
@keyframes animationIn {
0% {
opacity: 0;
transform: translateY(30px);
filter: blur(8px);
}
100% {
opacity: 1;
transform: translateY(0);
filter: blur(0px);
}
}
</style>
Tailwind の例
<div class="animate-on-scroll [animation:animationIn_0.8s_ease-out_0.1s_both]">
...
</div>
カスタマイズのつまみ
- トリガー:
threshold と rootMargin を調整して、表示タイミングを早めたり遅くしたりします。
- 繰り返し:
once = false に設定すると、再表示されたときにアニメーションを再実行できます。
- モーション:キーフレーム内の
translateY と blur を調整します。
- タイミング:Tailwind アニメーション値の duration と delay を変更します。
よくある落とし穴
- JS スニペットの前にキーフレームを挿入するのを忘れる。
- Tailwind アニメーションと異なるキーフレーム名を使用する。
- オブザーバーが初期化される前に要素がすでにビューポート内にあるため、アニメーションが実行されない。
仕様が不足している場合の質問項目
- アニメーションは一度だけ実行しますか、それとも要素が再表示されるたびに実行しますか?
- 要素がビューポートに入るどのくらい前からアニメーションを開始しますか?
- どのようなモーションスタイル(フェード、スライド、ブラー、スケール)にしますか?