Gradual Spacing

Word animation for gradual spacing between letters

G

r

a

d

u

a

l

 

S

p

a

c

i

n

g

Edit on GitHub

Copy code

Show code

<script setup lang="ts">
import GradualSpacing from "@/components/gradual-spacing/gradual-spacing.vue";
</script>

<template>
  <div class="grid place-items-center w-full min-h-screen">
    <GradualSpacing
      class="font-sans text-center text-4xl font-bold tracking-[-0.1em] text-black md:text-7xl md:leading-[5rem]"
      text="Gradual Spacing"
    />
  </div>
</template>

Installation

Copy and paste the following code into your project:

gradual-spacing.vue

<script setup lang="ts">
import { cn } from "@/lib/utils";

interface Variants {
  hidden: { opacity: number; x: number };
  visible: { opacity: number; x: number };
}
interface GradualSpacingProps {
  text: string;
  duration?: number;
  delayMultiple?: number;
  motionProps?: Variants;
  class?: string;
}

const props = withDefaults(defineProps<GradualSpacingProps>(), {
  duration: 50,
  delayMultiple: 40,
  motionProps: () => ({
    hidden: { opacity: 0, x: -20 },
    visible: { opacity: 1, x: 0 },
  }),
});

const letters = props.text.split("");

const className = cn("drop-shadow-sm ", props.class);
</script>

<template>
  <div class="flex justify-center space-x-1">
    <div v-for="(char, index) in letters" :key="index">
      <h1
        v-motion
        :initial="props.motionProps.hidden"
        :visible="{
          ...props.motionProps.visible,
          transition: {
            duration: props.duration,
            delay: index * props.delayMultiple,
          },
        }"
        :class="className"
      >
        <span v-if="char === ' '">&nbsp;</span>
        <span v-else>{{ char }}</span>
      </h1>
    </div>
  </div>
</template>

Props

Prop	Type	Description	Default
class	string	The class to be applied to the component
duration	number	Duration of the animation	0.5
delayMultiple	number	Transition delay multiplier.	0.1
text	string	An array of words to rotate through	""
motionProps	HTMLMotionProps	An object containing motion animation props	{}