Introduction

Adapted content for the RadioButtonList control is available through the RadioButtonListAdapter or the ControlAdapters.WebControls.RadioButtonList control.

HTML Rendering

The RadioButtonList has two rendering modes.

1. Block mode, using RepeatLayout.Table, renders the RadioButtonList in an unordered list (ul), with each radio button/label included in a list item (li)
2. Flow mode, using RepeatLayout.Flow, renders the RadioButtonList inside a span, with minimal additional formatting.

Sample Markup

ASP.Net Code:

<asp:RadioButtonList ID="RadioButtonList1" runat="server" repeatLayout="Table">
	<asp:ListItem Value="0">Normal</asp:ListItem>
	<asp:ListItem Value="1" Text="Disabled" Enabled="false" />
	<asp:ListItem Value="2" Text="Selected" Selected="True" />
	<asp:ListItem Value="NoText" />
	<asp:ListItem />
</asp:RadioButtonList>

Control Adapter markup (using default RepeatLayout.Table):

<ul id="RadioButtonList1" class="radioButtonList vertical">
	<li><input id="RadioButtonList1_0" name="RadioButtonList1" type="radio" value="0" tabindex="0" /><label for="RadioButtonList1_0">Normal</label></li>
	<li class="disabled"><input id="RadioButtonList1_1" name="RadioButtonList1" type="radio" value="1" disabled="disabled" tabindex="0" /><label for="RadioButtonList1_1">Disabled</label></li>
	<li><input id="RadioButtonList1_2" name="RadioButtonList1" type="radio" value="2" checked="checked" tabindex="0" /><label for="RadioButtonList1_2">Selected</label></li>
	<li><input id="RadioButtonList1_3" name="RadioButtonList1" type="radio" value="NoText" tabindex="0" /><label for="RadioButtonList1_3">NoText</label></li>
	<li><input id="RadioButtonList1_4" name="RadioButtonList1" type="radio" tabindex="0" /></li>
</ul>

Control Adapter markup (using default RepeatLayout.Flow):

<span id="RadioButtonList1" class="radioButtonList vertical">
	<input id="RadioButtonList1_0" name="RadioButtonList1" type="radio" value="0" tabindex="0" /><label for="RadioButtonList1_0">Normal</label>
	<span class="disabled"><input id="RadioButtonList1_1" name="RadioButtonList1" type="radio" value="1" disabled="disabled" tabindex="0" /><label for="RadioButtonList1_1">Disabled</label>
	<input id="RadioButtonList1_2" name="RadioButtonList1" type="radio" value="2" checked="checked" tabindex="0" /><label for="RadioButtonList1_2">Selected</label>
	<input id="RadioButtonList1_3" name="RadioButtonList1" type="radio" value="NoText" tabindex="0" /><label for="RadioButtonList1_3">NoText</label>
	<input id="RadioButtonList1_4" name="RadioButtonList1" type="checkbox" tabindex="0" />
</span>

Configuration

Configuration options include the following:

A sample configuration follows.

<RadioButtonList cssClass="radioButtonList" 
	  disabledCssClass="disabled" />

Implementation Notes

Recommended Default CSS

The following is a minimum recommended default CSS, using the sample configuration shown above.

ul.radioButtonList {
	list-style:none;
	margin: 0;
	padding: 0;
}
ul.radioButtonList.horizontal li {
	display: inline;
}
ul.radioButtonList li.disabled {
	color: Gray;
}

RadioButtonList Properties Supported

The following table outlines those properties of the RadioButtonList control that are implemented in the RadioButtonListAdapter control. Properties not listed are not supported or implemented.

ListItem Properties Supported

The following table outlines those properties of the RadioButtonList control's Items collection that are implemented in the RadioButtonListAdapter control. Properties not listed are not supported or implemented.