因为EditForm
组件呈现标准的<form>
HTML元素,所以实际上可以在我们的标记中使用标准的HTML表单元素,如<input>
和<select>
,但与EditForm
组件一样,我建议使用各种Blazor输入控件,因为它们附带验证等附加功能。
Blazor中提供了一个标准的输入组件集合,所有这些组件都是从基类InputBase<T>
派生出来的。
以下各节都将使用以下类进行绑定:
@code
{
SomeModel FormData = new SomeModel();
class SomeModel
{
public bool SomeBooleanProperty { get; set; }
public DateTime? SomeDateTimeProperty { get; set; }
public int SomeIntegerProperty { get; set; }
public decimal SomeDecimalProperty { get; set; }
public string SomeStringProperty { get; set; }
public string SomeMultiLineStringProperty { get; set; }
public SomeStateEnum SomeSelectProperty { get; set; } = SomeStateEnum.Active;
}
public enum SomeStateEnum
{
Pending,
Active,
Suspended
}
}
注意:可以为以下任何组件指定其他属性。Blazor没有明确识别的任何内容都将直接呈现到目标HTML元素上。
InputCheckbox
InputCheckbox
组件将布尔属性绑定到type="checkbox"
的HTML<input>
元素。此组件不允许绑定到可为Null的属性。
<InputCheckbox @bind-Value=FormData.SomeBooleanProperty />
InputDate
InputDate
组件将DateTime属性绑定到type="date"
的HTML<input>
元素。此组件将绑定到可为空的属性,但是,并非所有浏览器都提供在此类型的输入元素上指定空值的功能。
<InputDate @bind-Value=FormData.SomeDateTimeProperty ParsingErrorMessage="Must be a date" />
InputNumber
InputNumber
组件将任何类型的C#数字属性绑定到type="number"
的HTML<input>
元素。
如果无法将输入的值解析为目标属性类型,则输入将被视为无效(请参见表单验证),并且不会使用该值更新模型。
当target
属性可为空时,无效输入将被视为空,并且输入中的文本将被清除。
<InputNumber @bind-Value=FormData.SomeIntegerProperty ParsingErrorMessage="Must be an integer value" />
<InputNumber @bind-Value=FormData.SomeDecimalProperty ParsingErrorMessage="Must be a decimal value" />
InputText
InputText
组件将字符串属性绑定到未指定类型的HTML<input>
元素。这使我们能够指定任何可用的输入类型,如密码、颜色或W3标准中指定的其他选项之一。
<InputTextArea @bind-Value=FormData.SomeMultiLineStringProperty />
InputSelect
InputSelect
组件将任何类型的属性绑定到HTML<select>
元素。Blazor将根据属性的值自动选择正确的<option>
。
<InputSelect @bind-Value=FormData.SomeSelectProperty>
<option value="Pending">Pending</option>
<option value="Active">Active</option>
<option value="Suspended">Suspended</option>
</InputSelect>
由于razor视图将FormData.SomeSelectProperty
默认为SomeStateEnum.Active
,因此<select>
HTML元素将其选择默认为该值,即使它不是第一个指定的<option>
。