The <radiogroup> component encloses a list of
<radiobutton>s. It ensures that a single
item is selected at a time. Initially it will select the first item in
a group if none is set to be selected. By default the radio buttons
are spaced vertically.
In the following example, the second radio button is selected. The text
that appears is separate from the value that is represented by each item.
In this example, group1.value is 2.
<canvas width="200" height="100">
<radiogroup id="group1">
<radiobutton value="1" text="one"/>
<radiobutton value="2" text="two" selected="true"/>
<radiobutton value="3" text="three"/>
</radiogroup>
</canvas>
You can use radio group with your own layout attribute, by overriding the
<view> layout attribute. The example below uses a wrapping layout
to create two columns of radio buttons. Note that a height must be given to
indicate to the layout where to wrap.
<canvas width="200" height="100">
<radiogroup height="60" layout="class:wrappinglayout; axis:y">
<radiobutton value="1" text="one"/>
<radiobutton value="2" text="two"/>
<radiobutton value="3" text="three"/>
<radiobutton value="4" text="four"/>
<radiobutton value="5" text="five"/>
<radiobutton value="6" text="six"/>
</radiogroup>
</canvas>
A radiogroup can contain a set of any <baselistitem>.
To make radio buttons with
a different look and feel, create a subclass of <baselistitem> to use instead
of the <radiobutton> class.
| Name | Type (tag) | Type (js) | Default | Category |
|---|---|---|---|---|
layout
|
expression | any | class: simplelayout; axis: y; spacing:5 | read/write |
| The layout to use for the radiogroup. The default is simplelayout with spacing 5. Note: if you use another layout, be sure to include the layout library file. | ||||
Attributes inherited from <baselist>
dataoption, defaultselection, itemclassname, multiselect, toggleselected
Attributes inherited from <baseformitem>
changed, ignoreform, rollbackvalue, submit, submitname, value
Attributes inherited from <basecomponent>
doesenter, enabled, hasdefault, isdefault, style, styleable, text
Attributes inherited from <view>
aaactive, aadescription, aaname, aasilent, aatabindex, align, bgcolor, cachebitmap, clickable, clickregion, clip, contextmenu, cursor, fgcolor, focusable, focustrap, font, fontsize, fontstyle, frame, framesloadratio, hassetheight, hassetwidth, height, layout, loadratio, mask, opacity, pixellock, playing, proxyurl, resource, resourceheight, resourcewidth, rotation, showhandcursor, source, stretches, subviews, totalframes, unstretchedheight, unstretchedwidth, valign, visibility, visible, width, x, xoffset, y, yoffset
Attributes inherited from <node>
classroot, cloneManager, datapath, defaultplacement, id, ignoreplacement, immediateparent, inited, initstage, name, nodeLevel, options, parent, placement, subnodes
Methods
Methods inherited from <baselist>
addItem, clearSelection, getItem, getItemAt, getNumItems, getSelection, getText, getValue, moveSelection, removeAllItems, removeItem, removeItemAt, select, selectItem, selectItemAt, selectNext, selectPrev, setHilite
Methods inherited from <baseformitem>
commit, destroy, findForm, init, rollback, setChanged, setValue, toXML
Methods inherited from <basecomponent>
acceptValue, doEnterDown, doEnterUp, doSpaceDown, doSpaceUp, presentValue, setStyle, setTint, updateDefault
Methods inherited from <view>
bringToFront, containsPt, getAttributeRelative, getBounds, getColor, getColorTransform, getContextMenu, getCurrentTime, getDepthList, getID3, getMouse, getNextSelection, getPan, getPrevSelection, getProxyURL, getTotalTime, getVolume, init, measureHeight, measureWidth, play, proxyurl, releaseLayouts, searchSubviews, seek, sendAAEvent, sendBehind, sendInFrontOf, sendToBack, setAAActive, setAADescription, setAAName, setAASilent, setAATabIndex, setAccessible, setAlign, setAttributeRelative, setBGColor, setClickable, setColor, setColorTransform, setContextMenu, setCursor, setHeight, setLayout, setOpacity, setPan, setPlay, setProxyPolicy, setProxyURL, setResource, setResourceNumber, setRotation, setShowHandCursor, setSource, setValign, setVisibility, setVisible, setVolume, setWidth, setX, setXOffset, setY, setYOffset, shouldYieldFocus, stop, stretchResource, unload, updateResourceSize
Methods inherited from <node>
animate, applyConstraint, applyConstraintMethod, applyData, childOf, completeInstantiation, construct, createChildren, dataBindAttribute, destroy, determinePlacement, getAttribute, getOption, getUID, init, lookupSourceLocator, releaseConstraint, releaseConstraintMethod, searchImmediateSubnodes, searchSubnodes, setData, setDatapath, setOption, setSelected, updateData
Events
Events inherited from <view>
onaddsubview, onblur, onclick, ondblclick, onerror, onfocus, onframe, onframesloadratio, onheight, onkeydown, onkeyup, onlastframe, onload, onloadratio, onmousedown, onmousedragin, onmousedragout, onmouseout, onmouseover, onmouseup, onmouseupoutside, onopacity, onplay, onremovesubview, onstop, ontimeout, onvisible, onwidth, onx, ony