跳到內容
安裝應用程式
繁體中文

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。
  • 覆寫選擇器不會改變選項收集的內容,只會改變應用程式在佈景主題中尋找元素的位置。
  • 如果某個佈景主題在每間使用它的商店上都需要同樣的覆寫,請將其傳送給我們,而不要在每間商店重複設定。請參閱聯絡支援團隊。

這個頁面有幫助嗎?

回報問題