用途:介绍并指导实现 Umbraco 后台(backoffice)的路由,实现区块、仪表盘、工作区与自定义元素之间基于路径名的导航。
主要能力:区块(section)作为主要组织分隔与入口;仪表盘、区块视图和自定义元素提供入口。可用 umb-router-slot 与路由定义构建自定义路由,支持参数(如 person/:personId、edit/:id)与重定向(redirectTo)。路由按顺序匹配,先匹配者生效。URL 结构示例:区块 /section/my-section;仪表盘 /section/content/dashboard/welcome-dashboard;区块视图 /section/my-section/organization;自定义 /section/my-section/people/person/123。
使用方式:实现前先获取最新文档(主文档、区块、仪表盘、基础部分)。参考 Umbraco 源码示例 /Umbraco-CMS/src/Umbraco.Web.UI.Client/examples/modal-routed/ 学习路由化模态框与深链接。流程为:获取文档、确认需求(自定义路由、区块导航、参数)、生成代码、说明导航方式。区块、仪表盘、区块视图通过 JSON 清单配置 type、alias、name、meta.pathname,并可加 Umb.Condition.SectionAlias 条件。自定义路由在基于 UmbLitElement 的元素中声明 UmbRoute 数组,每项含 path、component、setup;setup 可读取 info.match.params 并传值给组件,component 通常用动态 import 加载。示例文件可参考源码中的 modal-routed。
适用场景:需要为 Umbraco 后台扩展自定义导航、带参数的详情页、嵌套路由布局、入口视图或路由化模态框时。
限制:资料未提供版本要求、兼容性、安装命令、性能与安全注意事项;实现始终以官方最新文档为准。