0

0

Blazor 创建自定义组件的方法

星降

星降

发布时间:2026-01-13 09:50:02

|

769人浏览过

|

来源于php中文网

原创

Blazor自定义组件通过创建.razor文件实现,包含HTML模板、C#逻辑(@code块)和scoped CSS;使用[Parameter]接收参数,EventCallback触发事件,无需注册即可直接使用。

blazor 创建自定义组件的方法

Blazor 中创建自定义组件非常直接,核心就是写一个 .razor 文件,里面包含 HTML 模板、C# 逻辑和可选的 CSS 样式(支持 scoped CSS)。组件本质是可复用的 UI 单元,能接收参数、触发事件、封装状态。

基础组件:从 .razor 文件开始

Shared 或任意文件夹下新建文件(如 MyButton.razor),内容如下:

  • 使用 @code { } 块写 C# 成员(字段、属性、方法)
  • 直接写 HTML 标记作为渲染模板,支持 Razor 语法(如 @onclick@if
  • 组件名默认取文件名(首字母大写),无需注册,Blazor 编译器自动识别

接收参数:用 [Parameter] 特性

让组件可配置的关键。在 @code 块中声明 public 属性,并加上 [Parameter]

  • 支持普通类型(string、int)、泛型(TValue)、组件类型(RenderFragment)
  • 必需参数可用 [Parameter] public string Label { get; set; } = default!; + 非空约束
  • 子内容用 [Parameter] public RenderFragment? ChildContent { get; set; } 接收

触发交互:定义 EventCallback

组件内部调用 EventCallback.InvokeAsync() 向父组件发通知:

Zoomify–jQuery缩放效果lightbox插件
Zoomify–jQuery缩放效果lightbox插件

Zoomify 是一款基于的简单带缩放效果的 jQuery lightbox 插件,它使用简单,出来提供基本的属性外,还提供了自动事件和自定义方法,能够满足大多数需求。

下载
  • 声明:[Parameter] public EventCallback OnClick { get; set; }
  • 在按钮点击等时机调用:await OnClick.InvokeAsync();
  • 支持带参回调,如 EventCallback OnInput,调用时传值即可

样式与作用域:使用 @namespace 和 scoped CSS

避免样式污染,推荐启用 scoped CSS:

  • 新建 MyButton.razor.css(同名 + .css 后缀),内容自动作用于该组件
  • 在组件顶部加 @namespace MyApp.Components 明确命名空间,方便跨页面引用
  • 如需全局样式,仍可用 wwwroot/css/site.css 或 块(不推荐)

基本上就这些。不需要手动注册,不依赖第三方库,改完保存就能在其他 .razor 文件里像 HTML 标签一样用 —— 比如

相关专题

更多
css
css

css是层叠样式表,用来表现HTML或XML等文件样式的计算机语言,不仅可以静态地修饰网页,还可以配合各种脚本语言动态地对网页各元素进行格式化。php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

509

2023.06.15

css居中
css居中

css居中:1、通过“margin: 0 auto; text-align: center”实现水平居中;2、通过“display:flex”实现水平居中;3、通过“display:table-cell”和“margin-left”实现居中。本专题为大家提供css居中的相关的文章、下载、课程内容,供大家免费下载体验。

262

2023.07.27

css如何插入图片
css如何插入图片

cssCSS是层叠样式表(Cascading Style Sheets)的缩写。它是一种用于描述网页或应用程序外观和样式的标记语言。CSS可以控制网页的字体、颜色、布局、大小、背景、边框等方面,使得网页的外观更加美观和易于阅读。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

752

2023.07.28

css超出显示...
css超出显示...

在CSS中,当文本内容超出容器的宽度或高度时,可以使用省略号来表示被隐藏的文本内容。本专题为大家提供css超出显示...的相关文章,相关教程,供大家免费体验。

537

2023.08.01

css字体颜色
css字体颜色

CSS中,字体颜色可以通过属性color来设置,用于控制文本的前景色,字体颜色在网页设计中起到很重要的作用,具有以下表现作用:1、提升可读性;2、强调重点信息;3、营造氛围和美感;4、用于呈现品牌标识或与品牌形象相符的风格。

757

2023.08.10

什么是css
什么是css

CSS是层叠样式表(Cascading Style Sheets)的缩写,是一种用于描述网页(或其他基于 XML 的文档)样式与布局的标记语言,CSS的作用和意义如下:1、分离样式和内容;2、页面加载速度优化;3、实现响应式设计;4、确保整个网站的风格和样式保持统一。

603

2023.08.10

css三角形怎么写
css三角形怎么写

CSS可以通过多种方式实现三角形形状,本专题为大家提供css三角形怎么写的相关教程,大家可以免费体验。

559

2023.08.21

css设置文字颜色
css设置文字颜色

CSS(层叠样式表)可以用于设置文字颜色,这样做有以下好处和优势:1、增加网页的可视化效果;2、突出显示某些重要的信息或关键字;3、增强品牌识别度;4、提高网页的可访问性;5、引起不同的情感共鸣。

389

2023.08.22

PHP 表单处理与文件上传安全实战
PHP 表单处理与文件上传安全实战

本专题聚焦 PHP 在表单处理与文件上传场景中的实战与安全问题,系统讲解表单数据获取与校验、XSS 与 CSRF 防护、文件类型与大小限制、上传目录安全配置、恶意文件识别以及常见安全漏洞的防范策略。通过贴近真实业务的案例,帮助学习者掌握 安全、规范地处理用户输入与文件上传的完整开发流程。

1

2026.01.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 0.8万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 2.9万人学习

CSS教程
CSS教程

共754课时 | 18.6万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号