组件除了要解决视图层展示、视图层与逻辑层的数据绑定,还需要解决一个重大问题,就是在组件树中实现数据传递,包括了父到子、子到父、祖到孙,以及任意组织之间。而我们上一章讲到的实现双向绑定的两个指令,Vue的v-model,Blazor的@bind,可以认为是父到子和子到父,两个方向同时实现的语法糖,后面章节我们再来实现它。
我们先从最简单的父子传值开始学习。在Vue和Blazor中,都是通过属性来实现父子组件的数据传递。我们以往都是在html标签上设置属性,属性值可以是字面量,也可以绑定逻辑数据。比如这样<a :href="href">连接</a>。我们现在把a标签换成一个自定义的组件,<Link :href="href">链接</Link>,Link组件会如何对待这个绑定的href值呢?【例子中,大家不要忽略一个事实,无论是a标签也好,还是组件Link也罢,它们都是在另外一个组件中使用的,这个组件我们称为父组件,而a标签或Link组件,称为子组件】
1、父子传值的基本使用
Vue在子组件中,通过defineProps(宏命令,不需要import)来定义属性,Blazor在子组件中,通过[Parameter]特性,来标注属性。Vue不断的创造新的API,不看源码,你不会知道这个defineProps是怎么工作的,而Blazor无招胜有招,使用的时候,你就能大概明白是怎么一回事!
//Vue===================================== //1、子组件Post //定义两个属性用于接收数据 <script setup> const props = defineProps(['title','content']) //在代码中,通过props.title来使用属性值 </script> //在模板中使用接收到的两个属性值 <template> <h1>{{title}}</h1> <h3>{{content}}</h3> </template> //2、父组件传递数据 //引入子组件Post <script setup> import {ref} from 'vue' import Post from './components/Post.vue' const content = ref('美国又来搅局!') </script> //使用子组件,title属性绑定字面量,content属性绑定逻辑变量 <template> <Post title="俄乌局事有重大变化" :content="content"></Post> </template> //3、父组件传递数据-循环渲染 <script setup> import {ref} from 'vue' import Post from './components/Post.vue' const posts = ref([ {title:'标题1',content:'内容1'}, {title:'标题2',content:'内容2'}, ]) </script> <template> <Post v-for="post in posts" :title="post.title" :content="post.content"></Post> </template>
//Blazor=================================== //1、子组件Post //在模板中使用接收到的两个属性值 <h1>@Title</h1> <h3>@Content</h3> //定义两个属性用于接收数据 @code { [Parameter] public string Title { get; set; } [Parameter] public string Content { get; set; } } //2、父组件传递数据 //使用子组件,title属性绑定字面量,content属性绑定逻辑变量 <Post Title="俄乌局事有重大变化" Content="@content"></Post> @code { private string content = "美国又来搅局"; } //3、父组件循环渲染传递数据 @foreach (var post in posts) { <Post Title="@post.Title" Content="@post.Content"></Post> } @code { private List<PostModel> posts = new List<PostModel> { new PostModel{Title="标题1",Content="内容1"}, new PostModel{Title="标题2",Content="内容2"} }; }
2、传递属性值的类型
对于HTML标签的属性,我们只能传递指定的类型,一般是数值、字符串、布尔等简单类型,但对于自定义组件,我们可以传递任意类型,Vue和Blazor在这方面都没有限制。
【有个注意点需要特别小心】:
Vue:当传递数组、对象等引用类型时,仅仅传递了引用地址。所以,在子组件中直接修改传递过来的属性值,父组件的值也会被改变。在Vue中,如果需要修改传递过来的属性值,建议将属性值赋值给一个新变量,再对新变量进行加工处理。
Blazor:不存在Vue的问题,即使传递引用类型,也是传递一个新值给子组件,属性值在父子组件中相互独立。
//Vue===================================== //子组件,接收对象和数组 <script setup> const props = defineProps(['value1','value2']) </script> <template> <h1>{{value1.name}}-{{value1.age}}</h1> <h3 v-for="item in value2">{{item.name}}-{{item.age}}</h3> </template> //父组件,传递对象和数组类型数据 <script setup> import {ref} from 'vue' import Post from './components/Post.vue' const value1 = ref({name:'Fun',age:18}) const value2 = ref([ {name:'Fun',age:18}, {name:'MC',age:19}, ]) </script> <template> <Post :value1="value1" :value2="value2"></Post> </template>
//Blazor //子组件,定义了一个PostModel类属性,以及这个类的集合属性 <h1>@($"{PostModel.Title}-{PostModel.Content}")</h1> @foreach (var item in PostModels) { <h3>@($"{item.Title}-{item.Content}")</h3> } @code { [Parameter] public PostModel PostModel { get; set; } [Parameter] public List<PostModel> PostModels { get; set; } } //父组件创建了一个PostModel实例,以及PostModel的集合实例 <Post PostModel="@postModel" PostModels="@postModels"></Post> @code { private PostModel postModel = new PostModel { Title = "标题1", Content = "内容1" }; private List<PostModel> postModels = new List<PostModel> { new PostModel{Title="标题2",Content="内容2"}, new PostModel{Title="标题3",Content="内容3"} }; }
3、传递属性值的校验
Blazor是天生强类型,属性值的校验非常简单。而Vue中的属性值校验也麻烦些,如果不使用TS,只能支持运行时校验,使用TS,结果volar,可以支持编译时校验。
//Vue===================================== //运行时校验 const props = defineProps({ // 基础类型检查 propA: Number, // 多种可能的类型 propB: [String, Number], // 必传,且为 String 类型 propC: { type: String, required: true }, // Number 类型的默认值 propD: { type: Number, default: 100 }, // 对象类型的默认值 propE: { type: Object, default() { return { message: 'hello' } } } } //借助TS和volar实现编译时检验 //泛型约束 const props = defineProps<{ foo: string bar?: number }>() //使用接口 interface Props { foo: string bar?: number } const props = defineProps<Props>() //默认值的话,比较麻烦,使用withDefault再包一层 const props = withDefault(defineProps<{ foo: string bar?: number }>(),{ foo:'hello', bar:10, })
//Blazor==================================== //类型、是否必填、默认值,一行搞定,而且都是c#本身的语法,不用借助API,就问你爽不爽!? @code { [Parameter] public PostModel? PostModel { get; set; } = new PostModel { Title = "默认标题", Content = "默认内容" }; [Parameter] public List<PostModel> PostModels { get; set; } }