應用程式透過 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 | 圖庫圖片,用於預覽的 Apply to(套用至)設定 |
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 | 該列本身,帶有品項的 key |
image | data-gpo-cart-item-image | 該列的縮圖 |
details | data-gpo-cart-item-details | 標題與屬性區塊,Edit Options(編輯選項)按鈕會加在這裡 |
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-drawer-item-… 取代 data-gpo-cart-item-…。
注意事項
- 接受陣列的鍵會依序嘗試,第一個符合的項目優先,因此您可以將自己的值加在預設值前面,而不必取代預設值。
- 覆寫選擇器只會改變應用程式尋找的位置,不會改變選項收集的內容或其定價方式。
- 覆寫會套用到商店中的每個商品頁面。若只針對單一商品,請在選擇器本身中指定。
這個頁面有幫助嗎?
感謝您的意見回饋! 告訴我們缺少了什麼
回報問題