marquee

Marquee

Continuously scroll overflowing content and pause it on hover or focus.

Preview

A content track translates continuously and wraps to create an uninterrupted scrolling strip.

MarqueeMotionInterface

Implement Marquee: Continuously scroll overflowing content and pause it on hover or focus. Use Cycle duration 8000ms, Content gap 32px, Direction left, Pause on hover on. Keep continuous motion pausable and low-distraction. Use semantic HTML, scope CSS to .motion-demo--marquee, and mount the provided vanilla JavaScript interaction runtime. Provide equivalent low-motion behavior for prefers-reduced-motion and .force-reduced-motion.

markup.html

<div class="motion-demo motion-demo--marquee" data-motion="marquee" aria-label="Marquee demo">
  <div class="motion-pausable-scene">
    <div class="motion-marquee" tabindex="0"><div class="motion-marquee-track"><span class="motion-marquee-item">Marquee</span><span class="motion-marquee-item">Motion</span><span class="motion-marquee-item">Interface</span><span class="motion-marquee-item" aria-hidden="true">Marquee</span><span class="motion-marquee-item" aria-hidden="true">Motion</span><span class="motion-marquee-item" aria-hidden="true">Interface</span></div></div>
    <div class="motion-action-row"><button class="motion-pause-button" type="button" data-motion-pause data-pause-label="Pause motion" data-resume-label="Resume motion" aria-pressed="false" aria-disabled="true" disabled><span data-motion-pause-label>Pause motion</span></button></div>
  </div>
</div>

motion.css

.motion-demo.motion-demo--marquee {
  box-sizing: border-box;
  position: relative;
  display: grid;
  place-items: center;
  width: min(100%, 34rem);
  min-height: 15rem;
  padding: 2rem;
  overflow: hidden;
  color: #18181b;
  background: #fafafa;
  border: 1px solid #e4e4e7;
  border-radius: 16px;
  isolation: isolate;
}

.motion-demo.motion-demo--marquee *, .motion-demo.motion-demo--marquee *::before, .motion-demo.motion-demo--marquee *::after {
  box-sizing: border-box;
}

.motion-demo.motion-demo--marquee .motion-surface {
  position: relative;
  display: grid;
  gap: 0.65rem;
  width: min(100%, 18rem);
  padding: 1.25rem;
  background: #ffffff;
  border: 1px solid #e4e4e7;
  border-radius: 16px;
  box-shadow: none;
}

.motion-demo.motion-demo--marquee .motion-surface strong { font-weight: 500; }

.motion-demo.motion-demo--marquee .motion-line {
  display: block;
  width: 100%;
  height: 0.5rem;
  background: #e4e4e7;
  border-radius: 999px;
}

.motion-demo.motion-demo--marquee .motion-line:last-child { width: 62%; }

.motion-demo.motion-demo--marquee .motion-button {
  position: relative;
  min-height: 2.75rem;
  padding: 0.75rem 1.1rem;
  color: white;
  font: inherit;
  font-weight: 700;
  background: #18181b;
  border: 0;
  border-radius: 999px;
  cursor: pointer;
}

.motion-demo.motion-demo--marquee .motion-button:focus-visible { outline: 3px solid rgb(37 99 235 / 32%); outline-offset: 3px; }

.motion-demo.motion-demo--marquee .motion-action-row {
  display: flex;
  justify-content: center;
  gap: 0.5rem;
  margin-top: 0.85rem;
}

.motion-demo.motion-demo--marquee .motion-replay-scene {
  width: min(100%, 22rem);
  display: grid;
  place-items: center;
}

.motion-demo.motion-demo--marquee .motion-pausable-scene {
  width: min(100%, 22rem);
  display: grid;
  place-items: center;
}

.motion-demo.motion-demo--marquee button.motion-surface {
  color: inherit;
  font: inherit;
  text-align: start;
  cursor: pointer;
}

.motion-demo.motion-demo--marquee .motion-replay-button,
.motion-demo.motion-demo--marquee .motion-undo-button,
.motion-demo.motion-demo--marquee .motion-dismiss-button,
.motion-demo.motion-demo--marquee .motion-pause-button {
  min-height: 2.75rem;
  padding: 0.65rem 0.9rem;
  color: #18181b;
  font: 650 0.78rem/1 ui-sans-serif, system-ui, sans-serif;
  background: #ffffff;
  border: 1px solid #d4d4d8;
  border-radius: 8px;
  cursor: pointer;
}

.motion-demo.motion-demo--marquee .motion-replay-button:focus-visible,
.motion-demo.motion-demo--marquee .motion-undo-button:focus-visible,
.motion-demo.motion-demo--marquee .motion-dismiss-button:focus-visible,
.motion-demo.motion-demo--marquee .motion-pause-button:focus-visible,
.motion-demo.motion-demo--marquee [data-reorder-item]:focus-visible,
.motion-demo.motion-demo--marquee [data-swipe-target]:focus-visible {
  outline: 3px solid rgb(37 99 235 / 32%);
  outline-offset: 3px;
}

