Format ScrollReveal component and demo for improved readability and consistency

This commit is contained in:
David Haz
2025-07-12 12:05:16 +03:00
parent e5fc12d6fc
commit a0e049e447
3 changed files with 280 additions and 292 deletions

View File

@@ -1,5 +1,5 @@
import code from '@content/TextAnimations/ScrollReveal/ScrollReveal.vue?raw' import code from '@content/TextAnimations/ScrollReveal/ScrollReveal.vue?raw';
import type { CodeObject } from '../../../types/code' import type { CodeObject } from '../../../types/code';
export const scrollRevealCode: CodeObject = { export const scrollRevealCode: CodeObject = {
cli: `npx jsrepo add https://vue-bits.dev/ui/TextAnimations/ScrollReveal`, cli: `npx jsrepo add https://vue-bits.dev/ui/TextAnimations/ScrollReveal`,
@@ -23,4 +23,4 @@ export const scrollRevealCode: CodeObject = {
import ScrollReveal from "./ScrollReveal.vue"; import ScrollReveal from "./ScrollReveal.vue";
</script>`, </script>`,
code code
} };

View File

@@ -1,28 +1,21 @@
<template> <template>
<h2 ref="containerRef" :class="`my-5 ${containerClassName}`"> <h2 ref="containerRef" :class="`my-5 ${containerClassName}`">
<p <p :class="`leading-relaxed font-semibold ${textClassName}`" style="font-size: clamp(1.6rem, 4vw, 3rem)">
:class="`leading-relaxed font-semibold ${textClassName}`" <span v-for="(word, index) in splitText" :key="index" :class="word.isWhitespace ? '' : 'inline-block word'">
style="font-size: clamp(1.6rem, 4vw, 3rem);"
>
<span
v-for="(word, index) in splitText"
:key="index"
:class="word.isWhitespace ? '' : 'inline-block word'"
>
{{ word.text }} {{ word.text }}
</span> </span>
</p> </p>
</h2> </h2>
</template> </template>
<script setup lang="ts"> <script setup lang="ts">
import { ref, computed, onMounted, onUnmounted, watch } from 'vue'; import { ref, computed, onMounted, onUnmounted, watch } from 'vue';
import { gsap } from 'gsap'; import { gsap } from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger'; import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger); gsap.registerPlugin(ScrollTrigger);
interface Props { interface Props {
children: string; children: string;
scrollContainerRef?: { current: HTMLElement | null }; scrollContainerRef?: { current: HTMLElement | null };
enableBlur?: boolean; enableBlur?: boolean;
@@ -33,9 +26,9 @@
textClassName?: string; textClassName?: string;
rotationEnd?: string; rotationEnd?: string;
wordAnimationEnd?: string; wordAnimationEnd?: string;
} }
const props = withDefaults(defineProps<Props>(), { const props = withDefaults(defineProps<Props>(), {
enableBlur: true, enableBlur: true,
baseOpacity: 0.1, baseOpacity: 0.1,
baseRotation: 3, baseRotation: 3,
@@ -44,21 +37,21 @@
textClassName: '', textClassName: '',
rotationEnd: 'bottom bottom', rotationEnd: 'bottom bottom',
wordAnimationEnd: 'bottom bottom' wordAnimationEnd: 'bottom bottom'
}); });
const containerRef = ref<HTMLElement | null>(null); const containerRef = ref<HTMLElement | null>(null);
let scrollTriggerInstances: ScrollTrigger[] = []; let scrollTriggerInstances: ScrollTrigger[] = [];
const splitText = computed(() => { const splitText = computed(() => {
const text = typeof props.children === 'string' ? props.children : ''; const text = typeof props.children === 'string' ? props.children : '';
return text.split(/(\s+)/).map((word, index) => ({ return text.split(/(\s+)/).map((word, index) => ({
text: word, text: word,
isWhitespace: word.match(/^\s+$/) !== null, isWhitespace: word.match(/^\s+$/) !== null,
key: index key: index
})); }));
}); });
const initializeAnimation = () => { const initializeAnimation = () => {
const el = containerRef.value; const el = containerRef.value;
if (!el) return; if (!el) return;
@@ -66,9 +59,7 @@
scrollTriggerInstances = []; scrollTriggerInstances = [];
const scroller = const scroller =
props.scrollContainerRef && props.scrollContainerRef.current props.scrollContainerRef && props.scrollContainerRef.current ? props.scrollContainerRef.current : window;
? props.scrollContainerRef.current
: window;
const rotationTl = gsap.fromTo( const rotationTl = gsap.fromTo(
el, el,
@@ -81,8 +72,8 @@
scroller, scroller,
start: 'top bottom', start: 'top bottom',
end: props.rotationEnd, end: props.rotationEnd,
scrub: true, scrub: true
}, }
} }
); );
@@ -104,8 +95,8 @@
scroller, scroller,
start: 'top bottom-=20%', start: 'top bottom-=20%',
end: props.wordAnimationEnd, end: props.wordAnimationEnd,
scrub: true, scrub: true
}, }
} }
); );
@@ -126,8 +117,8 @@
scroller, scroller,
start: 'top bottom-=20%', start: 'top bottom-=20%',
end: props.wordAnimationEnd, end: props.wordAnimationEnd,
scrub: true, scrub: true
}, }
} }
); );
@@ -135,17 +126,17 @@
scrollTriggerInstances.push(blurTl.scrollTrigger); scrollTriggerInstances.push(blurTl.scrollTrigger);
} }
} }
}; };
onMounted(() => { onMounted(() => {
initializeAnimation(); initializeAnimation();
}); });
onUnmounted(() => { onUnmounted(() => {
scrollTriggerInstances.forEach(trigger => trigger.kill()); scrollTriggerInstances.forEach(trigger => trigger.kill());
}); });
watch( watch(
[ [
() => props.children, () => props.children,
() => props.scrollContainerRef, () => props.scrollContainerRef,
@@ -160,6 +151,5 @@
initializeAnimation(); initializeAnimation();
}, },
{ deep: true } { deep: true }
); );
</script> </script>

