Class SJRadioButton

java.lang.Object

com.vaadin.flow.component.Component

com.vaadin.flow.component.AbstractField<VaadinRadioButton, Boolean>

com.vaadin.flow.component.AbstractSinglePropertyField<VaadinRadioButton, Boolean>

com.vaadin.swingbridge.surrogates.VaadinRadioButton

com.vaadin.swingbridge.surrogates.SJRadioButton

All Implemented Interfaces:

com.vaadin.flow.component.AttachNotifier, com.vaadin.flow.component.BlurNotifier<VaadinRadioButton>, com.vaadin.flow.component.ClickNotifier<VaadinRadioButton>, com.vaadin.flow.component.DetachNotifier, com.vaadin.flow.component.Focusable<VaadinRadioButton>, com.vaadin.flow.component.FocusNotifier<VaadinRadioButton>, com.vaadin.flow.component.HasElement, com.vaadin.flow.component.HasEnabled, com.vaadin.flow.component.HasLabel, com.vaadin.flow.component.HasSize, com.vaadin.flow.component.HasStyle, com.vaadin.flow.component.HasValue<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<VaadinRadioButton, Boolean>, Boolean>, com.vaadin.flow.component.HasValueAndElement<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<VaadinRadioButton, Boolean>, Boolean>, ComponentMixin, ContainerMixin, AbstractButtonMixin, JComponentMixin, ItemSelectable, Serializable

public class SJRadioButton
extends VaadinRadioButton
implements AbstractButtonMixin

