Button
in namespace DotVVM.Framework.Controls.Bootstrap4
Extends the built-in Button control to allow applying Bootstrap CSS classes to the button.
Usage & Scenarios
Extends the built-in Button control to allow applying Bootstrap CSS classes to the button and sizes.
Sample 1: Button Sizing
Use the Size
property to set the size of the button.
<bs:Button Click="{command: DoSomething()}"
Text="Button" />
<bs:Button Click="{command: DoSomething()}"
Text="Button"
Size="Large" />
<bs:Button Click="{command: DoSomething()}"
Text="Button"
Size="Small" />
public class ViewModel : DotvvmViewModelBase
{
public void DoSomething()
{
}
}
Sample 2: Button Types
The Type
property specifies the color of the button (using standard Bootstrap classes).
<bs:Button Click="{command: DoSomething()}"
Text="Primary"
Type="Primary" />
<bs:Button Click="{command: DoSomething()}"
Text="Secondary"
Type="Secondary" />
<bs:Button Click="{command: DoSomething()}"
Text="Success"
Type="Success" />
<bs:Button Click="{command: DoSomething()}"
Text="Danger"
Type="Danger" />
<bs:Button Click="{command: DoSomething()}"
Text="Warning"
Type="Warning" />
<bs:Button Click="{command: DoSomething()}"
Text="Info"
Type="Info" />
<bs:Button Click="{command: DoSomething()}"
Text="Light"
Type="Light" />
<bs:Button Click="{command: DoSomething()}"
Text="Dark"
Type="Dark" />
<bs:Button Click="{command: DoSomething()}"
Text="Link"
Type="Link" />
public class ViewModel : DotvvmViewModelBase
{
public void DoSomething()
{
}
}
Sample 3: Button Shapes
The VisualStyle
property allows to switch between buttons with solid fill and outline buttons.
<bs:Button Click="{command: DoSomething()}"
Text="Solid Fill"
Type="Primary"
VisualStyle="SolidFill" />
<bs:Button Click="{command: DoSomething()}"
Text="Outline"
Type="Primary"
VisualStyle="Outline" />
public class ViewModel : DotvvmViewModelBase
{
public void DoSomething()
{
}
}
Sample 4: Block Buttons
To make the button behave like a block element, use the IsBlockButton
property.
<bs:Button Click="{command: DoSomething()}"
Text="Solid Fill"
Type="Primary"
IsBlockButton="true" />
public class ViewModel : DotvvmViewModelBase
{
public void DoSomething()
{
}
}
Properties
Name | Type | Description | Notes | Default Value | |
---|---|---|---|---|---|
ButtonTagName | ButtonTagName | Gets or sets whether the control should render the <input> or the <button> tag in the HTML. |
attribute
static value
|
input | |
ClientIDMode | ClientIDMode | Gets or sets the client ID generation algorithm. |
attribute
static value
|
Static | |
ContentTemplate | ITemplate |
inner element
static value
default
|
null | ||
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. The DataContext is null in client-side templates. |
attribute
bindable
|
null | |
Enabled | Boolean | Gets or sets a value indicating whether the button is enabled and can be clicked on. |
attribute
static value
bindable
|
True | |
ID | String | Gets or sets the control client ID within its naming container. |
attribute
static value
bindable
|
null | |
IncludeInPage | Boolean | Gets or sets whether the control is included in the DOM of the page. |
attribute
bindable
|
True | |
InnerText | String | Gets or sets the inner text of the HTML element. Note that this property can only be used on HtmlGenericControl directly and when the control does not have any children. |
attribute
static value
bindable
|
null | |
IsBlockButton | Boolean | Gets or sets whether the button should be styled as a block element. |
attribute
static value
|
False | |
IsSubmitButton | Boolean | Gets or sets whether the control should render a submit button or a normal button (type="submit" or type="button"). The submit button has some special features in the browsers, e.g. handles the Return key in HTML forms etc. |
attribute
static value
|
False | |
Size | Size | Gets or sets the size of the button. |
attribute
static value
bindable
|
Default | |
Text | String | Gets or sets the text on the button. |
attribute
static value
bindable
|
||
Type | BootstrapButtonColor | Gets or sets the color of the button. |
attribute
static value
bindable
|
Primary | |
Visible | Boolean | Gets or sets whether the control is visible. When set to false, `style="display: none"` will be added to this control. |
attribute
bindable
|
True | |
VisualStyle | ButtonVisualStyle | Gets or sets whether the button has solid fill, or whether it is only an outline. |
attribute
static value
bindable
|
SolidFill |
Events
Name | Type | Description | |
---|---|---|---|
Click | Command | Gets or sets the command that will be triggered when the button is clicked. |