View File

@@ -1,15 +1,8 @@
<template> <template>
<TabbedLayout> <TabbedLayout>
<template #preview> <template #preview>
<div <div ref="containerRef" class="demo-container" @wheel="smoothScroll">
ref="containerRef" <div class="scroll-instruction">Scroll Down</div>
class="demo-container"
@wheel="smoothScroll"
>
<div class="scroll-instruction">
Scroll Down
</div>
<div class="scroll-content"> <div class="scroll-content">
<ScrollReveal <ScrollReveal
@@ -29,16 +22,19 @@
</div> </div>
<Customize> <Customize>
<PreviewSwitch <PreviewSwitch
title="Enable Hover" title="Enable Hover"
:model-value="enableBlur" :model-value="enableBlur"
@update:model-value="(val: boolean) => { enableBlur = val; forceRerender() }" @update:model-value="
(val: boolean) => {
enableBlur = val;
forceRerender();
}
"
/> />
<PreviewSlider title="Base Opacity:" v-model="baseOpacity" :min="0" :max="1" :step="0.1" value-unit="" /> <PreviewSlider title="Base Opacity:" v-model="baseOpacity" :min="0" :max="1" :step="0.1" value-unit="" />
<PreviewSlider title="Base Rotation:" v-model="baseRotation" :min="0" :max="10" :step="0.5" value-unit="deg" /> <PreviewSlider title="Base Rotation:" v-model="baseRotation" :min="0" :max="10" :step="0.5" value-unit="deg" />
<PreviewSlider title="Blur Strength:" v-model="blurStrength" :min="0" :max="10" :step="0.5" value-unit="px" /> <PreviewSlider title="Blur Strength:" v-model="blurStrength" :min="0" :max="10" :step="0.5" value-unit="px" />
</Customize> </Customize>
<PropTable :data="propData" /> <PropTable :data="propData" />
@@ -55,151 +51,153 @@
</template> </template>
<script setup lang="ts"> <script setup lang="ts">
import { ref, onMounted, onUnmounted } from 'vue' import { ref, onMounted, onUnmounted } from 'vue';
import { gsap } from 'gsap' import { gsap } from 'gsap';
import TabbedLayout from '../../components/common/TabbedLayout.vue' import TabbedLayout from '../../components/common/TabbedLayout.vue';
import PropTable from '../../components/common/PropTable.vue' import PropTable from '../../components/common/PropTable.vue';
import CliInstallation from '../../components/code/CliInstallation.vue' import CliInstallation from '../../components/code/CliInstallation.vue';
import CodeExample from '../../components/code/CodeExample.vue' import CodeExample from '../../components/code/CodeExample.vue';
import Customize from '../../components/common/Customize.vue' import Customize from '../../components/common/Customize.vue';
import ScrollReveal from '../../content/TextAnimations/ScrollReveal/ScrollReveal.vue' import ScrollReveal from '../../content/TextAnimations/ScrollReveal/ScrollReveal.vue';
import PreviewSlider from '../../components/common/PreviewSlider.vue' import PreviewSlider from '../../components/common/PreviewSlider.vue';
import PreviewSwitch from '../../components/common/PreviewSwitch.vue' import PreviewSwitch from '../../components/common/PreviewSwitch.vue';
import { scrollRevealCode } from '@/constants/code/TextAnimations/scrollRevealCode' import { scrollRevealCode } from '@/constants/code/TextAnimations/scrollRevealCode';
const containerRef = ref<HTMLElement | null>(null) const containerRef = ref<HTMLElement | null>(null);
const scrollText = ref("When does a man die? When he is hit by a bullet? No! When he suffers a disease? No! When he ate a soup made out of a poisonous mushroom? No! A man dies when he is forgotten!") const scrollText = ref(
const enableBlur = ref(true) 'When does a man die? When he is hit by a bullet? No! When he suffers a disease? No! When he ate a soup made out of a poisonous mushroom? No! A man dies when he is forgotten!'
const baseOpacity = ref(0.1) );
const baseRotation = ref(3) const enableBlur = ref(true);
const blurStrength = ref(4) const baseOpacity = ref(0.1);
const containerClassName = ref("") const baseRotation = ref(3);
const textClassName = ref("") const blurStrength = ref(4);
const rotationEnd = ref("bottom bottom") const containerClassName = ref('');
const wordAnimationEnd = ref("bottom bottom") const textClassName = ref('');
const rerenderKey = ref(0) const rotationEnd = ref('bottom bottom');
const wordAnimationEnd = ref('bottom bottom');
const rerenderKey = ref(0);
const forceRerender = () => { const forceRerender = () => {
rerenderKey.value++ rerenderKey.value++;
} };
const smoothScroll = (e: WheelEvent) => { const smoothScroll = (e: WheelEvent) => {
e.preventDefault() e.preventDefault();
const container = containerRef.value const container = containerRef.value;
if (!container) return if (!container) return;
const delta = e.deltaY || e.detail const delta = e.deltaY || e.detail;
const scrollAmount = delta * 2 const scrollAmount = delta * 2;
gsap.to(container, { gsap.to(container, {
scrollTop: container.scrollTop + scrollAmount, scrollTop: container.scrollTop + scrollAmount,
duration: 2, duration: 2,
ease: "power3.out", ease: 'power3.out',
overwrite: "auto" overwrite: 'auto'
}) });
} };
onMounted(() => { onMounted(() => {
const container = containerRef.value const container = containerRef.value;
if (container) { if (container) {
container.addEventListener('wheel', smoothScroll, { passive: false }) container.addEventListener('wheel', smoothScroll, { passive: false });
} }
}) });
onUnmounted(() => { onUnmounted(() => {
const container = containerRef.value const container = containerRef.value;
if (container) { if (container) {
container.removeEventListener('wheel', smoothScroll) container.removeEventListener('wheel', smoothScroll);
} }
}) });
const propData = [ const propData = [
{ {
name: 'children', name: 'children',
type: 'string', type: 'string',
default: '""', default: '""',
description: 'The text content to be animated word by word' description: 'The text content to be animated word by word'
}, },
{ {
name: 'scrollContainerRef', name: 'scrollContainerRef',
type: 'object', type: 'object',
default: 'undefined', default: 'undefined',
description: 'Ref to a custom scroll container (defaults to window)' description: 'Ref to a custom scroll container (defaults to window)'
}, },
{ {
name: 'enableBlur', name: 'enableBlur',
type: 'boolean', type: 'boolean',
default: 'true', default: 'true',
description: 'Whether to enable blur animation' description: 'Whether to enable blur animation'
}, },
{ {
name: 'baseOpacity', name: 'baseOpacity',
type: 'number', type: 'number',
default: '0.1', default: '0.1',
description: 'Starting opacity value for words' description: 'Starting opacity value for words'
}, },
{ {
name: 'baseRotation', name: 'baseRotation',
type: 'number', type: 'number',
default: '3', default: '3',
description: 'Starting rotation value in degrees' description: 'Starting rotation value in degrees'
}, },
{ {
name: 'blurStrength', name: 'blurStrength',
type: 'number', type: 'number',
default: '4', default: '4',
description: 'Blur strength in pixels' description: 'Blur strength in pixels'
}, },
{ {
name: 'containerClassName', name: 'containerClassName',
type: 'string', type: 'string',
default: '""', default: '""',
description: 'Additional CSS classes for the container element' description: 'Additional CSS classes for the container element'
}, },
{ {
name: 'textClassName', name: 'textClassName',
type: 'string', type: 'string',
default: '""', default: '""',
description: 'Additional CSS classes for the text element' description: 'Additional CSS classes for the text element'
}, },
{ {
name: 'rotationEnd', name: 'rotationEnd',
type: 'string', type: 'string',
default: '"bottom bottom"', default: '"bottom bottom"',
description: 'ScrollTrigger end position for rotation animation' description: 'ScrollTrigger end position for rotation animation'
}, },
{ {
name: 'wordAnimationEnd', name: 'wordAnimationEnd',
type: 'string', type: 'string',
default: '"bottom bottom"', default: '"bottom bottom"',
description: 'ScrollTrigger end position for word animations' description: 'ScrollTrigger end position for word animations'
} }
] ];
</script> </script>
<style scoped> <style scoped>
.demo-container { .demo-container {
height: 60vh; height: 60vh;
overflow-y: auto; overflow-y: auto;
} }
.scroll-content { .scroll-content {
padding-top: 150vh !important; padding-top: 150vh !important;
padding-bottom: 50vh; padding-bottom: 50vh;
} }
.scroll-instruction { .scroll-instruction {
text-align: center; text-align: center;
color: #271E37; color: #222;
font-size: clamp(4rem, 6vw, 4rem); font-size: clamp(4rem, 6vw, 4rem);
font-weight: 900; font-weight: 900;
position: absolute; position: absolute;
top: 50%; top: 50%;
left: 0; left: 0;
right: 0; right: 0;
transform: translateY(-50%); transform: translateY(-50%);
} }
.scroll-content { .scroll-content {
color: aliceblue; color: aliceblue;
} }
</style> </style>