skip to content

Blam

Handles events to affect a prop or AudioParam, or execute a method. Which of these three are applicable is automatically determined from the prop name supplied.

class
Blam
extends
Set
tag
<blam-blam>
see

Props

name type default description
ramp number

In beats. Where the prop is an audioParam, whether to ramp the value. For example, for gain, whether to fade/slide between the start and end values.

revert boolean false

When revert is applied, values do not stick. Once set, the next event reverts them to the original value (the one taken from the element during initialization). Used with a low chance, you create the effect of a regular value that just occasionally, and momentarily, strays.

once boolean false

Whether to only handle the event one time. Interesting, compositionally, when paired with a low chance.

from string

A CSS selector representing all elements from which events will be listened to. If not set, the node array defaults to the element’s defaultFrom function’s return value.

to string

A CSS selector representing all elements to affect in response to the event. If not set, the node array defaults to the element’s defaultTo function’s return value.

value string null

Handle-derived elements support special value syntax. Separate with | and one value is chosen at random. Separate with ~ and a value is chosen within the range [x]~[n]. Separate with (a single space) if you are supplying multiple args to an element’s method.

event string blam

The event type to listen for. For many Event-based elements, this is the generic custom event blam.

prop string null

The property (which may be a method or map to an audioParam) to affect at the event.

bypass boolean false

Whether to stop responding to events as they happen.

chance boolean 1

The probability that the event will be responded to. From 0 to 1.

Examples

Examples that use the Blam element: