SuperAPI AI 工具集

umbraco-property-editor-ui

通用与其它

查看项目

更新于 10-15 21:05

技能介绍

用途:在 Umbraco 后台实现属性编辑器 UI(Property Editor UI),即用户输入和管理内容数据的可视化组件。它属于属性编辑器的客户端部分(TypeScript),需与定义数据存储的服务器端 Schema(C#)配对使用。

主要能力:创建 manifest(umbraco-package.json)声明 propertyEditorUi 扩展;用 Lit 与 UmbElementMixin 实现元素,通过 value 属性与 UmbChangeEvent 同步值;支持通过 UmbPropertyEditorConfigCollection 读取配置(如 maxChars、placeholder),并在 manifest 的 settings 中定义配置项与默认值。

使用方式:实现前先用 WebFetch 获取官方最新文档(主文档、教程、配置、Foundation、Extension Registry 等 URL)。工作流为:获取文档、确认数据类型与 UI 组件及配置需求、生成 manifest 与元素文件、说明创建内容与测试方式。可参考 Umbraco 源码示例 /Umbraco-CMS/src/Umbraco.Web.UI.Client/examples/property-editor/。相关基础技能包括 umbraco-umbraco-element、umbraco-state-management、umbraco-localization。

限制与注意:manifest 中的 propertyEditorSchemaAlias 必须指向服务器端存在的 schema;使用内置 schema(如 Umbraco.Plain.String、Umbraco.Integer、Umbraco.Decimal、Umbraco.Plain.Json、Umbraco.DateTime、Umbraco.TrueFalse、Umbraco.TextBox、Umbraco.TextArea)较安全;若用自定义别名(如 MyPackage.CustomSchema),必须提供对应的 C# DataEditor,否则创建 Data Type 时会 404。Umbraco.Plain.Json 可能出现值不持久化问题。常见问题见 TROUBLESHOOTING.md,UUI 组件问题见 UUI-GOTCHAS.md。具体收费、价格与平台信息暂未提供。