Skip to content
MarkasUI
Type to search

    Guide

    MarkasUI

    Form

    Feedback

    Overlay

    Navigation

    Data

    Sections

    Animations

    Backgrounds

    Buttons

    Templates

    Pages

    Letter Swap

    Text whose letters slide out and back in with a stagger when its link or button is hovered or focused. Forward, ping-pong, or shuffled order.

    Markas
    <header class="flex items-center justify-between rounded-xl border border-line bg-surface px-5 py-3">
        <span class="text-sm font-semibold text-ink">Markas</span>
        <nav aria-label="Main" class="flex items-center gap-5 text-sm font-medium text-muted">
            <a href="#" class="rounded-sm text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"><x-markas.letter-swap text="Products" /></a>
            <a href="#" class="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"><x-markas.letter-swap text="Pricing" /></a>
            <a href="#" class="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"><x-markas.letter-swap text="Docs" /></a>
            <a href="#" class="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"><x-markas.letter-swap text="Blog" /></a>
        </nav>
    </header>
    import { LetterSwap } from "@/components/markas/LetterSwap";
    
    export default function LetterSwapExample() {
      return (
        <header className="flex items-center justify-between rounded-xl border border-line bg-surface px-5 py-3">
          <span className="text-sm font-semibold text-ink">Markas</span>
          <nav
            aria-label="Main"
            className="flex items-center gap-5 text-sm font-medium text-muted"
          >
            <a
              href="#"
              className="rounded-sm text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
            >
              <LetterSwap text="Products" />
            </a>
            <a
              href="#"
              className="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
            >
              <LetterSwap text="Pricing" />
            </a>
            <a
              href="#"
              className="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
            >
              <LetterSwap text="Docs" />
            </a>
            <a
              href="#"
              className="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
            >
              <LetterSwap text="Blog" />
            </a>
          </nav>
        </header>
      );
    }
    <script setup lang="ts">
    import LetterSwap from "@/components/markas/LetterSwap.vue";
    </script>
    
    <template>
      <header
        class="flex items-center justify-between rounded-xl border border-line bg-surface px-5 py-3"
      >
        <span class="text-sm font-semibold text-ink">Markas</span>
        <nav
          aria-label="Main"
          class="flex items-center gap-5 text-sm font-medium text-muted"
        >
          <a
            href="#"
            class="rounded-sm text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
            ><LetterSwap text="Products"
          /></a>
          <a
            href="#"
            class="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
            ><LetterSwap text="Pricing"
          /></a>
          <a
            href="#"
            class="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
            ><LetterSwap text="Docs"
          /></a>
          <a
            href="#"
            class="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
            ><LetterSwap text="Blog"
          /></a>
        </nav>
      </header>
    </template>
    <script lang="ts">
      import LetterSwap from "$lib/components/markas/LetterSwap.svelte";
    </script>
    
    <header
      class="flex items-center justify-between rounded-xl border border-line bg-surface px-5 py-3"
    >
      <span class="text-sm font-semibold text-ink">Markas</span>
      <nav
        aria-label="Main"
        class="flex items-center gap-5 text-sm font-medium text-muted"
      >
        <!-- svelte-ignore a11y_invalid_attribute -->
        <a
          href="#"
          class="rounded-sm text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
        >
          <LetterSwap text="Products" />
        </a>
        <!-- svelte-ignore a11y_invalid_attribute -->
        <a
          href="#"
          class="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
        >
          <LetterSwap text="Pricing" />
        </a>
        <!-- svelte-ignore a11y_invalid_attribute -->
        <a
          href="#"
          class="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
        >
          <LetterSwap text="Docs" />
        </a>
        <!-- svelte-ignore a11y_invalid_attribute -->
        <a
          href="#"
          class="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
        >
          <LetterSwap text="Blog" />
        </a>
      </nav>
    </header>
    ---
    import LetterSwap from "@/components/markas/LetterSwap.astro";
    ---
    
    <header
      class="flex items-center justify-between rounded-xl border border-line bg-surface px-5 py-3"
    >
      <span class="text-sm font-semibold text-ink">Markas</span>
      <nav
        aria-label="Main"
        class="flex items-center gap-5 text-sm font-medium text-muted"
      >
        <a
          href="#"
          class="rounded-sm text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
        >
          <LetterSwap text="Products" />
        </a>
        <a
          href="#"
          class="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
        >
          <LetterSwap text="Pricing" />
        </a>
        <a
          href="#"
          class="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
        >
          <LetterSwap text="Docs" />
        </a>
        <a
          href="#"
          class="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
        >
          <LetterSwap text="Blog" />
        </a>
      </nav>
    </header>
    import { Component } from "@angular/core";
    import { LetterSwap } from "./markas/letter-swap.component";
    
    @Component({
      selector: "markas-example",
      imports: [LetterSwap],
      template: `
        <header
          class="flex items-center justify-between rounded-xl border border-line bg-surface px-5 py-3"
        >
          <span class="text-sm font-semibold text-ink">Markas</span>
          <nav
            aria-label="Main"
            class="flex items-center gap-5 text-sm font-medium text-muted"
          >
            <a
              href="#"
              class="rounded-sm text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
            >
              <span markas-letter-swap text="Products"></span>
            </a>
            <a
              href="#"
              class="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
            >
              <span markas-letter-swap text="Pricing"></span>
            </a>
            <a
              href="#"
              class="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
            >
              <span markas-letter-swap text="Docs"></span>
            </a>
            <a
              href="#"
              class="rounded-sm hover:text-ink focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-primary"
            >
              <span markas-letter-swap text="Blog"></span>
            </a>
          </nav>
        </header>
      `,
    })
    export default class LetterSwapExample {}

    Examples

    Buttons

    Footer links in random order

    Contact email

    Installation

    npx markasui@latest add letter-swap

    Usage

    <a href="/pricing" class="text-sm font-medium">
        <x-markas.letter-swap text="Pricing" />
    </a>
    <button type="button" class="h-10 rounded-lg bg-primary px-4 text-on-primary">
        <x-markas.letter-swap text="Start free trial" mode="pingpong" direction="down" />
    </button>
    <a href="/careers"><x-markas.letter-swap text="Careers" mode="random" /></a>
    import { LetterSwap } from "@/components/markas/LetterSwap";
    
    <a href="/pricing" className="text-sm font-medium">
      <LetterSwap text="Pricing" />
    </a>
    <button type="button" className="h-10 rounded-lg bg-primary px-4 text-on-primary">
      <LetterSwap text="Start free trial" mode="pingpong" direction="down" />
    </button>
    <a href="/careers"><LetterSwap text="Careers" mode="random" /></a>
    <template>
      <a href="/pricing" class="text-sm font-medium">
        <LetterSwap text="Pricing" />
      </a>
      <button type="button" class="h-10 rounded-lg bg-primary px-4 text-on-primary">
        <LetterSwap text="Start free trial" mode="pingpong" direction="down" />
      </button>
      <a href="/careers"><LetterSwap text="Careers" mode="random" /></a>
    </template>
    <script lang="ts">
      import LetterSwap from "$lib/components/markas/LetterSwap.svelte";
    </script>
    
    <a href="/pricing" class="text-sm font-medium">
      <LetterSwap text="Pricing" />
    </a>
    <button type="button" class="h-10 rounded-lg bg-primary px-4 text-on-primary">
      <LetterSwap text="Start free trial" mode="pingpong" direction="down" />
    </button>
    ---
    import LetterSwap from "@/components/markas/LetterSwap.astro";
    ---
    
    <a href="/pricing" class="text-sm font-medium">
      <LetterSwap text="Pricing" />
    </a>
    <a href="/careers"><LetterSwap text="Careers" mode="random" /></a>
    import { Component } from "@angular/core";
    import { LetterSwap } from "./markas/letter-swap.component";
    
    @Component({
      selector: "app-nav-link",
      imports: [LetterSwap],
      template: `
        <a href="/pricing" class="text-sm font-medium">
          <span markas-letter-swap text="Pricing"></span>
        </a>
        <button
          type="button"
          class="h-10 rounded-lg bg-primary px-4 text-on-primary"
        >
          <span markas-letter-swap text="Start free trial" mode="pingpong"></span>
        </button>
      `,
    })
    export class NavLink {}
    • Put the component inside a link or button. It listens to hover and focus on the closest a, button, label, or element with tabindex, so keyboard users see the same swap.
    • forward and random run once per hover and ignore a new hover until they finish. pingpong swaps in on hover and back on leave or blur.
    • The random order comes from a fixed hash, so it is the same on every render and in every framework.
    • Screen readers hear the text once from a visually hidden copy. With reduced motion, the letters stay still. The Blade version needs Alpine.js.

    Props

    NameTypeDefaultDescription
    textstring-The text to animate. Screen readers read it once as a whole.
    mode"forward" | "pingpong" | "random""forward"forward swaps once per hover in reading order, pingpong swaps in on hover and back out on leave, random swaps once in a fixed shuffled order.
    direction"up" | "down""up"Letters leave upward and the copy rises from below, or the reverse.
    staggernumber30Milliseconds between one letter and the next.
    durationnumber400Milliseconds each letter takes to swap.

    Accessibility

    • The whole text sits in a visually hidden copy, so a link or button gets one clean accessible name; the animated letters are aria-hidden.
    • The swap also runs on keyboard focus of the closest link, button, label, or element with tabindex.
    • With reduced motion, the letters do not move.

    Related components

    More animations components with the same classes in every framework.