DOT

VVM

 DOCS

Version: 1.0 | 1.1 |

RadioButton

in namespace DotVVM.Framework.Controls.Bootstrap

Extends the default RadioButton control with additional Bootstrap features.

Properties

Name Type Description Notes Default Value
Checked Boolean Gets or sets whether the control is checked.
attribute
inner element
static value
bindable
default
False
CheckedItem Object Gets or sets the CheckedValue of the first RadioButton that is checked and bound to this collection.
attribute
inner element
static value
bindable
default
CheckedValue Object Gets or sets the value that will be used as a result when the control is checked. Use this property in combination with the CheckedItem or CheckedItems property.
attribute
inner element
static value
bindable
default
ClientIDMode ClientIDMode Gets or sets the client ID generation algorithm.
attribute
inner element
static value
bindable
default
1
DataContext Object Gets or sets a data context for the control and its children. All value and command bindings are evaluated in context of this value.
attribute
inner element
static value
bindable
default
Enabled Boolean Gets or sets a value indicating whether the control is enabled and can be clicked on.
attribute
inner element
static value
bindable
default
True
GroupName String Gets or sets an unique name of the radio button group.
attribute
inner element
static value
bindable
default
ID String Gets or sets the unique control ID.
attribute
inner element
static value
bindable
default
InnerText String Gets or sets the inner text of the HTML element.
attribute
inner element
static value
bindable
default
IsInline Boolean Gets or sets whether there will be more radio buttons on the same line. When this propererty is true, the radio button gets the Boostrap "inline" CSS class.
attribute
inner element
static value
bindable
default
False
Text String Gets or sets the label text that is rendered next to the control.
attribute
inner element
static value
bindable
default
Type BootstrapColor Gets or sets the Bootstrap color.
attribute
inner element
static value
bindable
default
0
Visible Boolean Gets or sets whether the control is visible.
attribute
inner element
static value
bindable
default
True

Events

Name Type Description
Changed Command Gets or sets the command that will be triggered when the control check state is changed.

Usage & Scenarios

Extends the builtin RadioButton control with an option to set Bootstrap CSS classes and support of the ButtonGroup.

http://getbootstrap.com/css/#forms-controls

HTML Rendered by the Control

Sample 1: Inline RadioButtons

The IsInline property allows to render checkboxes on one row.

If the RadioButtons are placed inside the ButtonGroup control, they are set to inline by default so you don't have to change anything.

<bs:RadioButton Text="RadioButton 1" GroupName="RadioButtons" 
                CheckedValue="RadioButton 1" CheckedItem="{value: Radio}" 
                Inline="true" />
<bs:RadioButton Text="RadioButton 2" GroupName="RadioButtons" 
                CheckedValue="RadioButton 2" CheckedItem="{value: Radio}"
                Inline="true" />
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using DotVVM.Framework.ViewModel;

namespace DotvvmWeb.Views.Docs.Controls.bootstrap.RadioButton.sample1
{
    public class ViewModel : DotvvmViewModelBase
    {
        public string Radio { get; set; }
    }
}

Sample 2: RadioButton in ButtonGroup

You can change the color of the RadioButton using the Type property.

This property works only inside the ButtonGroup control.

<bs:ButtonGroup>
  <bs:RadioButton GroupName="RadioButtons" CheckedValue="RadioButton 1" 
                  CheckedItem="{value: Radio}" Text="RadioButton - Default" 
                  Type="Default" />
  <bs:RadioButton GroupName="RadioButtons" CheckedValue="RadioButton 2"  
                  CheckedItem="{value: Radio}" Text="RadioButton - Primary"  
                  Type="Primary" />
  <bs:RadioButton GroupName="RadioButtons" CheckedValue="RadioButton 3"  
                  CheckedItem="{value: Radio}" Text="RadioButton - Success"  
                  Type="Success" />
  <bs:RadioButton GroupName="RadioButtons" CheckedValue="RadioButton 4"  
                  CheckedItem="{value: Radio}" Text="RadioButton - Info"  
                  Type="Info" />
  <bs:RadioButton GroupName="RadioButtons" CheckedValue="RadioButton 4"  
                  CheckedItem="{value: Radio}" Text="RadioButton - Warning"  
                  Type="Warning" />
  <bs:RadioButton GroupName="RadioButtons" CheckedValue="RadioButton 4"  
                  CheckedItem="{value: Radio}" Text="RadioButton - Danger"  
                  Type="Danger" />
</bs:ButtonGroup>
using DotVVM.Framework.ViewModel;

namespace DotvvmWeb.Views.Docs.Controls.bootstrap.RadioButton.sample2
{
    public class ViewModel : DotvvmViewModelBase
    {
        public string Radio { get; set; }
    }
}

Suggestions


Help & Contribute

The documentation is maintained on GitHub.
We'll be happy if you edit the page and create a pull request.

Send message