原文鏈接:https://www.cnblogs.com/ysmc/p/16082279.html
顧名思義,這個組件的作用我就不再多說了,配合 AutoGenerateColumnAttribute 特性食用更佳,BootstrapBlazor 智能生成神器(一)AutoGenerateColumnAttribute 特性介紹 - 一事冇誠 - 博客園 (cnblogs.com)
組件說明:
ValidateForm
組件支持異步設置Model
值- 表單事件為
OnValidSubmit
OnInvalidSubmit
Model
參數為必填項不允許為空- 表單內可以放置多個按鈕,通過設置
ButtonType='ButtonType.Submit'
參數是否提交表單 - 客戶端驗證機制支持模型的
Required
標簽,通過設置ErrorMessage
參數設置提示信息,未設置時使用默認的英文提示信息 - 表單默認檢查表單內綁定字段值是否合法,如需要檢查模型所有字段時可設置
ValidateAllProperties
屬性值為true
- 通過設置提交按鈕
Button
屬性IsAsync
值,設置異步提交表單 - 表單內組件控件的值修改后
OnFieldChanged
方法被調用
注意事項:
- 表單內組件通常用法都是使用雙向綁定技術對
Model
的屬性值進行雙向綁定,當其值改變時會導致所在組件StateHasChanged
方法被調用,即其所在組件或者頁面進行刷新重新渲染 - 組件前置標簽默認寬度為
120px
六個漢字,如需要更多漢字請在項目樣式文件中更改樣式變量--bs-row-label-width
即可,或者設置表單顯示標簽在組件上方
Attributes 屬性
參數
|
說明
|
類型
|
可選值
|
默認值
|
---|---|---|---|---|
Model
|
表單組件綁定的數據模型,必填屬性
|
object
|
—
|
—
|
ValidateAllProperties
|
是否檢查所有字段
|
bool
|
true/false
|
false
|
ShowRequiredMark
|
表單內必填項是否顯示 * 標記
|
bool
|
true/false
|
true
|
ShowLabelTooltip
|
鼠標懸停標簽時顯示完整信息
|
bool?
|
true/false/null
|
null
|
ChildContent
|
子組件模板實例
|
RenderFragment
|
—
|
—
|
OnValidSubmit
|
表單提交時數據合規檢查通過時的回調委托
|
EventCallback<EditContext>
|
—
|
—
|
OnInvalidSubmit
|
表單提交時數據合規檢查未通過時的回調委托
|
EventCallback<EditContext>
|
—
|
—
|
Methods 方法
參數
|
說明
|
參數
|
返回值
|
---|---|---|---|
SetError
|
設置驗證失敗方法
|
PropertyName, ErrorMessage
|
—
|