再学Blazor——组件

Blazor 应用基于组件,组件可以复用和嵌套。本文内容如下:

  • 组件类
  • 组件嵌套
  • 组件参数
  • 组件对象

1. 组件类

所有组件都是继承 ComponentBase 组件基类,razor 文件默认继承 ComponentBase 类。 ComponentBase 实现组件的最低抽象,IComponent 接口。 ComponentBase 定义基本功能的组件属性和方法,例如,处理一组内置组件生命周期事件。

html 复制代码
//HTML 写法
MyComponent.razor

<div>Hello Known!</div>
csharp 复制代码
//C# 写法
class MyComponent : ComponentBase
{
    protected override void BuildRenderTree(RenderTreeBuilder builder)
    {
        builder.Div("Hello Known!");
    }
}

2. 组件嵌套

组件可以包含其他组件。用 HTML 语法,组件的标记类似于 HTML 标记,其中标记的名称是组件类型。

html 复制代码
//HTML 写法
MyApp.razor

<MyComponent />

C# 高级写法是通过扩展方法来实现的。

csharp 复制代码
//C# 写法
class MyApp : ComponentBase
{
    protected override void BuildRenderTree(RenderTreeBuilder builder)
    {
        builder.Component<MyComponent>().Build();
    }
}

3. 组件参数

Blazor 应用是由若干组件拼搭而成,有些组件结构相同,数据不同,这样的组件就需要添加组件参数属性将数据传递给组件。组件参数需满足如下条件:

  • 需要包含 [Parameter] 特性
  • 必须是 public 的属性
csharp 复制代码
class MyComponent : ComponentBase
{
    [Parameter] public string? Title { get; set; }
    //子内容呈现片段
    [Parameter] public RenderFragment? ChildContent { get; set; }

    protected override void BuildRenderTree(RenderTreeBuilder builder) { ... }
}

下面是组件参数的使用示例

html 复制代码
//HTML 写法
MyApp.razor

<div>
    <MyComponent Title="组件1" />
    <MyComponent Title="组件2">
        子内容呈现
    </MyComponent>
</div>
csharp 复制代码
//C# 写法
class MyApp : ComponentBase
{
    protected override void BuildRenderTree(RenderTreeBuilder builder)
    {
        builder.Div(attr =>
        {
            builder.Component<MyComponent>().Set(c => c.Title, "组件1").Build();
            builder.Component<MyComponent>()
                   .Set(c => c.Title, "组件2")
                   .Set(c => c.ChildContent, b => b.Text("子内容呈现"))
                   .Build();
        });
    }
}

4. 组件对象

组件是继承 ComponentBase 的一个类,如果要访问组件的方法,必须获取组件的对象实例。若要捕获组件对象实例,请执行以下操作:

  • 向子组件添加 @ref 特性
  • 定义与子组件类型相同的字段
html 复制代码
//HTML 写法
MyApp.razor

<div>
    <MyComponent @ref="component" Title="组件1" />
</div>

@code {
    private MyComponent? component;
}

C# 高级写法是在组件建造者 ComponentBuilder 类的 Build 方法中通过 AddComponentReferenceCapture 方法来捕获组件对象实例,该类不是 Blazor 框架类,后续将介绍该类的具体实现。

csharp 复制代码
//C# 写法
class MyApp : ComponentBase
{
    private MyComponent? component;

    protected override void BuildRenderTree(RenderTreeBuilder builder)
    {
        builder.Div(attr =>
        {
            builder.Component<MyComponent>()
                   .Set(c => c.Title, "组件1")
                   .Build(value => component = value);
        });
    }
}
相关推荐
Y42583 小时前
本地多语言切换具体操作代码
前端·javascript·vue.js
速易达网络6 小时前
Bootstrap 5 响应式网站首页模板
前端·bootstrap·html
etsuyou6 小时前
js前端this指向规则
开发语言·前端·javascript
lichong9516 小时前
Android studio 修改包名
android·java·前端·ide·android studio·大前端·大前端++
cai_huaer6 小时前
BugKu Web渗透之 cookiesWEB
前端·web安全
lichong9516 小时前
Git 检出到HEAD 再修改提交commit 会消失解决方案
java·前端·git·python·github·大前端·大前端++
友友马7 小时前
『 QT 』QT控件属性全解析 (一)
开发语言·前端·qt
不想上班只想要钱7 小时前
vue3+vite创建的项目,运行后没有 Network地址
前端·javascript·vue.js
流***陌8 小时前
手办盲盒抽赏小程序前端功能设计:兼顾收藏需求与抽赏乐趣
前端·小程序
岁月宁静8 小时前
在富文本编辑器中封装实用的 AI 写作助手功能
前端·vue.js·人工智能