Class: Yattho::Alpha::ToggleSwitch
- Defined in:
- app/components/yattho/alpha/toggle_switch.rb
Overview
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”.
Constant Summary collapse
- SIZE_DEFAULT =
:medium
- SIZE_MAPPINGS =
{ SIZE_DEFAULT => nil, :small => "ToggleSwitch--small" }.freeze
- SIZE_OPTIONS =
SIZE_MAPPINGS.keys.freeze
- STATUS_LABEL_POSITION_DEFAULT =
:start
- STATUS_LABEL_POSITION_MAPPINGS =
{ STATUS_LABEL_POSITION_DEFAULT => nil, :end => "ToggleSwitch--statusAtEnd" }.freeze
- STATUS_LABEL_POSITION_OPTIONS =
STATUS_LABEL_POSITION_MAPPINGS.keys.freeze
Constants inherited from Component
Component::INVALID_ARIA_LABEL_TAGS
Constants included from Status::Dsl
Constants included from ViewHelper
Constants included from TestSelectorHelper
TestSelectorHelper::TEST_SELECTOR_TAG
Constants included from FetchOrFallbackHelper
FetchOrFallbackHelper::InvalidValueError
Instance Method Summary collapse
- #disabled? ⇒ Boolean
- #enabled? ⇒ Boolean
-
#initialize(src: nil, csrf_token: nil, checked: false, enabled: true, size: SIZE_DEFAULT, status_label_position: STATUS_LABEL_POSITION_DEFAULT, **system_arguments) ⇒ ToggleSwitch
constructor
A new instance of ToggleSwitch.
- #on? ⇒ Boolean
Methods inherited from Component
Methods included from JoinStyleArgumentsHelper
Methods included from TestSelectorHelper
Methods included from FetchOrFallbackHelper
#fetch_or_fallback, #fetch_or_fallback_boolean, #silence_deprecations?
Methods included from ClassNameHelper
Constructor Details
#initialize(src: nil, csrf_token: nil, checked: false, enabled: true, size: SIZE_DEFAULT, status_label_position: STATUS_LABEL_POSITION_DEFAULT, **system_arguments) ⇒ ToggleSwitch
Returns a new instance of ToggleSwitch.
48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 |
# File 'app/components/yattho/alpha/toggle_switch.rb', line 48 def initialize(src: nil, csrf_token: nil, checked: false, enabled: true, size: SIZE_DEFAULT, status_label_position: STATUS_LABEL_POSITION_DEFAULT, **system_arguments) @src = src @csrf_token = csrf_token @checked = checked @enabled = enabled @system_arguments = system_arguments @size = fetch_or_fallback(SIZE_OPTIONS, size, SIZE_DEFAULT) @status_label_position = fetch_or_fallback( STATUS_LABEL_POSITION_OPTIONS, status_label_position, STATUS_LABEL_POSITION_DEFAULT ) @system_arguments[:classes] = class_names( @system_arguments.delete(:classes), "ToggleSwitch", on? ? "ToggleSwitch--checked" : nil, enabled? ? nil : "ToggleSwitch--disabled", STATUS_LABEL_POSITION_MAPPINGS[@status_label_position], SIZE_MAPPINGS[@size] ) @system_arguments[:src] = @src if @src return unless @src && @csrf_token @system_arguments[:csrf] = @csrf_token end |
Instance Method Details
#disabled? ⇒ Boolean
85 86 87 |
# File 'app/components/yattho/alpha/toggle_switch.rb', line 85 def disabled? !enabled? end |
#enabled? ⇒ Boolean
81 82 83 |
# File 'app/components/yattho/alpha/toggle_switch.rb', line 81 def enabled? @enabled end |
#on? ⇒ Boolean
77 78 79 |
# File 'app/components/yattho/alpha/toggle_switch.rb', line 77 def on? @checked end |