Waves
Bands of colour stacked like a coastline or a dune field, each front shading the band behind it just above its crest.
<Fx effect="waves" preset="Sea" />Features
- Bands stacked like a coastline or dunes, each front shading the band behind it.
Use it for
- Sea and desert scenes.
- Section dividers.
Installation
- Get runets.
git clone https://github.com/ziyam-khan/runets - Copy these files into your project, keeping their folders.
- Install what they use.
pnpm add react
Usage
import { Fx } from 'runets'
<div className="card"> {/* position: relative */}
<Fx effect="waves" />
</div>API
| Prop | Type | What it does |
|---|---|---|
effect | string | The effect’s id, as in the address of this page. |
preset | string | One of the presets above; the first by default. |
params | Params | Any parameter from the table, over the preset. |
place | 'under' | 'over' | Under the parent’s content (fills, halos) or over it (sparkles, glass). Default under. |
radius | number | Corner radius in points; the parent’s own border radius by default. |
backdrop | string | Paint | What glass and distortion read: an image URL, or a function that paints a canvas the size of the parent. |
mask | Paint | An alpha mask for mask glow and text sheen. |
hot | boolean | Drives heat: the layer lights in 60 ms and cools over half a second instead of cutting off. |
trigger | number | Change it to fire a one-shot now (ping, ripple, burst, shockwave, zap). |
wake | number | Change it to redraw for a second when something the layer reads, such as its occluders, moves on its own. |
shape | (time, w, h) => Rect | The effect’s shape inside the parent, per frame: a lens that drifts. |
Parameters
| Name | Range | Default |
|---|---|---|
colors Colours | colors | 5 colours |
amplitude Amplitude | 0 to 0.25 | 0.05 |
frequency Frequency | 0.2 to 6 | 1.6 |
speed Speed | 0 to 2 | 0.4 |
angle Angle | -3.141592653589793 to 3.141592653589793 | 0 |
softness Softness | 0 to 0.1 | 0.006 |
border Border | 0 to 24 | 0 |
intensity Intensity | 0 to 1 | 1 |
Accessibility
- The canvas is aria-hidden and never takes the pointer; the parent keeps its semantics and focus.
- Under prefers-reduced-motion every loop settles on one calm pose; one-shots fade in place instead of travelling.
- Off screen, in a hidden tab or once settled, the layer draws nothing.
- data-motion="off" on the root element is a pause switch for the whole page: every layer rests on that calm pose until it is removed.
Source
The code is in src/fx/glsl/surface.ts in runets, MIT licensed.