应用通过 CSS 选择器查找您的产品表单、价格、多属性选择器和购物车行。它为每个受支持的主题提供一组经过调校的选择器,并为其他主题提供一组通用的默认选择器,因此在大多数主题上无需任何帮助即可正常工作。
经过大量自定义的主题仍可能把某些元素放在默认选择器找不到的位置。有两种方法可以解决,第一种几乎总是更好的选择。
1. 添加应用自身的属性
几乎每个选择器都以一个 data-gpo-… 属性开头,该属性专门作为供您使用的钩子而存在。在主题中的元素上添加该属性,应用即可找到它,无需维护选择器,主题更新也不会将其重命名。
<form action="/cart/add" method="post" data-gpo-product-form> … <button type="submit" data-gpo-product-atc>Add to cart</button></form>每个选择器对应的属性见下表。
2. 覆盖选择器
当您无法编辑标记时使用此方法——例如您无法控制的分区,或由某个应用渲染的表单。请在应用脚本运行之前,在 theme.liquid 中 </body> 的上方进行设置:
<script> window.GPOConfigs = window.GPOConfigs || {}; window.GPOConfigs.theme = window.GPOConfigs.theme || {}; window.GPOConfigs.theme.product = { ...(window.GPOConfigs.theme.product || {}), form: ['#my-product-form'], addToCartButton: '.my-atc-button' };</script>您的值会合并覆盖应用的值,因此只会覆盖您指定的键。
product
用于产品页面,以及其他页面上的特色产品分区。
| 键 | 属性钩子 | 应用如何使用它 |
|---|---|---|
form | data-gpo-product-form | 产品表单。它是其他一切的基础——选项会渲染到其中,并在提交时进行验证。接受一个数组,按顺序尝试 |
addToCartButton | data-gpo-product-atc | 加入购物车按钮。用于将小组件放在其上方,并在验证失败时阻止提交 |
paymentButton | — | 快速支付按钮。在带有选项的产品上会被隐藏,因为它会跳过表单 |
quantity | — | 数量输入框。读取它是为了让附加项数量能跟随主产品数量 |
unitPrice | data-gpo-product-unit-price | 显示的价格。客户选择带价格的选项时会被重写 |
compareAtPrice | data-gpo-product-compare-at-price | 原价,与价格一同更新 |
variantSelector | data-gpo-product-variant-selector | 保存所选多属性 ID 的隐藏输入框。读取它以了解选中的是哪个多属性 |
variantActivator | data-gpo-product-variant-activator | 客户点击以更改多属性的控件。对其进行监听,以便多属性条件能够作出响应 |
variantWrapper | data-gpo-product-variant-wrapper | 包含多属性选择器的区块。用于相对其定位小组件 |
imageContainer | data-gpo-product-image-container | 主图片区域。个性化工具在此绘制实时预览 |
image | data-gpo-product-image | 主产品图片本身 |
images | data-gpo-product-images | 图库图片,用于预览的应用到设置 |
imageButton | data-gpo-product-image-button | 图库缩略图或箭头,对其进行监听,使预览跟随当前显示的图片 |
sticky.atcButton | data-gpo-sticky-atc | 固定栏中的加入购物车按钮,使其像真正的按钮一样进行验证 |
sticky.variantActivator | data-gpo-sticky-variant-activator | 固定栏中的多属性控件 |
collection
用于产品系列页面上的快速查看弹出窗口。
| 键 | 属性钩子 | 应用如何使用它 |
|---|---|---|
wrapper | data-gpo-collection-wrapper | 产品系列分区,即应用监听的区域 |
item | data-gpo-collection-item | 其中的一张产品卡片 |
productLink | data-gpo-collection-productLink | 指向产品的链接,读取它以了解卡片对应的是哪个产品 |
quickViewActivator | data-gpo-collection-qvActivator | 打开快速查看的控件,对其进行监听,以便应用知道何时渲染 |
quickViewProductForm | data-gpo-collection-qvForm | 快速查看中的产品表单,选项会放在这里 |
cart
用于购物车页面和购物车抽屉,用于编辑选项,以及让附加项行与其父商品保持关联。
| 键 | 属性钩子 | 应用如何使用它 |
|---|---|---|
form | data-gpo-cart-form | 购物车表单。接受一个数组,按顺序尝试 |
page | 见下文 | 如何读取购物车页面上的订单项。接受一个结构数组,按顺序尝试 |
drawer | 见下文 | 购物车抽屉中的相同设置 |
page 和 drawer 各包含一个 lineItem,用于描述购物车中一行的各个部分:
| 部分 | 属性钩子(购物车页面) | 说明 |
|---|---|---|
key | data-gpo-cart-item-key | 行本身,带有订单项的键 |
image | data-gpo-cart-item-image | 该行的缩略图 |
details | data-gpo-cart-item-details | 标题和属性区块,编辑选项会添加在这里 |
quantity.wrapper | data-gpo-cart-item-qty-wrapper | 数量控件,在附加项行上会被隐藏 |
quantity.input | data-gpo-cart-item-qty | 数量字段 |
quantity.decrease / increase | data-gpo-cart-item-qty-decrease / -increase | 减号和加号按钮 |
removeButton | data-gpo-cart-item-remove-button | 移除链接,在附加项行上会被隐藏 |
购物车抽屉使用相同的部分,只是将 data-gpo-cart-item-… 换成 data-gpo-drawer-item-…。
注意事项
- 接受数组的键会按顺序尝试,第一个匹配项生效,因此您可以将自己的选择器添加在默认值前面,而不必替换它们。
- 覆盖选择器只会改变应用查找的位置,不会改变选项收集的内容或其定价方式。
- 覆盖会应用于商店中的每个产品页面。如果只针对一个产品,请在选择器本身中指定该产品。
此页面对您有帮助吗?
感谢您的反馈! 告诉我们缺少了什么
报告问题