Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Letter Swap

    Teks yang hurufnya bergeser keluar lalu masuk lagi berurutan saat link atau tombolnya di-hover atau difokus. Urutan maju, bolak-balik, atau acak.

    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 {}

    Contoh

    Tombol

    Link footer dengan urutan acak

    Email kontak

    Instalasi

    npx markasui@latest add letter-swap

    Pemakaian

    <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="Coba gratis" mode="pingpong" direction="down" />
    </button>
    <a href="/careers"><x-markas.letter-swap text="Karier" 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="Coba gratis" mode="pingpong" direction="down" />
    </button>
    <a href="/careers"><LetterSwap text="Karier" 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="Coba gratis" mode="pingpong" direction="down" />
      </button>
      <a href="/careers"><LetterSwap text="Karier" 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 {}
    • Letakkan komponen di dalam link atau tombol. Komponen mendengarkan hover dan fokus pada a, button, label, atau elemen ber-tabindex terdekat, sehingga pengguna keyboard melihat pertukaran yang sama.
    • forward dan random berjalan sekali per hover dan mengabaikan hover baru sampai selesai. pingpong bertukar saat hover dan kembali saat kursor pergi atau fokus lepas.
    • Urutan acak berasal dari hash tetap, sehingga sama di setiap render dan di setiap framework.
    • Screen reader membaca teks sekali dari salinan tersembunyi. Dengan reduced motion, huruf diam. Versi Blade butuh Alpine.js.

    Props

    NamaTipeDefaultKeterangan
    textstring-Teks yang dianimasikan. Screen reader membacanya sekali secara utuh.
    mode"forward" | "pingpong" | "random""forward"forward bertukar sekali per hover sesuai urutan baca, pingpong bertukar saat hover dan kembali saat kursor pergi, random bertukar sekali dengan urutan acak yang tetap.
    direction"up" | "down""up"Huruf keluar ke atas dan salinannya naik dari bawah, atau sebaliknya.
    staggernumber30Milidetik antara satu huruf dan huruf berikutnya.
    durationnumber400Milidetik yang dibutuhkan setiap huruf untuk bertukar.

    Aksesibilitas

    • Teks utuh ada di salinan tersembunyi sehingga link atau tombol mendapat satu nama aksesibel yang bersih; huruf yang bergerak memakai aria-hidden.
    • Pertukaran juga berjalan saat fokus keyboard pada link, tombol, label, atau elemen ber-tabindex terdekat.
    • Dengan reduced motion, huruf tidak bergerak.

    Komponen terkait

    Komponen animasi lain dengan class yang sama di setiap framework.