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

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, 12.9 KB gzip as ESM (this page's fx/sv.js IIFE: 13.2 KB). All effects respect prefers-reduced-motion and render complete without JS.