.motion-demo.motion-demo--marquee .motion-status {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}

.motion-demo.motion-demo--marquee .motion-ripple-ink {
  position: absolute;
  width: 12px;
  height: 12px;
  pointer-events: none;
  background: rgb(255 255 255 / 72%);
  border-radius: 50%;
  transform: translate(-50%, -50%) scale(0.95);
  opacity: 0;
}

.motion-demo.motion-demo--marquee .motion-state-stack { position: relative; width: min(100%, 18rem); height: 9rem; }
.motion-demo.motion-demo--marquee .motion-state { position: absolute; inset: 0; display: grid; place-items: center; padding: 1rem; background: #ffffff; border: 1px solid #e4e4e7; border-radius: 16px; }
.motion-demo.motion-demo--marquee .motion-state--to { background: #18181b; color: white; }

.motion-demo.motion-demo--marquee .motion-scroll-track > span { color: #71717a; font: 600 0.72rem/1.2 ui-monospace, monospace; letter-spacing: 0.08em; text-transform: uppercase; }
.motion-demo.motion-demo--marquee .motion-orbit-item { display: grid; place-items: center; width: 2.5rem; height: 2.5rem; color: white; background: #2563eb; border-radius: 50%; }
.motion-demo.motion-demo--marquee .motion-text-stack { position: relative; width: min(100%, 18rem); min-height: 4rem; }
.motion-demo.motion-demo--marquee svg { width: min(100%, 20rem); height: auto; }

.motion-demo.motion-demo--marquee .motion-marquee { display: flex; width: 100%; overflow: hidden; }
.motion-demo.motion-demo--marquee .motion-marquee-track { display: flex; flex: none; gap: 32px; min-width: max-content; animation: motion-marquee 8000ms linear infinite normal; }
.motion-demo.motion-demo--marquee .motion-marquee-item { padding: 0.75rem 1rem; background: #ffffff; border: 1px solid #e4e4e7; border-radius: 999px; }
.motion-demo.motion-demo--marquee .motion-marquee:focus-within .motion-marquee-track { animation-play-state: paused; }
@media (hover: hover) and (pointer: fine) { .motion-demo.motion-demo--marquee .motion-marquee:hover .motion-marquee-track { animation-play-state: paused; } }
@keyframes motion-marquee { to { transform: translateX(calc(-50% - 16px)); } }

@keyframes motion-marquee-reduced-fade {
  from { opacity: 0.84; }
  to { opacity: 1; }
}

.force-reduced-motion .motion-demo.motion-demo--marquee {
  animation: motion-marquee-reduced-fade 160ms cubic-bezier(0.23, 1, 0.32, 1) both !important;
}

.force-reduced-motion .motion-demo.motion-demo--marquee *,
.force-reduced-motion .motion-demo.motion-demo--marquee *::before,
.force-reduced-motion .motion-demo.motion-demo--marquee *::after {
  animation: none !important;
  animation-delay: 0ms !important;
  animation-iteration-count: 1 !important;
  transition-property: opacity, color, background-color, border-color !important;
  transition-duration: 160ms !important;
  transition-delay: 0ms !important;
  scroll-behavior: auto !important;
}

.force-reduced-motion .motion-demo.motion-demo--marquee .motion-button,
.force-reduced-motion .motion-demo.motion-demo--marquee [data-reorder-item],
.force-reduced-motion .motion-demo.motion-demo--marquee [data-swipe-target],
.force-reduced-motion .motion-demo.motion-demo--marquee [data-spring-target] {
  transform: none !important;
}

.force-reduced-motion .motion-demo.motion-demo--marquee .motion-path { stroke-dashoffset: 0 !important; }
.force-reduced-motion .motion-demo.motion-demo--marquee .motion-word--from { opacity: 0 !important; visibility: hidden; }
.force-reduced-motion .motion-demo.motion-demo--marquee .motion-word:not(.motion-word--from) { opacity: 1 !important; filter: none !important; transform: none !important; }

@media (prefers-reduced-motion: reduce) {
  .motion-demo.motion-demo--marquee {
    animation: motion-marquee-reduced-fade 160ms cubic-bezier(0.23, 1, 0.32, 1) both !important;
  }

  .motion-demo.motion-demo--marquee *, .motion-demo.motion-demo--marquee *::before, .motion-demo.motion-demo--marquee *::after {
    animation: none !important;
    animation-delay: 0ms !important;
    animation-iteration-count: 1 !important;
    transition-property: opacity, color, background-color, border-color !important;
    transition-duration: 160ms !important;
    transition-delay: 0ms !important;
    scroll-behavior: auto !important;
  }

  .motion-demo.motion-demo--marquee .motion-button,
  .motion-demo.motion-demo--marquee [data-reorder-item],
  .motion-demo.motion-demo--marquee [data-swipe-target],
  .motion-demo.motion-demo--marquee [data-spring-target] {
    transform: none !important;
  }

  .motion-demo.motion-demo--marquee .motion-path { stroke-dashoffset: 0 !important; }
  .motion-demo.motion-demo--marquee .motion-word--from { opacity: 0 !important; visibility: hidden; }
  .motion-demo.motion-demo--marquee .motion-word:not(.motion-word--from) { opacity: 1 !important; filter: none !important; transform: none !important; }
}

motion.js

(() => {
  const config = {
  "id": "marquee",
  "duration": 8000,
  "distance": 72,
  "resistance": 65,
  "position": 50,
  "stiffness": 220,
  "damping": 24,
  "mass": 1,
  "velocity": 0,
  "rippleSize": 220,
  "rippleOpacity": 24,
  "dragScale": 103,
  "autoplay": false
};
  const mount = (root, config) => {

    const cleanups = [];
    const addCleanup = (callback) => cleanups.push(callback);
    const cleanup = () => {
      for (let index = cleanups.length - 1; index >= 0; index -= 1) {
        try { cleanups[index](); } catch { /* keep cleanup reentrant */ }
      }
      cleanups.length = 0;
    };
    const on = (target, type, listener, options) => {
      target.addEventListener(type, listener, options);
      addCleanup(() => target.removeEventListener(type, listener, options));
    };
    const reduced = () => root.closest(".force-reduced-motion") !== null ||
      window.matchMedia("(prefers-reduced-motion: reduce)").matches;
    const watchReduced = (callback) => {
      const media = window.matchMedia("(prefers-reduced-motion: reduce)");
      const notify = () => callback(reduced());
      media.addEventListener("change", notify);
      const observer = typeof MutationObserver === "undefined" ? null : new MutationObserver(notify);
      let ancestor = root;
      while (observer && ancestor) {
        observer.observe(ancestor, { attributes: true, attributeFilter: ["class"] });
        ancestor = ancestor.parentElement;
      }
      addCleanup(() => {
        media.removeEventListener("change", notify);
        if (observer) observer.disconnect();
      });
    };

    const button = root.querySelector("[data-motion-pause]");
    const label = root.querySelector("[data-motion-pause-label]");
    if (!button || !label) return cleanup;
    button.disabled = false;
    button.removeAttribute("aria-disabled");
    let paused = false;
    const toggle = () => {
      paused = !paused;
      root.getAnimations({ subtree: true }).forEach((animation) => paused ? animation.pause() : animation.play());
      button.setAttribute("aria-pressed", String(paused));
      label.textContent = paused
        ? button.dataset.resumeLabel || "Resume motion"
        : button.dataset.pauseLabel || "Pause motion";
      root.dispatchEvent(new CustomEvent(paused ? "motion:pause" : "motion:resume", { bubbles: true }));
    };
    addCleanup(() => {
      root.getAnimations({ subtree: true }).forEach((animation) => {
        if (animation.playState === "paused") animation.play();
      });
      paused = false;
      button.setAttribute("aria-pressed", "false");
      button.disabled = true;
      button.setAttribute("aria-disabled", "true");
      label.textContent = button.dataset.pauseLabel || "Pause motion";
    });
    on(button, "click", toggle);
    return cleanup;
  };
  document.querySelectorAll("[data-motion=\"marquee\"]").forEach((root) => {
    const cleanupKey = "__motionLexiconCleanup";
    if (typeof root[cleanupKey] === "function") root[cleanupKey]();
    root[cleanupKey] = mount(root, config);
  });
})();

Learn more

Before implementation

Purpose: Present an overlong information stream in limited space while allowing users to pause and read.
Frequency: Use sparingly for brands, partners, or live status strips while keeping core text statically accessible.
Trigger: Run only when content overflows and playback is active, remaining still when content fits.
Enter / exit: Join duplicated content into a seamless track and stop at a fully readable position.
Interruptibility: Pause at the current position on hover, focus, or page hide, and continue on resume.
Gesture and keyboard: Let users pause through hover, focus, and a control while keeping one keyboard-accessible copy of track content.
Reduced-motion strategy: Stop scrolling and wrap content or provide a statically browsable horizontal list.

Accessibility

Reduced motion

Stop scrolling and wrap content or provide a statically browsable horizontal list.

Parameter reference

Parameter	Range / options	Default	Purpose
`duration`	2000ms–20000ms	8000ms	Controls the rhythm of one full cycle; continuous motion should stay pausable and low-distraction.
`gap`	8px–80px	32px	Adjusts content gap.
`direction`	Left / Right	Left	Selects direction.
`pauseOnHover`	On / Off	On	Pauses motion on hover or focus.