Toggle switch

Toggle switch is used to immediately toggle a setting on or off.

v0.35.1AlphaNot reviewed for accessibility

Description

The ToggleSwitch component is a button that toggles between two boolean states. It is meant to be used for settings that should cause an immediate update. If configured with a "src" attribute, the component will make a POST request containing data of the form "value: 0 | 1".

Arguments

NameTypeDefaultDescription
src
String

nil

The URL to POST to when the toggle switch is toggled. If nil, the toggle switch will not make any requests.

csrf_token
String

nil

A CSRF token that will be sent to the server as "authenticity_token" when the toggle switch is toggled. Unused if src is nil.

checked
Boolean

false

Whether the toggle switch is on or off.

enabled
Boolean

true

Whether or not the toggle switch responds to user input.

size
Symbol

:medium

What size toggle switch to render. One of :medium or :small.

status_label_position
Symbol

:start

Which side of the toggle switch to render the status label. One of :end or :start.

turbo
Boolean

false

Whether or not to request a turbo stream and render the response as such.

system_arguments
Hash

N/A

Examples