Radio
The Radio widget wraps an <input type="radio"> element.
Radio
//<code-header>
fiddle.title = 'Radio';
//</code-header>
new Container({
appendTo : targetElement,
items : [
{
type : 'radio',
name : 'basic-radio',
text : 'Yes',
checked : true
},
{
type : 'radio',
name : 'basic-radio',
text : 'No'
}
]
});Color can be specified, and you can optionally configure text to display in a label to the right of the radio button instead of, or in addition to, a standard field label.
Radio colors
//<code-header>
fiddle.title = 'Radio colors';
//</code-header>
new Container({
appendTo : targetElement,
items : [
{
tag : 'p',
style : 'font-weight:500',
html : 'Do you need jQuery in your web app?'
},
{
type : 'radio',
name : 'radios',
text : 'No',
checked : true,
checkedValue : 'A'
},
{
type : 'radio',
name : 'radios',
text : 'Probably not',
checkedValue : 'B'
},
{
type : 'radio',
name : 'radios',
checked : true,
text : 'Unlikely',
checkedValue : 'C'
}
]
});
new Container({
appendTo : targetElement,
style : 'margin-top:2em',
items : [
{
tag : 'p',
style : 'font-weight:500',
html : 'Are colored radio buttons awesome?'
},
// green radio
{
type : 'radio',
color : 'b-green',
checked : true,
name : 'coloredradios',
text : 'Sure',
checkedValue : 'A'
},
// blue radio
{
type : 'radio',
color : 'b-blue',
name : 'coloredradios',
text : 'Yes',
checkedValue : 'B'
},
// orange radio
{
type : 'radio',
color : 'b-orange',
name : 'coloredradios',
text : 'Kinda',
checkedValue : 'C'
},
// disabled radio
{
type : 'radio',
disabled : true,
name : 'coloredradios',
text : 'Disabled',
checkedValue : 'D'
}
]
});Nested Items
A radio button can also have a container of additional items. These items can be displayed immediately following the field's label (which is the default when there is only one item) or below the radio button. This can be controlled using the inline config.
In the demo below notice how additional fields are displayed for the checked radio button:
Radio items
//<code-header>
fiddle.title = 'Radio items';
//</code-header>
new Container({
appendTo : targetElement,
items : {
singleItem : {
type : 'radio',
text : 'Single item',
name : 'radioItems',
checkedValue : 'A',
autoCollapse : true,
container : [
{
type : 'textfield',
placeholder : 'Additional info...',
flex : 1
}
]
},
twoItems : {
type : 'radio',
text : 'Two items',
name : 'radioItems',
inline : true, // can also use false to wrap a single item
checkedValue : 'B',
autoCollapse : true,
container : {
from : {
type : 'textfield',
placeholder : 'From...',
flex : 1
},
to : {
type : 'textfield',
placeholder : 'To...',
flex : 1,
style : 'margin-inline-start: 1em'
}
}
},
childForm : {
type : 'radio',
text : 'Child form',
name : 'radioItems',
checkedValue : 'C',
autoCollapse : true,
container : {
from : {
type : 'textfield',
label : 'From',
width : 'auto'
},
to : {
type : 'textfield',
label : 'To',
width : 'auto'
}
}
}
}
});For a simpler way to create a set of radio buttons, see the RadioGroup widget.
Configs
112
Configs
112Common
listenersEvents
Other
Set this to true so that clicking a checked radio button will clear its checked state.
autoCollapseCheckbox
autoSelectField
callOnFunctionsWidget
checkedCheckbox
checkedValueCheckbox
colorCheckbox
columnWidget
editableField
keyStrokeChangeDelayField
nameField
placeholderField
readOnlyField
requiredField
revertOnEscapeField
rtlRTL
skipValidationField
spanWidget
textCheckbox
triggersField
uncheckedValueCheckbox
valueCheckbox
DOM
adoptWidget
appendToWidget
contentWidget
datasetWidget
htmlWidget
idWidget
insertBeforeWidget
insertFirstWidget
tagWidget
titleWidget
Float & align
alignWidget
anchorWidget
centeredWidget
constrainToWidget
draggableWidget
floatingWidget
hideAnimationWidget
maximizeOnMobileWidget
positionedWidget
scrollActionWidget
showAnimationWidget
xWidget
yWidget
Input element
autoCompleteField
inputAlignField
inputAttributesField
inputTagField
inputTypeField
inputWidthField
spellCheckField
tabIndexField
validateOnInputField
Label
hintField
hintHtmlField
labelLabelable
labelClsLabelable
labelPositionLabelable
labelsField
labelWidthLabelable
Layout
alignSelfWidget
dockWidget
flexWidget
heightWidget
hiddenWidget
marginWidget
maxHeightWidget
maxWidthWidget
minHeightWidget
minWidthWidget
textAlignWidget
weightWidget
widthWidget
Misc
badgeBadge
bubbleEventsEvents
dataFieldWidget
defaultBindPropertyWidget
disabledWidget
elementAttributesWidget
ignoreParentReadOnlyWidget
localeClassLocalizable
localizableLocalizable
localizablePropertiesLocalizable
maskDefaultsWidget
maskedWidget
monitorResizeWidget
ownerWidget
preventTooltipOnTouchWidget
refWidget
rippleWidget
rootElementWidget
showTooltipWhenDisabledWidget
tabWidget
tooltipWidget
Scrolling
scrollableWidget
Properties
85
Properties
85Class hierarchy
Identifies an object as an instance of Radio class, or subclass thereof.
Identifies an object as an instance of Radio class, or subclass thereof.
isBadgeBadge
isCheckboxCheckbox
isDelayableDelayable
isEventsEvents
isFieldField
isKeyMapKeyMap
isLabelableLabelable
isLocalizableLocalizable
isRTLRTL
isValidatableValidatable
isWidgetWidget
CSS
clsWidget
DOM
appendToWidget
contentWidget
contentElementWidget
datasetWidget
elementWidget
focusableElementWidget
focusElementWidget
htmlWidget
idWidget
insertBeforeWidget
insertFirstWidget
overflowElementWidget
styleWidget
Layout
alignSelfWidget
flexWidget
heightWidget
marginWidget
maxHeightWidget
maxWidthWidget
minHeightWidget
minWidthWidget
scrollableWidget
widthWidget
Misc
badgeBadge
callOnFunctionsEvents
cellInfoWidget
disabledWidget
errorTipValidatable
labelLabelable
localeHelperLocalizable
localeManagerLocalizable
refWidget
tabWidget
tooltipWidget
Functions
67
Functions
67Configuration
Events
detachListenersBase
Misc
animatePropertyBase
callbackBase
downloadTestCaseBase
resolveCallbackBase
updateLocalizationLocalizable
Other
addListenerEvents
announceAriaLiveWidget
checkCheckbox
clearField
clearErrorValidatable
composeWidget
createOnFrameDelayable
disableWidget
enableWidget
exitFullscreenWidget
focusWidget
getErrorsValidatable
hasListenerEvents
maskWidget
onEvents
recomposeWidget
relayAllEvents
removeAllListenersEvents
removeListenerEvents
requestFullscreenWidget
resumeEventsEvents
revertFocusWidget
selectField
setErrorValidatable
suspendEventsEvents
syncInputFieldValueField
toggleCheckbox
triggerEvents
unEvents
uncheckCheckbox
unmaskWidget
Widget hierarchy
closestWidget
containsWidget
eachAncestorWidget
eachWidgetWidget
ownsWidget
queryWidget
queryAllWidget
upWidget
Events
21
Events
21actionCheckbox
beforeChangeCheckbox
beforeDestroyEvents
beforeHideWidget
beforeShowWidget
catchAllEvents
changeCheckbox
clearField
clickCheckbox
destroyEvents
elementCreatedWidget
focusInWidget
focusOutWidget
hideWidget
inputField
paintWidget
readOnlyWidget
recomposeWidget
resizeWidget
showWidget
triggerField
Event handlers
21
Event handlers
21onActionCheckbox
onBeforeChangeCheckbox
onBeforeDestroyEvents
onBeforeHideWidget
onBeforeShowWidget
onCatchAllEvents
onChangeCheckbox
onClearField
onClickCheckbox
onDestroyEvents
onElementCreatedWidget
onFocusInWidget
onFocusOutWidget
onHideWidget
onInputField
onPaintWidget
onReadOnlyWidget
onRecomposeWidget
onResizeWidget
onShowWidget
onTriggerField
Typedefs
7
Typedefs
7AlignSpecWidget
BryntumListenerConfigEvents
CellWidgetContextWidget
ColorWidget
DelayableConfigDelayable
FieldTriggerConfigField
KeyMapConfigKeyMap
CSS variables
67
CSS variables
67| Name | Description |
|---|---|
--b-radio-check-gap | Size of the radio button "checkmark" (the dot) |
--b-radio-background | Radio button background |
| Checked | |
--b-radio-checked-background | Background of the radio button when checked |
--b-radio-checked-border-color | Radio button's border-color when checked |
--b-radio-checked-color | Color of the radio button "checkmark" (when checked) |