ScrollVars / fx
docs · demo · bench · llms.txt · GitHub

Glass

Refract a graphic through a moving glass edge, with adjustable Gaussian blur and a localized highlight.

Use it for: A hero or product graphic with a known scene texture. The heading stays readable when WebGL is unavailable.
Knobs: Blur sets the Gaussian radius in CSS pixels. Position slides the glass. Light can stay fixed, follow the mouse or float on a slow orbit.

Refraction

Glass controls

Fixed: the edge highlight stays at the top left. Light changes the thin edge highlight, not the scene lighting.

Mouse responds over the image, near the glass edge. Floating completes one slow orbit every 120 seconds. Reduced motion keeps the light fixed.

Install: npx scrollvars add glass
Styles: import 'scrollvars/styles/glass.css'

// From your frontend package root: npx scrollvars add glass
import 'scrollvars/styles/glass.css'
import { GlassStudy } from './components/fx/GlassStudy'

export function Hero() {
  return <div className="mx-auto max-w-4xl overflow-hidden rounded-2xl">
    <GlassStudy blur={6} lightMode="pointer" />
  </div>
}
<div class="sv-glass glass-study">
  <h2>Refraction</h2>
  <canvas class="sv-glass-canvas" aria-hidden="true" hidden></canvas>
</div>
<style>.glass-study {
  aspect-ratio: 2 / 1; overflow: hidden; container-type: inline-size;
  background: linear-gradient(to right, #e9efff, #87a3ff); color: #162049;
}
.glass-study::before {
  content: ''; position: absolute; width: 32%; aspect-ratio: 1;
  top: 50%; left: 73%; transform: translate(-50%, -50%);
  border-radius: 50%; background: #ed502d;
}
.glass-study h2 {
  position: absolute; top: 50%; left: 6%; transform: translateY(-50%);
  margin: 0; font: bold 12cqi/1 Arial, sans-serif; color: inherit;
}</style>
<script type="module">
import 'scrollvars/styles/glass.css'
import { mountGlass } from 'scrollvars/glass'
const source = ({ width, height, dpr }) => {
  const texture = document.createElement('canvas')
  texture.width = Math.max(1, Math.round(width * dpr))
  texture.height = Math.max(1, Math.round(height * dpr))
  const ctx = texture.getContext('2d')
  if (!ctx) throw new Error('Glass scene requires Canvas 2D')
  ctx.scale(dpr, dpr)
  const gradient = ctx.createLinearGradient(0, 0, width, 0)
  gradient.addColorStop(0, '#e9efff')
  gradient.addColorStop(1, '#87a3ff')
  ctx.fillStyle = gradient
  ctx.fillRect(0, 0, width, height)
  ctx.fillStyle = '#ed502d'
  ctx.beginPath()
  ctx.arc(width * .73, height * .5, width * .16, 0, Math.PI * 2)
  ctx.fill()
  ctx.fillStyle = '#162049'
  ctx.font = 'bold ' + width * .12 + 'px Arial'
  ctx.textBaseline = 'middle'
  ctx.fillText('Refraction', width * .06, height * .5)
  return texture
}
const glass = mountGlass(document.querySelector('.glass-study canvas'), {
  source, blur: 6, edgeGlow: 85, lightMode: 'static'
})
// On teardown: glass.destroy()
</script>
'use client'
import * as React from 'react'
import { Glass } from 'scrollvars/react/glass'
import type { GlassMaterial, GlassOptions } from 'scrollvars/glass'
// Import 'scrollvars/styles/glass.css' in your site's stylesheet entry.

const source: GlassOptions['source'] = ({ width, height, dpr }) => {
  const texture = document.createElement('canvas')
  texture.width = Math.max(1, Math.round(width * dpr))
  texture.height = Math.max(1, Math.round(height * dpr))
  const ctx = texture.getContext('2d')
  if (!ctx) throw new Error('Glass scene requires Canvas 2D')
  ctx.scale(dpr, dpr)
  const gradient = ctx.createLinearGradient(0, 0, width, 0)
  gradient.addColorStop(0, '#e9efff')
  gradient.addColorStop(1, '#87a3ff')
  ctx.fillStyle = gradient
  ctx.fillRect(0, 0, width, height)
  ctx.fillStyle = '#ed502d'
  ctx.beginPath()
  ctx.arc(width * .73, height * .5, width * .16, 0, Math.PI * 2)
  ctx.fill()
  ctx.fillStyle = '#162049'
  ctx.font = 'bold ' + width * .12 + 'px Arial'
  ctx.textBaseline = 'middle'
  ctx.fillText('Refraction', width * .06, height * .5)
  return texture
}

const css = `.glass-study {
  aspect-ratio: 2 / 1; overflow: hidden; container-type: inline-size;
  background: linear-gradient(to right, #e9efff, #87a3ff); color: #162049;
}
.glass-study::before {
  content: ''; position: absolute; width: 32%; aspect-ratio: 1;
  top: 50%; left: 73%; transform: translate(-50%, -50%);
  border-radius: 50%; background: #ed502d;
}
.glass-study h2 {
  position: absolute; top: 50%; left: 6%; transform: translateY(-50%);
  margin: 0; font: bold 12cqi/1 Arial, sans-serif; color: inherit;
}`

export function GlassStudy({ nonce, ...material }: GlassMaterial & { nonce?: string }) {
  return <Glass className="glass-study" source={source} blur={6} edgeGlow={85} {...material}>
    <style nonce={nonce} dangerouslySetInnerHTML={{ __html: css }} />
    <h2>Refraction</h2>
  </Glass>
}

Engine: npm i scrollvars, 14.5 KB gzip as ESM (this page's fx/sv.js IIFE: 14.7 KB). All effects respect prefers-reduced-motion and render complete without JS.