# Scroll edge fade

Subtle web animation sketch from [https://mighil.com/animations](https://mighil.com/animations).

- **Live demo:** https://mighil.com/animations/scroll-edge-fade
- **Standalone HTML:** https://mighil.com/animations/scroll-edge-fade?download=1
- **This file:** https://mighil.com/animations/scroll-edge-fade/scroll-edge-fade.md
- **Technique:** `overflow`

## What it does

Fade edges only when there is more to scroll.

## Instructions for AI / coding agents

Implement this micro-interaction in the user's stack (vanilla HTML, React, Vue, Svelte, etc.).

1. Use the **HTML** as the DOM structure (adapt JSX/templates as needed; keep class names and ids).
2. Include the **Theme** CSS (or map the same variables into the host design system). It switches light/dark with `prefers-color-scheme`.
3. Apply the **CSS** as-is when possible. It uses `var(--text-color)`, `var(--heading-color)`, `var(--background-color)`, etc. from the theme so both modes work.
4. Run the **JavaScript** after the markup mounts. Prefer `DOMContentLoaded` or a framework `useEffect` / `onMount`.
5. Keep motion respectful of `prefers-reduced-motion` if the snippet already checks it.
6. Do not depend on mighil.com runtime or fonts. Theme variables are enough for color.
7. If porting to a component, expose the interactive root via a ref and preserve accessibility attributes (`aria-*`, `role`, `button` types).

## Theme (auto light / dark)

```css
/* Auto light / dark — follows prefers-color-scheme */
:root{
  color-scheme: light dark;
  --text-color: hsl(0, 0%, 18%);
  --heading-color: hsl(0, 0%, 18%);
  --background-color: hsl(0, 0%, 99%);
  --bg-color: hsl(0, 0%, 99%);
  --link-color: hsl(0, 0%, 18%);
  --visited-color: hsl(0, 0%, 18%);
  --blockquote-color: hsl(0, 0%, 18%);
  --code-bg-color: hsl(0, 0%, 95%);
  --code-color: hsl(0, 0%, 18%);
  --sub-color: hsl(0, 0%, 29%);
}
@media (prefers-color-scheme: dark){
:root{
  --text-color: hsl(35, 25%, 85%);
  --heading-color: hsl(35.2, 32.6%, 82.5%);
  --background-color: hsl(60, 2.2%, 8.8%);
  --bg-color: hsl(60, 2.2%, 8.8%);
  --link-color: hsl(34.7, 55.3%, 79.8%);
  --visited-color: hsla(34.7, 55.3%, 79.8%, 0.85);
  --blockquote-color: hsl(35, 30%, 75%);
  --code-bg-color: hsl(30, 5%, 7.8%);
  --code-color: limegreen;
  --sub-color: hsla(34.7, 24.7%, 84.9%, 0.78);
}
}
```

## HTML

```html
<div class="edge-fade-shell" id="edge-fade-shell">
        <div class="edge-fade" id="edge-fade">
          <div class="edge-fade-inner">
            Soft fades hint that more content sits above or below: orientation without a permanent scrollbar chrome.
            <br><br>
            Scroll this pane to see the edge masks appear only when there’s overflow in that direction.
            <br><br>
            At the top, the upper fade rests; at the bottom, the lower one does the same.
          </div>
        </div>
        <i class="edge-fade-mask edge-fade-mask-top" aria-hidden="true"></i>
        <i class="edge-fade-mask edge-fade-mask-bottom" aria-hidden="true"></i>
      </div>
```

## CSS

```css
.edge-fade-shell{
  position:relative;width:min(100%,360px);border-radius:10px;overflow:hidden;
  border:1px solid color-mix(in srgb,var(--text-color) 10%,transparent);
}

.edge-fade{
  height:152px;overflow:auto;overscroll-behavior:contain;
}

.edge-fade-inner{padding:14px;font-size:.85rem;line-height:1.5;color:color-mix(in srgb,var(--text-color) 80%,transparent)}

.edge-fade-mask{
  position:absolute;left:0;right:0;height:22px;pointer-events:none;z-index:2;
  opacity:0;transition:opacity .2s ease;
}

.edge-fade-mask-top{
  top:0;
  background:linear-gradient(to bottom, var(--background-color) 20%, transparent);
}

.edge-fade-mask-bottom{
  bottom:0;
  background:linear-gradient(to top, var(--background-color) 20%, transparent);
}

.edge-fade-shell.is-top .edge-fade-mask-top,
.edge-fade-shell.is-bottom .edge-fade-mask-bottom{opacity:1}

@media (prefers-reduced-motion: reduce){
  .grow-link::after,.wipe,.wipe .b,.shuffle .card,.odo-digit > b,.flap-reel,.step-node,.step-line > i,
  .switch,.switch::after,.copy-btn .c-idle,.copy-btn .c-done,.field label,.tip-bubble,.chip,.like-btn svg,
  .disc-btn svg,.disc-panel,.snack,.save-btn,.ux-box,.seg-pill,.soft-tabs-ink,.list-actions,.success-banner,.search-clear,.pin-btn svg,.submit-ring rect,
  .hold-btn .hold-fill,.toast,.menu-btn .menu-line,.stars button,.conn,.retry-btn,.sort-item,.mute-btn .wave,.mute-btn .x-line,.wizard-dots span,.cart-badge,.range-bubble,
  .filter-list li,.upload-bar > i,.quota-track > i,.quota-tip,.splitbtn-toggle svg,.splitbtn-menu,.presence-dot,
  .draft-banner,.tag-chip,.empty-state,.empty-item,.deadline,.deadline-clock,.deadline-track > i,.edge-fade-mask,.dirty-bar,.seen-ticks path,.nudge-field,.stack-card,
  .blur-line,.xface span,.magnet-chip,.confirm-btn,.confirm-btn span,.offline-banner,.sort-flip-btn svg,.sort-flip-list li,.react-fan,.react-fan button,.sticky-cta,
  .pw-toggle .pw-eye,.pw-toggle .pw-slash,.otp input,.exp-search,.exp-search input,.ok-field input,.ok-field .ok-check,.unread-dot,.unread-check,.unread-row,.sync-label,.sync-btn .sync-arrows,.sync-btn .sync-check,
  .inline-edit .ie-title,.inline-edit .ie-rename,.inline-edit .ie-panel,.inline-edit .ie-input,.inline-edit .ie-bar,
  .ghost-wrap .ghost-hint,.ghost-wrap .ghost-key,.cmd-palette,.cmd-palette li,.cmd-stage::before,.crumb-mid,.crumb-more,.diff-add,.diff-add > .diff-add-inner,.slot > i,.zoom-thumb,.zoom-full,.zoom-caption,
  .bulk-bar,.bulk-check svg,.bulk-row,.env-switch .env-ink,.env-switch button,.invite-btn .invite-idle,.invite-btn .invite-done,.flag-row,.flag-sw,.flag-sw::after,.deploy-node,.deploy-node i,.deploy-wire > b,.ws-ink,.ws-item .ws-check,.thread,.thread-body,.thread-resolve svg,
  .unfurl-card,.unfurl-thumb,.seat,.form-prog-bar > i,.form-prog-field,.form-prog-field svg,.mention b,.glyph-tile path,.glyph-tile line,.glyph-tile circle{transition:none!important}
}
```

## JavaScript

```js
// Scroll edge fade
  const edgeFade = document.getElementById('edge-fade');
  const edgeShell = document.getElementById('edge-fade-shell');
  function syncEdgeFade() {
    if (!edgeFade || !edgeShell) return;
    const max = edgeFade.scrollHeight - edgeFade.clientHeight;
    const top = edgeFade.scrollTop > 2;
    const bottom = max > 2 && edgeFade.scrollTop < max - 2;
    edgeShell.classList.toggle('is-top', top);
    edgeShell.classList.toggle('is-bottom', bottom);
  }
  if (edgeFade && edgeShell) {
    edgeFade.addEventListener('scroll', syncEdgeFade, { passive: true });
    syncEdgeFade();
    requestAnimationFrame(syncEdgeFade);
  }
```

---

_Source: https://mighil.com/animations/scroll-edge-fade_
