用途:在 Umbraco 后台为特定文件类型提供上传时的预览渲染。预览以自定义 Web Component 形式注册,按 MIME 类型匹配,可显示图片缩略图、音频波形或特定格式的图标。
主要能力:通过清单注册 type 为 fileUploadPreview 的扩展,指定 alias、name、weight、element 与 forMimeTypes;元素实现 UmbFileUploadPreviewElement 接口,接收 file?: File,可基于文件内容渲染预览。forMimeTypes 支持单个字符串或数组,可用通配符如 image/、video/、audio/、application/pdf、/*(建议较低 weight 作为兜底)。
使用方式:先按官方文档获取最新资料(Foundation、Extension Registry、Umbraco Element 等页面),再创建 manifest 与 element 两个文件。element 通常继承 UmbLitElement,使用 @umbraco-cms/backoffice/external/lit 与 /backoffice/media 的类型;在 updated 中根据 file 生成预览 URL,在 disconnectedCallback 中调用 URL.revokeObjectURL 释放。示例中的文件需自行创建,命令与代码以官方文档为准。
适用场景:需要为上传的文件提供可视化预览、按 MIME 类型区分展示效果的 Umbraco 后台扩展开发。
限制:资料未提供收费、价格、平台版本要求与具体安装命令;实现前应始终拉取最新官方文档,示例保持最小化。