Class ToggleButton

java.lang.Object
com.vaadin.flow.component.Component
com.vaadin.flow.component.AbstractField<com.vaadin.flow.component.checkbox.Checkbox, Boolean>
com.vaadin.flow.component.AbstractSinglePropertyField<com.vaadin.flow.component.checkbox.Checkbox, Boolean>
com.vaadin.flow.component.checkbox.Checkbox
org.vaadin.firitin.components.checkbox.VCheckBox
org.vaadin.firitin.components.checkbox.ToggleButton
All Implemented Interfaces:
com.vaadin.flow.component.AttachNotifier, com.vaadin.flow.component.BlurNotifier<com.vaadin.flow.component.checkbox.Checkbox>, com.vaadin.flow.component.ClickNotifier<com.vaadin.flow.component.checkbox.Checkbox>, com.vaadin.flow.component.DetachNotifier, com.vaadin.flow.component.Focusable<com.vaadin.flow.component.checkbox.Checkbox>, com.vaadin.flow.component.FocusNotifier<com.vaadin.flow.component.checkbox.Checkbox>, com.vaadin.flow.component.HasAriaDescription, com.vaadin.flow.component.HasAriaLabel, com.vaadin.flow.component.HasElement, com.vaadin.flow.component.HasEnabled, com.vaadin.flow.component.HasHelper, com.vaadin.flow.component.HasLabel, com.vaadin.flow.component.HasSize, com.vaadin.flow.component.HasStyle, com.vaadin.flow.component.HasTheme, com.vaadin.flow.component.HasValidation, com.vaadin.flow.component.HasValue<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<com.vaadin.flow.component.checkbox.Checkbox, Boolean>, Boolean>, com.vaadin.flow.component.HasValueAndElement<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<com.vaadin.flow.component.checkbox.Checkbox, Boolean>, Boolean>, com.vaadin.flow.component.shared.HasThemeVariant<com.vaadin.flow.component.checkbox.CheckboxVariant>, com.vaadin.flow.component.shared.HasTooltip, com.vaadin.flow.component.shared.HasValidationProperties, com.vaadin.flow.component.shared.InputField<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<com.vaadin.flow.component.checkbox.Checkbox, Boolean>, Boolean>, com.vaadin.flow.data.binder.HasValidator<Boolean>, Serializable, FluentAttachNotifier<VCheckBox>, FluentBlurNotifier<com.vaadin.flow.component.checkbox.Checkbox, VCheckBox>, FluentClickNotifier<com.vaadin.flow.component.checkbox.Checkbox, VCheckBox>, FluentComponent<VCheckBox>, FluentDetachNotifier<VCheckBox>, FluentFocusable<com.vaadin.flow.component.checkbox.Checkbox, VCheckBox>, FluentFocusNotifier<com.vaadin.flow.component.checkbox.Checkbox, VCheckBox>, FluentHasEnabled<VCheckBox>, FluentHasHelper<VCheckBox>, FluentHasSize<VCheckBox>, FluentHasStyle<VCheckBox>, FluentHasTooltip<VCheckBox>, FluentHasValueAndElement<VCheckBox, com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<com.vaadin.flow.component.checkbox.Checkbox, Boolean>, Boolean>, FluentHasAutofocus<VCheckBox>, FluentHasLabel<VCheckBox>

@StyleSheet("context://assets/org/vaadin/firitin/components/toggle-button.css") @Deprecated(forRemoval=true) public class ToggleButton extends VCheckBox
Deprecated, for removal: This API element is subject to removal in a future version.
Use Switch instead.
A toggle button that is essentially a styled checkbox. CSS derived from similarly named Vaadin add-on to be compatible with the latest Vaadin 24.7.

