1.环境
VS2019 16.5.1
.NET Core SDK 3.1.200
Blazor WebAssembly Templates 3.2.0-preview2.20160.5
2.默认绑定
2.1.使用方法
Blazor中Razor组件通过一个名为@bind的HTML元素属性提供数据绑定功能,数据绑定的对象可以为字段、属性或表达式值。例如:
<input @bind="_bindValue1" />
@code{
private int _bindValue1 { get; set; } = 1;
}
@bind默认绑定的是元素的onchange事件,通过在组件中添加一个元素p可以看出效果,每当input离开focus或者回车时,p中的值才会更新:
<p>@_bindValue1</p>
2.2.等价单向绑定
由于@bind绑定的数据是强类型,在从input的value到绑定的数据时,会做相关的数据转换,如果转换失败,则会保持上次的值不变。也就是说,默认绑定类似于以下代码:
<input value="@_bindValue1" @οnchange="(e) => { _bindValue1 = int.TryParse(e.Value.ToString(), out var val) ? val : _bindValue1;}" />
之所以说是类似,是因为当无法转换时,例如输入的是小数123.1,当触发onchange事件时,通过@bind绑定数据时,input中value会变回上一次的整数;而这种单向绑定时,input的value显示的依然为123.1,不过通过C#获取_bindValue1的值时,得到的与通过@bind绑定数据时的行为是一致的。在单向绑定时,即使使用StateHasChanged(),由于渲染c#教程引擎未发现状态的变化,依然是不会改变显示的值。
3.字符串格化
@bind可以使用@bind:format指定字符串的格式化表达式,个人觉得此功能有些鸡肋,其支持的格式表达式较为有限,而且还具有一些其他的问题,不知道是bug还是本身就这样设计的,我目前python基础教程已经在AspNetApiDocs提交了相关的反馈。
4.修改默认绑定事件
在有些时候,我们可能需要实时响应input中的输入内容,例如搜索提示,这个时候需要相应input的oninput事件,@bind通过指定event参数来在指定绑定属性或字段响应的事件,其形式为@bind:event=“eventName”,例如:
<input @bind="_bindValue2" @bind:event="oninput" />
5.组件间的事件绑定
5.1.父组件到子组件
通过使用@bind-{PROPERTY}的形式,可以将属性值从父组件向下绑定到子组件,其中PROPERTY必须为组件参数,例如在子组件中添加一个DateTime参数,要想使用@bind为此子组件在父组件中绑定数据,按照约定还必须定义一个名为事件{PROPERTY}Changed的事件,这个事件用于响应当子组件中更改组件参数时,子组件对数据的回调。代码如下:
<input @bind="DateTime" @bind:format="yyyy-MM-dd HH:mm:ss" />
<p>@DateTime.ToString("o")</p>
[Parameter]
public DateTime DateTime { get; set; } = DateTime.Now;
[Parameter]
public EventCallback<DateTime> DateTimeChanged { get; set; }
这样就可以在父组件中使用如下代码进行数据绑定了:
<Component @bind-DateTime="_dateTime" />
这行代码实际上等价于以下代码:
<Component @bind-DateTime="_dateTime" @bind- DateTime:event=" DateTime Changed"/>
因此我们可以自定义上述约定中的默认事件{PROPERTY}Changed的名称,现在效果如下(请注意,此时如果子组件更新的参数,数据是无法流向父组件的):
5.2.子组件到父组件
通常,参数流是从上往下的,即从父组件流到子组件,这是与渲染流程是保持一致的。因此当父组件更新子组件的组件参数时,往往子组件会很容易的进行渲染,但是当子组件向父组件传递数据,则必须使用相应的回调事件。这种限制是组件设计必然结果。@bind在组件间进行数据的双向绑定正式通过在5.1.中的所介绍的{PROPERTY}Changed事件来向父组件进行数据的传递的。
首先,在之前组件间事件绑定的代码上为input的oninput事件添加响应函数ChangeParentValue:
private async Task ChangeParentValue(ChangeEventArgs e)
{
var dateStr = e.Value.ToString();
await DateTimeChanged.InvokeAsync(DateTime.Parse(dateStr));
}
注意,在这里代码并没有直接更改本组件中的组件参数DateTime,因为父组件中更改了状态后,会将该数据传递到子组件,子组件会重新渲染。按照微软官方的代码,这个是可以更改本组件中的组件参数DateTime的。现在,效果如下:
代码下载
https://github.com/zxyao145/LearningBlazor/tree/master/BlazorBind