用途:为 Umbraco 后台的 Block List、Block Grid、Block RTE 编辑器中的区块提供自定义可视化表示,替代默认区块渲染,适合主题化预览、领域特定可视化或增强编辑体验。
主要能力:通过 manifest 注册 blockEditorCustomView 扩展,指定 element 与 forContentTypeAlias、forBlockEditor;自定义视图元素实现 UmbBlockEditorCustomViewElement 接口,接收 content 与 settings 两个 UmbBlockDataType 属性,可读取区块内容与设置数据(如背景色、内边距)进行渲染。支持为多个内容类型或某编辑器下全部区块应用视图。
使用方式:先获取官方文档(block-custom-view、block-editor、foundation 页面),确认区块类型与编辑器类型;再创建 manifest(umbraco-package.json 或 TypeScript 的 ManifestBlockEditorCustomView)与视图元素文件;元素基于 UmbLitElement 与 lit 实现 render 与 styles。官方源码示例位于 /Umbraco-CMS/src/Umbraco.Web.UI.Client/examples/block-custom-view/。
适用场景:需要为特定区块提供定制预览、按设置动态展示样式、统一多内容类型区块外观时。
限制:资料未提供安装命令、收费、价格、平台与效果信息;实现前应始终获取最新官方文档,示例仅作最小参考。