Surrogate for JRadioButton. Extends VaadinRadioButton (our re-host of the public vaadin-radio-button web component, since Vaadin's own RadioButton Java wrapper is package-private) so it reaches the migrator either through the :emulators JRadioButton as peer, or as a standalone Vaadin radio button in its own right.

Mirrors SJToggleButton's override surface (SD_toggle_checkbox_first_cut precedent)

JDK's JRadioButton extends JToggleButton — both use JToggleButton.ToggleButtonModel, both deliver ButtonModel-driven Item / Change / Action fan-out, both render a toggleable widget that fires ValueChange on browser-side click. The only difference is the chosen peer (Vaadin Checkbox vs. VaadinRadioButton) and the rendered glyph (square check vs. circular radio). The peer hierarchy is parallel-not-shared (Vaadin Checkbox and our VaadinRadioButton have no common ancestor below Component), so this surrogate duplicates SJToggleButton's overrides verbatim — same constraint that drove SD_sjpasswordfield (SJPasswordField duplicating SJTextField).

ButtonGroup mutex lives at the emulator layer (D_buttongroup_browser_click)

The surrogate carries no awareness of any ButtonGroup. Stage-3 users wanting radio-group mutex use the emulator-side JRadioButton + vaadinx.swing.ButtonGroup per D_buttongroup; the group's setSelectedButton cascades setSelected(false) on the previous selection's emulator wrapper, which in turn calls sjr.setSelected(false) on this surrogate. The model→peer push wire then drives checked=false on the sibling's peer under preventPeerEvents — same path as a programmatic setSelected from any other caller.

Standalone (no group): clicks toggle on/off like a checkbox per the underlying ToggleButtonModel pulse. The "radio stays selected when clicked while already-selected" behaviour is a ButtonGroup-vetoes-deselect effect that only materialises once an emulator-layer group is wired around it.

Override surface against AbstractButtonMixin

Identical to SJToggleButton's list: installButtonBindings() (use ToggleButtonModel + ValueChange wire), setModel(ButtonModel) (extra model→peer push), setText(String) / getText() (route through peer's label slot, normalise null→""), setEnabled(boolean) (Java "classes beat interfaces" redirect), layout setters drop-and-WARN (shadow DOM doesn't honor host flex), getUIClassID() returns "RadioButtonUI".

See Also:

• Serialized Form

Nested Class Summary

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 AbstractButtonMixin

AbstractButtonMixin.ButtonActionPropertyChangeListener

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>

Nested classes/interfaces inherited from interface JComponentMixin

JComponentMixin.ActionStandin

Field Summary

Fields inherited from interface JComponentMixin

TOOL_TIP_TEXT_KEY, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Constructor Summary

Constructors

Constructor	Description
SJRadioButton()
SJRadioButton(String text)
SJRadioButton(String text, boolean selected)
SJRadioButton(String text, Icon icon)
SJRadioButton(String text, Icon icon, boolean selected)
SJRadioButton(Action action)
SJRadioButton(Icon icon)
SJRadioButton(Icon icon, boolean selected)

Method Summary

Modifier and Type	Method	Description
AccessibleContext	getAccessibleContext()
int	getHorizontalAlignment()
int	getHorizontalTextPosition()
int	getIconTextGap()	Reads CSS gap back as an int.
Insets	getMargin()	JDK default is null; no Vaadin counterpart.
String	getText()	Abstract — each concrete AbstractButton-lineage surrogate provides its own getText via the parent Vaadin component's HasText contract.
String	getUIClassID()	Deliberate no-op — L&F key.
int	getVerticalAlignment()
int	getVerticalTextPosition()
void	installButtonBindings()	Override of the mixin's default.
protected String	paramString()	JDK JRadioButton's paramString is essentially empty (returns AbstractButton's).
void	setEnabled(boolean enabled)	Java "classes beat interfaces" rule shadows the mixin chain's setEnabled (which carries SD_auto_pce auto-PCE + propagates to model) with HasEnabled's default.
void	setHorizontalAlignment(int alignment)
void	setHorizontalTextPosition(int pos)
void	setIconTextGap(int gap)
void	setModel(ButtonModel newModel)	Override of AbstractButtonMixin.setModel(ButtonModel) to additionally install a model→peer push ItemListener.
void	setText(String text)	Abstract — each concrete surrogate implements via super (its Vaadin parent's HasText.setText, e.g.
void	setVerticalAlignment(int alignment)
void	setVerticalTextPosition(int pos)

Methods inherited from class VaadinRadioButton

getLabel, setLabel

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 AbstractButtonMixin

actionPropertyChanged, addActionListener, addChangeListener, addItemListener, configurePropertiesFromAction, createActionPropertyChangeListener, doClick, doClick, fireActionPerformed, fireItemStateChanged, fireStateChanged, getAction, getActionCommand, getActionListeners, getChangeListeners, getDisabledIcon, getDisabledSelectedIcon, getDisplayedMnemonicIndex, getHideActionText, getItemListeners, getLabel, getMnemonic, getModel, getMultiClickThreshhold, getPressedIcon, getRolloverIcon, getRolloverSelectedIcon, getSelectedIcon, getSelectedObjects, isBorderPainted, isContentAreaFilled, isFocusPainted, isRolloverEnabled, isSelected, removeActionListener, removeChangeListener, removeItemListener, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setFocusPainted, setHideActionText, setIcon, setLabel, setMargin, setMnemonic, setMnemonic, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, synthesizePeerClick, updateUI

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 ComponentMixin

_installSwingClass, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, dispatchEvent, doLayout, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getComponentListeners, getCursor, getFocusListeners, getFont, getForeground, getGraphics, getHierarchyBoundsListeners, getHierarchyListeners, getKeyListeners, getLocation, getMaximumSize, getMinimumSize, getMouseListeners, getName, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolTipText, getX, getY, grabFocus, hasFocus, invalidate, isDisplayable, isFocusable, isFocusOwner, isShowing, paint, paintAll, print, printAll, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, revalidate, setBackground, setBounds, setBounds, setCursor, setFocusable, setFont, setForeground, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

Methods inherited from interface ContainerMixin

addContainerListener, getContainerListeners, getLayout, paintComponents, printComponents, removeContainerListener, setLayout

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

addDetachListener

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.HasElement

getElement

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

bindEnabled, isEnabled

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, getStyle, hasClassName, removeClassName, removeClassNames, setClassName, setClassName

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

clear, getOptionalValue

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

bindReadOnly, bindRequiredIndicatorVisible, isReadOnly, isRequiredIndicatorVisible, setReadOnly, setRequiredIndicatorVisible

Methods inherited from interface JComponentMixin

addAncestorListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getLocation, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, isDoubleBuffered, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paintImmediately, paintImmediately, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, requestDefaultFocus, resetKeyboardActions, reshape, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDoubleBuffered, setFocusTraversalKeys, setInheritsPopupMenu, setInputMap, setInputVerifier, setNextFocusableComponent, setOpaque, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, unregisterKeyboardAction

Constructor Details

SJRadioButton

public SJRadioButton()

SJRadioButton

public SJRadioButton(String text)

SJRadioButton

public SJRadioButton(String text,
 boolean selected)

SJRadioButton

public SJRadioButton(Icon icon)

SJRadioButton

public SJRadioButton(Icon icon,
 boolean selected)

SJRadioButton

public SJRadioButton(String text,
 Icon icon)

SJRadioButton

public SJRadioButton(String text,
 Icon icon,
 boolean selected)

SJRadioButton

public SJRadioButton(Action action)

Method Details

installButtonBindings

public void installButtonBindings()

Override of the mixin's default. Same three differences from the default as SJToggleButton: ToggleButtonModel as default, ValueChangeListener on the peer (HasValue<Boolean>) for browser-originated toggle, no inline-flex CSS seed (the radio-button shadow DOM doesn't honor host flex-* either). Idempotent.

