Skip to content

page control

The page control is identical to the standard control, except it has a required page option. This control's LED feedback will reflect whether its bound page is currently active. As such, the color option is ignored.

Note

Standard controls are already capable of changing pages, and page controls still require you to manually define the page change commands. The only purpose of this control is to enable control feedback.

See command reference.

yaml schema

Inherits from standard control.

page: string, int
# color: not implemented

page

string | int

The page name or number this control is bound to. Passing a string value means that the binding is resistant to page order changes, while passing an int may be suitable for a dedicated 'page row'.

Note: page numbers are always zero-indexed.


color

not implemented

LED feedback is based on whether the control's bound page is active.

properties

These are values attached to controls that can be referenced from within template strings.

page

Returns the zero-indexed page number of this control's bound page.

Page

with a capital P

Returns page + 1.

page_name

Returns the name of the bound page.

is_active

Returns a boolean representing if the bound page is in view.