跳转到内容
安装应用
简体中文

JavaScript API

店面对象、可覆盖的主题选择器,以及应用触发的事件。

本页面向负责主题开发的开发者。正常使用应用不需要这里的任何内容——它只用于主题的做法过于特殊、应用自身的设置无法覆盖的情况。

以下所有内容都在店面上运行,并且需要启用应用嵌入。未启用时,这些对象和事件都不存在。

window.GPOConfigs

应用的店面对象。它由应用嵌入在应用自身脚本运行之前创建,因此才能实现下面的覆盖。

属性包含的内容
theme应用用来在主题中查找元素的选择器。请参阅主题选择器
page.typeShopify 页面类型——product、cart、index、collection 等
product当前产品,格式为 Shopify 的产品 JSON,另加 product.collections,其中包含产品所属产品系列的 ID。不在产品页面时为 false
cart当前购物车,格式为 Shopify 的购物车 JSON
customer已登录客户的 id、name、email 和 tags,否则为 false。客户规则匹配的正是这些标签
curCountryCode访客所在国家/地区的两字母代码。国家/地区规则匹配的正是此值
money_format应用格式化价格时使用的货币格式,遵循您的附加项价格设置
initialize()重新运行应用。请参阅重新运行应用

本节其他内容

重新运行应用

GPOConfigs.initialize() 会从头重新运行应用。当页面加载后有内容替换了产品表单时使用它——例如页面构建器替换了分区,或主题在多属性更改时重新渲染产品。

window.GPOConfigs && window.GPOConfigs.initialize();

请在新的标记已插入 DOM 之后调用,而不是之前。在没有任何变化时调用会不必要地重新渲染选项,因此请由主题自身的“分区已替换”信号来触发,而不要使用定时器。

注意事项

  • 以上所有内容都需要在已发布的主题上启用应用嵌入。请参阅启用应用嵌入。
  • GPOConfigs 存在于应用嵌入运行的每个页面上,但离开产品页面时 product 为 false。
  • 覆盖选择器不会改变选项收集的内容,只会改变应用在主题中查找元素的位置。
  • 如果某个主题在所有使用它的商店上都需要相同的覆盖,请将其发送给我们,而不要在每个商店中重复设置。请参阅联系支持团队。

此页面对您有帮助吗?

报告问题