SuperAPI AI 工具集

salla-embedded-ui

通用与其它

查看项目

更新于 10-16 01:26

技能介绍

用途:为 Salla 应用的嵌入式(仪表盘)UI 提供原生外观与体验规范,即基于 Embedded SDK 设计系统渲染的商家仪表盘 iframe。该技能只负责原生样式,其规则为强制要求而非参考;不符合规范的应用可能在管理员审核时被拒绝。店铺前台 UI 属于另一设计系统,应使用 salla-storefront-ui;SDK 启动、页面注册与鉴权属于 salla-embedded-app。

主要能力与要求:

  1. 先加载权威设计规范 ../salla-embedded-app/references/design-guidelines.md,使用其中确切的品牌色令牌(明暗两套)、PingARLT 字体、4px 间距网格、Hugeicons 及组件模式,不得自行编造令牌值。
  2. 从 embedded.init() 的 layout 读取 theme/locale/dir,在 <html> 上设置 dir、lang、data-theme,并在 embedded.onThemeChange 及重新初始化时重新应用。
  3. 遵循 No-Chrome 规则:标题用 embedded.page.setTitle(),主操作用 embedded.nav.setAction(),反馈用 embedded.ui.toast / embedded.ui.confirm() / embedded.ui.loading.show() 与 .hide(),面包屑用 embedded.ui.breadcrumbs.hide()/show();不得自建侧边栏、顶部导航、面包屑、确认框或 toast,也不得直接使用 postMessage。
  4. 颜色、字体、间距、图标与组件形状须与仪表盘一致,明暗两种主题均可读,所有可见文案同时提供 ar 与 en。
  5. RTL 为默认场景,使用 CSS 逻辑属性(margin-inline-start、padding-inline、border-inline-start),避免 left/right 与全局 text-align: left。
  6. 完成后须在已安装的演示店铺中实机验证:使用 salla_apps action=demo_stores 打开 install_url 与 dashboard_url,截图嵌入式页面,并按 references/compliance-report-template.md 输出合规报告。

限制:鉴权与会话验证不在本技能范围,分别属于 salla-embedded-app 与 salla-app-auth;仅代码运行不等于外观正确,必须提供实机截图证明。具体安装命令与更多细节资料中暂未提供。