Avenra
Liquid GlassAPI Reference
Liquid GlassAPI Reference

createLiquidDial

Rotary glass knob / dial component.

createLiquidDial

Creates a glass-styled rotary dial or knob for value selection.

Basic Usage

import { createLiquidDial } from '@avenra/liquid-glass';

const dial = createLiquidDial('#dial-container', {
  min: 0,
  max: 100,
  value: 20
});

dial.on('input', ({ value }) => console.log('Dial at:', value));

Props / Options

Extends LiquidGlassOptions plus:

PropTypeDefaultDescription
minnumber0Minimum value
maxnumber100Maximum value
valuenumber0Initial value
stepnumber1Step increment

Return Value — LiquidDialHandle

MemberTypeDescription
elementElementThe dial element
valuenumber (get/set)Current dial value
destroy()() => voidClean up the component
on('input', cb){ value: number, element: Element }Fired during rotation
on('change', cb){ value: number, element: Element }Fired on release
on('destroy', cb)undefinedFired on destruction

On this page