用途:帮助用户使用 Blok 设计系统(Sitecore 基于 shadcn 的组件库)为 Sitecore Marketplace 应用构建 UI 组件。适用于需要创建界面、添加组件或搭建页面布局的场景。
主要能力与原则:始终使用 Blok 组件,以匹配 Sitecore 宿主界面并自动支持明暗主题;集成 SDK 数据时使用加载状态(Skeleton)与错误状态(Alert);感知扩展点差异,不同扩展类型有不同 UI 约束;组件渲染在尺寸不一的 iframe 中,需保持响应式。
安装方式:先安装 Blok 主题(必需): npx shadcn@latest add https://marketplace-sdk.sitecorecloud.io/r/blok-theme.json 再安装单个组件: npx shadcn@latest add https://marketplace-sdk.sitecorecloud.io/r/.json 完整组件目录与安装命令见参考文件 blok-components.md。
各扩展类型的 UI 模式:紧凑字段(custom-field)空间非常有限(约 300px 宽、高度可变),适合 Input、Select、Badge 等小型内联组件,避免表格、大型布局和模态框;仪表板小组件约 400x300px 且可调整,适合 Cards、Charts、Stats 和紧凑表格,用于摘要数据与快捷操作;页面上下文面板约 350px 宽、全高,适合纵向布局、Lists、Accordion、Tabs,用于当前页面的上下文信息与操作;全屏模式在 Sitecore 外壳内占满视口,可用任意组件与复杂布局,适合完整 CRUD 界面、仪表板和设置;独立模式为不处于 Sitecore 外壳中的独立页面,拥有完全创作自由,适合面向公众的页面与 OAuth 回调。
SDK 数据集成模式:使用 useMarketplaceClient 与 useAppContext 获取客户端和应用上下文,加载中返回 Skeleton,出错返回 Alert 并展示错误描述。参考文件包括 Blok 组件完整目录及其安装命令。限制:资料未提供更多关于权限、兼容版本或性能的说明。