houdini-noise

A CSS Houdini Worklet to paint HSL powered background noise.

Getting started

1. Load the worklet

Using CDN is the easiest way to add the library:

if ('paintWorklet' in CSS) {
  CSS.paintWorklet.addModule('https://unpkg.com/houdini-noise/dist/worklet.js');
}

You can use the polyfill

To add support for all moder browsers, you can load the worklet with css-paint-polyfill fallback.

<script>
  ;(async function() {
    if (CSS['paintWorklet'] === undefined)
      await import('https://unpkg.com/css-paint-polyfill')

    CSS.paintWorklet.addModule('https://unpkg.com/houdini-noise/dist/worklet.js');
  })()
</script>

2. Ready to use it in your CSS!

To use Noise worklet you need define some custom properties with values and add the value paint(noise) on background property.

.element {
  --noise: 0; /* Entry point to animate noise */
  --noise-cell-size: 1;
  --noise-hue: 330;
  --noise-saturation: 100;
  --noise-lightness: 0 80;
  background: paint(noise);
}

Property	Description	Default
--noise	Hack, use this property to animate noise. Animating the property triggers a repaint.	0
--noise-cell-size	Cell Size, use this to define the size of noise particles in px	0
--noise-hue	Hue Range, use this to define a set hue or a hue range	0 0
--noise-saturation	Saturation Range, use this to define a set saturation or a saturation range	0 0
--noise-lightness	Lightness Range, use this to define a set lightness or a lightness range	0 0

Development

Run it locally!

npm i
make develop

License

MIT License

Copyright (c) 2020 jh3y