Specified by:

installButtonBindings in interface AbstractButtonMixin

setModel

public void setModel(ButtonModel newModel)

Override of AbstractButtonMixin.setModel(ButtonModel) to additionally install a model→peer push ItemListener. Mirrors SJToggleButton's identically-shaped override; catches direct myModel.setSelected(...) mutations in addition to mixin-routed ones.

Specified by:

setModel in interface AbstractButtonMixin

getText

public String getText()

Description copied from interface: AbstractButtonMixin

Abstract — each concrete AbstractButton-lineage surrogate provides its own getText via the parent Vaadin component's HasText contract. SJButton's inherited Button.getText() (which reads textNode) satisfies this requirement automatically. Mixin-internal callers (e.g. AbstractButtonMixin.getActionCommand()'s text fallback, AbstractButtonMixin.setDisplayedMnemonicIndex(int)'s length validation) reach the concrete impl via virtual dispatch.

Pulled out of the mixin's default-implementation surface so the mixin doesn't need a reentry-flag dance to call back into the parent's HasText methods — the rendered text path is owned by the concrete surrogate, end of story.

Specified by:

getText in interface AbstractButtonMixin

setText

public void setText(String text)

Description copied from interface: AbstractButtonMixin

Abstract — each concrete surrogate implements via super (its Vaadin parent's HasText.setText, e.g. Button.setText → textSupport) plus the "text" PCE fire. Pulled out of the mixin's default surface for the same reason as AbstractButtonMixin.getText().

Specified by:

setText in interface AbstractButtonMixin

setEnabled

public void setEnabled(boolean enabled)

Java "classes beat interfaces" rule shadows the mixin chain's setEnabled (which carries SD_auto_pce auto-PCE + propagates to model) with HasEnabled's default. Redirect explicitly so the mixin chain runs.

Specified by:

setEnabled in interface ComponentMixin

Specified by:

setEnabled in interface com.vaadin.flow.component.HasEnabled

Specified by:

setEnabled in interface JComponentMixin

getHorizontalAlignment

public int getHorizontalAlignment()

Specified by:

getHorizontalAlignment in interface AbstractButtonMixin

setHorizontalAlignment

public void setHorizontalAlignment(int alignment)

Specified by:

setHorizontalAlignment in interface AbstractButtonMixin

getVerticalAlignment

public int getVerticalAlignment()

Specified by:

getVerticalAlignment in interface AbstractButtonMixin

setVerticalAlignment

public void setVerticalAlignment(int alignment)

Specified by:

setVerticalAlignment in interface AbstractButtonMixin

getHorizontalTextPosition

public int getHorizontalTextPosition()

Specified by:

getHorizontalTextPosition in interface AbstractButtonMixin

setHorizontalTextPosition

public void setHorizontalTextPosition(int pos)

Specified by:

setHorizontalTextPosition in interface AbstractButtonMixin

getVerticalTextPosition

public int getVerticalTextPosition()

Specified by:

getVerticalTextPosition in interface AbstractButtonMixin

setVerticalTextPosition

public void setVerticalTextPosition(int pos)

Specified by:

setVerticalTextPosition in interface AbstractButtonMixin

getIconTextGap

public int getIconTextGap()

Description copied from interface: AbstractButtonMixin

Reads CSS gap back as an int. Lossy CSS round-trip per R_vaadin_first — a gap CSS value with a non-px unit (we only ever write "Npx") would parse to the JDK default 4.

Specified by:

getIconTextGap in interface AbstractButtonMixin

setIconTextGap

public void setIconTextGap(int gap)

Specified by:

setIconTextGap in interface AbstractButtonMixin

getMargin

public Insets getMargin()

Description copied from interface: AbstractButtonMixin

JDK default is null; no Vaadin counterpart.

Specified by:

getMargin in interface AbstractButtonMixin

getUIClassID

public String getUIClassID()

Description copied from interface: JComponentMixin

Deliberate no-op — L&F key.

Specified by:

getUIClassID in interface AbstractButtonMixin

Specified by:

getUIClassID in interface JComponentMixin

paramString

protected String paramString()

JDK JRadioButton's paramString is essentially empty (returns AbstractButton's). Mirrors SJToggleButton's empty body.

getAccessibleContext

public AccessibleContext getAccessibleContext()