Callbacks

callbacks.py

Lightweight two-class event system used by every plot object and widget.

CallbackRegistry

Per-object store of named callbacks. Every plot object and widget exposes on_changed, on_release, on_click, and on_key decorator methods that connect handlers through this registry.

Event

Immutable data-carrier passed to every callback. All keys in the raw JS payload are accessible as attributes (event.zoom, event.cx, etc.) in addition to the typed event_type, source, and data fields.

Example

fig, ax = apl.subplots(1, 1)
plot = ax.imshow(data)

@plot.on_release
def on_settle(event):
    print(f"zoom={event.zoom:.2f}  center=({event.center_x:.3f}, {event.center_y:.3f})")

class anyplotlib.callbacks.Event(event_type, source, data=<factory>)

Bases: object

A single interactive event. event_type: one of on_click / on_changed / on_release source: the originating Python object (Widget, Plot, or None) data: full state dict; all keys also accessible as event.x

Parameters:

• event_type (str)

• source (Any)

• data (dict)

event_type: str

source: Any

data: dict

class anyplotlib.callbacks.CallbackRegistry

Bases: object

Per-object registry for on_click / on_changed / on_release callbacks.

connect(event_type, fn)

Register fn for event_type. Returns integer CID.

Parameters:

• event_type (str)

• fn (Callable)

Return type:

int

disconnect(cid)

Remove handler for cid. Silent if not found.

Parameters:

cid (int)

Return type:

None

fire(event)

Dispatch event to all handlers matching event.event_type.

Return type:

None