SuperAPI AI 工具集

post-purchase-ui-extension

前端与建站

查看项目

更新于 10-16 03:48

技能介绍

用途:用于构建 Shopify 购后追加销售界面(付款后、感谢页之间的屏幕),封装 @shopify/post-purchase-ui-extensions-react(npm 0.13.5,已进入维护,无更新版本;现代 <s-*> checkout-extensions SDK 暂无购后目标)。

主要能力:提供 29 个组件的目录、生命周期契约与沙箱规则。两个扩展点分两阶段:extend("Checkout::PostPurchase::ShouldRender") 做数据预取并决定是否渲染;render("Checkout::PostPurchase::Render", App) 挂载 React 树,仅当 ShouldRender 返回 { render: true } 时运行。storage 是两阶段唯一的传递通道;applyChangeset 接收后端签名 JWT 字符串,不可客户端签名;成功或出错都必须调用 done()。

使用方式:import 必须带 .jsx/.js 扩展名;仅从该 SDK 再导出的 react 入口导入。查阅组件 props 用 https://shopify.dev/docs/api/checkout-extensions/post-purchase/components/<name>(小写)。不要用 shopify skill 的 search_docs.mjs 或 validate.mjs,其文档未覆盖本 SDK。

适用场景:Shopify 购后升级/订阅追加销售界面开发。

限制:沙箱无 DOM、CSS、window 或外部脚本,样式仅通过组件 props;Shop Pay 下 storage.initialData 为空需重取;ShouldRender 可能多次触发,需幂等;间距令牌各组件尺度不同,不可互换;资料未提供官方文档与官方文本。