Docs
Widgets / directory

Slider

SLIDER

Horizontal continuous input with min, max and send strategy options.

At a glance

Default8 x 1
Minimum3 x 1
Resizehorizontal
Pinrequired
Interactiveyes

Behavior

  • Can send live while dragging or only on release.
  • WidgetStateManager debounces fast streams for smoother writes.
  • Pairs naturally with Gauge and Level Display.

Firmware contract

Read param.asInt() or param.asDouble() to drive PWM, brightness or thresholds.

On the app side this widget snaps to the 8-column square grid and uses horizontal resizing. Its raw type is SLIDER and the matching icon token in the app is slider.horizontal.3.

Pin support: Virtual, digital or analog pins depending on the board target and the app-side pinType.

Transmission: Single numeric value with 100 ms send debounce and 50 ms local sync debounce in the current iOS implementation.

Canvas preview

docs.widget.preview
68
0255
Slider

Widget contract

PropertyValue
Raw typeSLIDER
Default size8 x 1
Minimum size3 x 1
Resize modehorizontal
Pin requirementrequired
Pin supportVirtual, digital or analog pins depending on the board target and the app-side pinType.
Interactiveyes
TransmissionSingle numeric value with 100 ms send debounce and 50 ms local sync debounce in the current iOS implementation.

Allowed pin families

Virtual, digital or analog pins depending on the board target and the app-side pinType.

Transport path

Single numeric value with 100 ms send debounce and 50 ms local sync debounce in the current iOS implementation.

Operational limits

The web/docs examples serialize as integer by default, so fractional workflows need explicit firmware handling

Configuration surface

  • min/max define the firmware-facing range
  • sendOnReleaseOn switches between live stream and commit-on-release
  • maximumFractionDigits controls UI precision before serialization

Limits and caveats

  • The web/docs examples serialize as integer by default, so fractional workflows need explicit firmware handling
  • Digital pins are only sensible for coarse 0/1 style sliders

Protocol and implementation notes

  • Fast drags are debounced in the app before transport, so firmware should treat the latest received value as the canonical one.
  • If you need exact floating point precision, document it explicitly because many current flows serialize rounded numeric strings.

Firmware example

A minimal pattern that matches how this widget usually talks to the board.

slider.ino
BLYNK_WRITE(V1) {  int pwm = param.asInt();  analogWrite(LED_PIN, pwm);}

Layout notes

Canvas footprint

8 x 1

Default footprint in the Plynx canvas before user resizing.

Resize floor

3 x 1

The minimum size accepted by the app during drag-resize.

Interaction model

Live input

Whether the user edits state directly or only reads it.

Related widgets

Button

Momentary or toggle actuator for a single virtual or hardware pin.

Styled Button

A richer button with distinct on/off labels and color states.

Vertical Slider

Vertical range control for compact side panels and console-style layouts.

Step

Increment and decrement control with fixed step size and optional send-delta mode.