Light
A lamp above the page: raised elements cast soft shadows whose penumbra widens with distance, their bevels catch the light, and the rest of the page falls into shade.
Appearance
Sound
Shortcuts
<Fx effect="light" preset="Reading lamp" />Features
- Raised elements cast soft shadows whose penumbra widens with distance, traced through their distance field.
- Rim light on the bevels facing the lamp; the lamp can follow the pointer.
Use it for
- A reading lamp over a shelf.
- Spotlight onboarding.
On this site
- My Stuff: the professional shelfThe dark shelf is read by lamplight that follows you.
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="light" />
</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 |
|---|---|---|
color Colour | color | 0xffd9a8 |
intensity Intensity | 0 to 5 | 2.2 |
ambient Darkness | 0 to 1 | 0.72 |
range Range | 60 to 900 | 340 |
softness Softness | 0.2 to 3 | 1 |
height Height | 20 to 400 | 120 |
size Source size | 2 to 40 | 14 |
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/weather.ts in runets, MIT licensed.