RadioButton

  • 2 min to read

RadioButton is a button control that can be selected, but not cleared, by an end-user. While paired with other radio buttons, RadioButton enables end-users to select a single option from a group of choices.

Implementation Details

RadioButton is realized by the RadioButtonExtension class. Its instance can be accessed via the ExtensionsFactory.RadioButton helper method, which is used to add a RadioButton extension to a view. This method's parameter provides access to the RadioButton settings implemented by the RadioButtonSettings class, allowing you to fully customize the extension.

RadioButton's client counterpart is represented by the ASPxClientRadioButton object.

Declaration

RadioButton can be added to a view in the following manner.

View code (ASPX):

<%
    Html.DevExpress().RadioButton(
        settings => {
            settings.Name = "RadioButton1";
            settings.Text = "Check me";
            settings.Checked = false;
            }
        )
        .Render();
%>    

View code (Razor):

@Html.DevExpress().RadioButton(
    settings => {
        settings.Name = "RadioButton1";
        settings.Text = "Check me";
        settings.Checked = false;
    }).GetHtml()
Note

The Partial View should contain only the extension's code.

The code result is demonstrated in the image below.

radio_button_declaration_mvc

Main Features

  • Native Rendering

    The RadioButton supports native rendering as a native HTML input element of the radio type. When the native HTML mode is enabled, an extension appearance depends on how a client browser renders native HTML elements. This reduces the render size and improves the editor's overall performance. Set the RadioButtonSettings.Properties.Native property value to true to enable native rendering.

  • Appearance Customization

    A radio button edit region (check mark) is represented by an image within the RadioButton editor by default. It is possible to assign your own images to be displayed for different check states.

    ASPxCheckBox_custom_images

    You can customize the extension appearance using predefined built-in visual themes. See this topic to learn more: Applying Themes.

  • Built-in Validation

    The RadioButton extension allows you to perform data validation both on the client and server side. See the Built-in Validation topic to learn more.

  • Full-Featured Client-Side API

    The RadioButton provides you with a comprehensive client-side API. This API is implemented using JavaScript and is exposed via the ASPxClientRadioButton object. The ASPxClientRadioButton object serves as a client-side equivalent of the RadioButton extension.