PuppyIP 资源中心
跨境电商开发 4 分钟 发布于 2026-10-15

Shopify Sidekick 挡住应用底部?先查固定栏与安全区

Shopify 员工在 2026 年 10 月 14 日的开发者公告中说明:Sidekick 现在位于每个后台页面的底部中央,也会出现在嵌入式应用中,而且没有用于隐藏或禁用它的 API。应用开发者需要区分主文档的自动留白与固定控件等界面的处理责任,避免关键内容被遮挡。

Shopify Sidekick App Bridge 嵌入式应用

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • App Bridge 会为应用主文档底部添加安全区内边距;这不代表所有自定义界面都已自动适配。
  • 固定或粘性控件、自定义滚动容器和 s-app-window 内容需要自行应用安全区留白。未加载 App Bridge CDN 脚本的旧版模态框也可能被遮挡。
  • 公告建议使用 App Bridge toasts,让提示消息显示在框架顶部,避开底部的 Sidekick。
  • 公告同时提出 Sidekick App Extensions 接入方向;未使用 Shopify Managed Install 时如何接入的问题,当前讨论尚无工作人员答复。

先确认变化:后台底部多了需要避让的界面

公告将这次变化与 Shopify 后台近期的视觉更新联系起来:Sidekick 出现在每个后台页面的底部中央,嵌入式应用也在这个范围内。工作人员明确表示,没有隐藏或禁用它的 API。

排查重点应放在应用内容是否仍然可见、可操作,不能把调用一个未提供的隐藏开关作为适配方案。公告没有给出新的收费、地区或套餐条件,也没有列出整改截止日期。

主文档的自动留白,不等于每一层界面都已处理

根据公告,App Bridge 库会在应用主文档底部添加安全区内边距,避免 Sidekick 和其他后台控件遮住关键内容。这项说明针对主文档,不是对所有自定义布局的统一保证。

工作人员另外点名了固定或粘性控件、自定义滚动容器,以及 s-app-window 内的内容:这些界面必须自行应用安全区留白。不要仅凭主页面底部已经出现空白,就认定它们也获得了相同处理。

先看固定操作栏,再看滚动区域和旧模态框

举一个假设的布局例子:订单编辑页面的正文可以正常滚动,但“保存”操作栏固定在页面底部。正文获得了主文档留白,并不意味着这条固定操作栏也已避开 Sidekick;它仍属于公告要求自行处理的控件。这个例子用于说明布局责任,不是某个应用故障的复现结果。

同样检查自定义滚动容器与 s-app-window 内容。公告还特别提醒:如果旧版模态框没有加载 App Bridge CDN 脚本,Sidekick 可能遮住应用底部附近的内容。不要把主页面的表现直接套用到这些单独的界面。

提示消息使用 App Bridge toasts,避开底部遮挡

对于嵌入式应用,公告建议使用 App Bridge toasts。这类提示显示在框架顶部,工作人员说明 Sidekick 不会在那里挡住提示。

如果应用目前把自定义提示放在底部,可以把这条建议与固定控件的排查分开处理:前者是提示的呈现方式,后者是布局需要避让的安全区。不要假设主文档留白会自动移动自定义提示。

把接入建议与尚未回答的资格问题分开

公告面向所有应用提出:把 Sidekick 作为应用的 AI 聊天入口,并通过 Sidekick App Extensions 提供连接应用的读取和写入工具。这是原文明确给出的接入方向,不能被扩展成所有应用都已具备相同接入条件或必须在某天前完成改造。

讨论中的开发者提出了自有 AI 方案、使用限制,以及未采用 Shopify Managed Install 时如何接入的问题。在当前完整的三条帖子中,这些问题没有得到工作人员的后续答复。用户提到的下架经历也不能据此写成新的审核或下架规则。

按实际界面安排改动,保留公告没有回答的边界

可以逐项查看主文档、固定或粘性操作栏、自定义滚动区域、s-app-window、旧版模态框和提示消息,分别确认它们对应的是自动留白、手动处理,还是 App Bridge 提示方式。涉及具体安全区写法时,继续查阅公告链接的 Environment API 文档。

这份公告没有提供具体 CSS 属性名或代码示例,也没有说明完整的套餐、地区、价格及 Managed Install 接入条件。不要据此要求所有商家换套餐、重装应用或采用未经说明的隐藏办法。

资料来源

常见问题

可以统一加一段固定高度的底部空白吗?

公告没有给出适用于所有界面的固定像素值。主文档、固定控件与自定义滚动区域的处理责任也不同,不能用一个猜测的高度保证所有布局都正常;具体安全区写法应查阅公告链接的 Environment API 文档。

已有自己的 AI 聊天功能,就必须立即关闭吗?

原帖要求应用把 Sidekick 作为 AI 聊天入口,并建议集成 Sidekick App Extensions,但没有给出关闭自有 AI 功能的统一命令、执行日期或下架规则。讨论里关于自有 AI 与使用限制的问题仍没有工作人员答复,不能据此自行补出强制措施。

保存成功提示显示出来,就说明订单已保存吗?

提示位于顶部,只解决消息是否被遮挡的问题。确认保存还应查看应用返回的处理结果及对应订单状态,不能把提示的位置当作业务操作成功的证明。