Both Lumo and Aura are supported: the stylesheet detects the active theme in the browser (Aura's --vaadin-aura-theme marker via a style container query), so no configuration is needed.

By default the label is shown first and the switch after it, like in the settings lists of iOS and Android: a switch is typically an instantly applied setting, so one reads what it is about before its state. When mixed with regular checkboxes in a form, it may be better to align the controls the same way and put the switch first by removing the reverse variant: removeThemeVariants(CheckboxVariant.AURA_REVERSE) (works with Lumo too).

See Also:
  • Nested Class Summary

    Nested classes/interfaces inherited from class com.vaadin.flow.component.checkbox.Checkbox

    com.vaadin.flow.component.checkbox.Checkbox.CheckboxI18n

    Nested classes/interfaces inherited from class com.vaadin.flow.component.AbstractField

    com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<C,V>

    Nested classes/interfaces inherited from interface com.vaadin.flow.component.BlurNotifier

    com.vaadin.flow.component.BlurNotifier.BlurEvent<C>

    Nested classes/interfaces inherited from interface com.vaadin.flow.component.FocusNotifier

    com.vaadin.flow.component.FocusNotifier.FocusEvent<C>

    Nested classes/interfaces inherited from interface com.vaadin.flow.component.HasValue

    com.vaadin.flow.component.HasValue.ValueChangeEvent<V>, com.vaadin.flow.component.HasValue.ValueChangeListener<E>
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static Class<?>
    Deprecated, for removal: This API element is subject to removal in a future version.
    No longer used, the theme is now detected automatically in the browser.
  • Constructor Summary

    Constructors
    Constructor
    Description
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    ToggleButton(boolean initialValue)
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    ToggleButton(String labelText)
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    ToggleButton(String labelText, boolean initialValue)
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    ToggleButton(String label, com.vaadin.flow.component.HasValue.ValueChangeListener<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<com.vaadin.flow.component.checkbox.Checkbox, Boolean>> listener)
    Deprecated, for removal: This API element is subject to removal in a future version.
     
  • Method Summary

    Methods inherited from class VCheckBox

    withAriaLabel, withIndeterminate

    Methods inherited from class com.vaadin.flow.component.checkbox.Checkbox

    bindIndeterminate, getAriaDescribedBy, getAriaLabel, getAriaLabelledBy, getDefaultValidator, getI18n, getLabel, isAutofocus, isIndeterminate, isRequiredIndicatorVisible, setAriaDescribedBy, setAriaLabel, setAriaLabelledBy, setAutofocus, setI18n, setIndeterminate, setLabel, setLabelComponent, setManualValidation, setRequiredIndicatorVisible, validate

    Methods inherited from class com.vaadin.flow.component.AbstractSinglePropertyField

    getSynchronizationRegistration, hasValidValue, setPresentationValue, setSynchronizedEvent

    Methods inherited from class com.vaadin.flow.component.AbstractField

    addValueChangeListener, bindValue, getEmptyValue, getValue, isEmpty, setModelValue, setValue, valueEquals

    Methods inherited from class com.vaadin.flow.component.Component

    addListener, bindVisible, findAncestor, fireEvent, from, get, getChildren, getElement, getEventBus, getId, getListeners, getLocale, getParent, getTestId, getTranslation, getTranslation, getTranslation, getTranslation, getTranslation, getTranslation, getUI, hasListener, isAttached, isTemplateMapped, isVisible, onAttach, onDetach, onEnabledStateChanged, removeFromParent, scrollIntoView, scrollIntoView, set, setElement, setId, setTestId, setVisible, whenAttached

    Methods inherited from class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    Methods inherited from interface com.vaadin.flow.component.AttachNotifier

    addAttachListener

    Methods inherited from interface com.vaadin.flow.component.BlurNotifier

    addBlurListener

    Methods inherited from interface com.vaadin.flow.component.ClickNotifier

    addClickListener, addClickShortcut, addDoubleClickListener, addSingleClickListener

    Methods inherited from interface com.vaadin.flow.component.DetachNotifier

    addDetachListener

    Methods inherited from interface FluentAttachNotifier

    withAttachListener

    Methods inherited from interface FluentBlurNotifier

    withBlurListener

    Methods inherited from interface FluentClickNotifier

    withClickListener

    Methods inherited from interface FluentComponent

    navigate, setId, setVisible, withId, withVisible

    Methods inherited from interface FluentDetachNotifier

    withDetachListener

    Methods inherited from interface FluentFocusable

    withTabIndex

    Methods inherited from interface FluentFocusNotifier

    withFocusListener

    Methods inherited from interface FluentHasAutofocus

    isAutofocus, setAutofocus, withAutofocus

    Methods inherited from interface FluentHasEnabled

    withEnabled

    Methods inherited from interface FluentHasHelper

    withHelperComponent, withHelperText

    Methods inherited from interface FluentHasLabel

    withLabel

    Methods inherited from interface FluentHasStyle

    getStyle, withAddedClassName, withClassName, withStyle

    Methods inherited from interface FluentHasTooltip

    withTooltip

    Methods inherited from interface com.vaadin.flow.component.Focusable

    addFocusShortcut, blur, focus, focus, getTabIndex, setTabIndex

    Methods inherited from interface com.vaadin.flow.component.FocusNotifier

    addFocusListener

    Methods inherited from interface com.vaadin.flow.component.HasAriaDescription

    setAriaDescribedBy

    Methods inherited from interface com.vaadin.flow.component.HasAriaLabel

    setAriaLabelledBy

    Methods inherited from interface com.vaadin.flow.component.HasElement

    getElement

    Methods inherited from interface com.vaadin.flow.component.HasEnabled

    bindEnabled, isEnabled, setEnabled

    Methods inherited from interface com.vaadin.flow.component.HasHelper

    bindHelperText, getHelperComponent, getHelperText, setHelperComponent, setHelperText

    Methods inherited from interface com.vaadin.flow.component.HasLabel

    getLabel, setLabel

    Methods inherited from interface com.vaadin.flow.component.HasSize

    bindHeight, bindWidth, getHeight, getHeightUnit, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getWidth, getWidthUnit, setHeight, setHeight, setHeightFull, setMaxHeight, setMaxHeight, setMaxWidth, setMaxWidth, setMinHeight, setMinHeight, setMinWidth, setMinWidth, setSizeFull, setSizeUndefined, setWidth, setWidth, setWidthFull

    Methods inherited from interface com.vaadin.flow.component.HasStyle

    addClassName, addClassNames, bindClassName, bindClassNames, getClassName, getClassNames, hasClassName, removeClassName, removeClassNames, setClassName, setClassName

    Methods inherited from interface com.vaadin.flow.component.HasTheme

    addThemeName, addThemeNames, bindThemeName, bindThemeNames, getThemeName, getThemeNames, hasThemeName, removeThemeName, removeThemeNames, setThemeName, setThemeName

    Methods inherited from interface com.vaadin.flow.component.shared.HasThemeVariant

    addThemeVariants, bindThemeVariant, bindThemeVariants, removeThemeVariants, setThemeVariant, setThemeVariants, setThemeVariants

    Methods inherited from interface com.vaadin.flow.component.shared.HasTooltip

    getTooltip, setTooltipMarkdown, setTooltipText

    Methods inherited from interface com.vaadin.flow.component.shared.HasValidationProperties

    getErrorMessage, isInvalid, setErrorMessage, setInvalid

    Methods inherited from interface com.vaadin.flow.data.binder.HasValidator

    addValidationStatusChangeListener

    Methods inherited from interface com.vaadin.flow.component.HasValue

    addValueChangeListener, bindValue, clear, getEmptyValue, getOptionalValue, getValue, isEmpty, setValue

    Methods inherited from interface com.vaadin.flow.component.HasValueAndElement

    bindReadOnly, bindRequiredIndicatorVisible, isReadOnly, setReadOnly
  • Field Details

    • baseTheme

      @Deprecated(forRemoval=true) public static Class<?> baseTheme
      Deprecated, for removal: This API element is subject to removal in a future version.
      No longer used, the theme is now detected automatically in the browser. Will be removed in a future version.
  • Constructor Details

    • ToggleButton

      public ToggleButton()
      Deprecated, for removal: This API element is subject to removal in a future version.
    • ToggleButton

      public ToggleButton(boolean initialValue)
      Deprecated, for removal: This API element is subject to removal in a future version.
    • ToggleButton

      public ToggleButton(String labelText, boolean initialValue)
      Deprecated, for removal: This API element is subject to removal in a future version.
    • ToggleButton

      public ToggleButton(String label, com.vaadin.flow.component.HasValue.ValueChangeListener<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<com.vaadin.flow.component.checkbox.Checkbox, Boolean>> listener)
      Deprecated, for removal: This API element is subject to removal in a future version.
    • ToggleButton

      public ToggleButton(String labelText)
      Deprecated, for removal: This API element is subject to removal in a future version.