讲师中心 微信公众号
AI工具推荐 视频效率加速

Blazor 怎么动态渲染组件

阿敏君_5971

阿敏君_5971

发布时间:2025-12-21 08:23:12

|

510人浏览过

|

来源于php中文网

原创

Blazor动态渲染组件主要用DynamicComponent和RenderFragment:前者按类型切换组件,后者按内容注入UI;配合@key可提升动态列表稳定性,并需注意组件生命周期与状态管理。

blazor 怎么动态渲染组件

Blazor 动态渲染组件主要靠 DynamicComponent 和 RenderFragment 两种机制,分别适用于“按类型切换组件”和“按内容注入 UI”两类场景。用对方法能避免硬编码条件判断、提升可维护性,也方便做插件化或配置驱动的界面。

用 DynamicComponent 按需加载组件

当你需要根据运行时数据(比如用户选择、API 返回类型名)决定显示哪个组件时,DynamicComponent 是最直接的方式。

  • 它接受两个必需参数:Type(组件类型,必须是继承自 ComponentBase 的类)和 Parameters(键值对字典,用于传参)
  • 组件类型不能是字符串,得是编译期已知的 Type 对象,通常从 typeof(MyComponent) 或反射中获取
  • 参数字典中的 key 必须严格匹配目标组件的 [Parameter] 属性名,且类型兼容

示例:

<DynamicComponent Type="@selectedComponentType" Parameters="@componentParams" />
@code {
    private Type selectedComponentType = typeof(Counter);
    private Dictionary<string, object> componentParams = new() {
        { "InitialCount", 100 }
    };

    private void SwitchToWeather() {
        selectedComponentType = typeof(WeatherForecastList);
        componentParams = new() { { "City", "Beijing" } };
    }
}

用 RenderFragment 注入任意 UI 片段

如果你不关心“是什么组件”,只关心“要渲染什么内容”,RenderFragment 更灵活。它本质是一个委托,接收 RenderTreeBuilder 并生成 DOM 结构,常用于模板化组件(如卡片、模态框、表格单元格)。

  • 父组件通过 @ChildContent 或命名参数(如 HeaderContent)接收子内容
  • 子内容可以包含 HTML、绑定表达式、事件处理器,甚至嵌套其他组件
  • 适合封装布局容器,把结构逻辑留在父组件,展示逻辑交给使用者

示例(父组件定义):

<div class="card">
  <div class="card-header">@Title</div>
  <div class="card-body">@ChildContent</div>
</div>
@code {
    [Parameter] public string Title { get; set; } = "默认标题";
    [Parameter] public RenderFragment? ChildContent { get; set; }
}

调用处写法:

Html2md
Html2md

使用 Readability + Turndown 将 HTML 页面转换为干净的、Agent 友好的 Markdown。去除导航栏、广告、页脚、Cookie 横幅、社交按钮等干扰元素。支持 URL...

下载
<Card Title="用户信息">
  <ChildContent>
    <p>姓名:@user.Name</p>
    <button @onclick="EditUser">编辑</button>
  </ChildContent>
</Card>

配合 @key 提升动态列表稳定性

当动态渲染的是集合(比如一组不同类型的卡片),又用 foreach + DynamicComponent,记得加 @key。否则 Blazor 默认按索引追踪,插入/删除会导致状态错乱(如输入框失焦、动画中断)。

  • @key 值必须在当前循环内唯一,推荐用数据项的 ID 或完整对象(若重写了 Equals 和 GetHashCode)
  • 不要用随机数或临时变量,否则每次渲染都变,等于强制重绘

正确写法:

@foreach (var item in items)
{
    <DynamicComponent @key="item.Id" Type="@GetTypeForItem(item)" Parameters="@GetParams(item)" />
}

注意组件生命周期与状态管理

动态组件每次类型变化都会被销毁重建,原有状态(如内部字段、未提交表单)不会保留。

  • 如需跨切换保持状态,把关键数据提到父组件或服务中管理
  • 避免在 OnInitialized 中做一次性初始化逻辑(比如订阅事件),因为组件可能反复创建;改用 OnParametersSet 或手动控制
  • 如果组件有异步加载逻辑(如 OnInitializedAsync),确保异常有兜底,防止白屏

基本上就这些。核心是分清“换组件”还是“换内容”——前者用 DynamicComponent,后者用 RenderFragment,再辅以 @key 和状态设计,就能稳稳撑起复杂动态 UI。

热门AI工具

更多
超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
php中foreach用法
php中foreach用法

本专题整合了php中foreach用法的相关介绍,阅读专题下面的文章了解更多详细教程。

798

2025.12.04

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1798

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2824

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6164

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

5909

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

7534

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

11194

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

5759

2025.07.29

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 228人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn