DOCS

自訂貨幣顯示

覆蓋 Hello 顯示外幣金額的方式。

您可以透過在 JavaScript 整合中自訂貨幣顯示格式,來客製化外幣的呈現方式以符合您的需求和偏好設定。

貨幣顯示格式 

Hello 支援以下貨幣顯示格式:

  • symbol(預設值)- 顯示本地化的貨幣符號,例如 €123
  • code - 使用 ISO 貨幣代碼,例如 123 USD
  • name - 顯示本地化的貨幣名稱,例如 123 dollars

您可以透過在 Zonos.init 方法中使用 overrideCurrencyFormat 屬性來覆蓋貨幣顯示格式。此屬性接受上述列出的其中一種貨幣顯示格式。覆蓋貨幣顯示格式會套用於 Hello 和 Zonos Checkout 兩者。

1Zonos.init({
2 overrideCurrencyFormat: 'code',
3});

使用自訂貨幣轉換器 

在某些情況下,簡單地覆蓋貨幣顯示格式可能不足以滿足您網站的需求,您可以使用自訂貨幣轉換器來處理外幣金額的轉換和格式化。此方法讓您完全控制貨幣金額在網站上的顯示方式。

若要使用自訂貨幣轉換器,您需要在 Zonos.init 方法中實現 currencyConverter 函數。此函數應接受以下參數:

  • convertAndFormat - 轉換和格式化貨幣金額的函數。
  • originalAmount - 原始貨幣金額。
  • selector - 包含貨幣金額的元素選擇器。

currencyConverter 函數存在時,它會遍歷您網站上所有符合的價格選擇器,並將自訂貨幣轉換邏輯套用於每一個。

使用自訂貨幣轉換器函數的一個常見用例是當您在下拉選單或其他複雜的 HTML 元素中顯示價格時。例如,如果您有一個下拉選單,在每個選項旁邊顯示價格,例如:

1

在這種情況下,您無法簡單地直接選擇價格,因為它旁邊有額外的文字。透過使用自訂貨幣轉換器,您可以從元素中提取價格並將貨幣轉換邏輯套用於它。

1window.Zonos.init({
2 currencyConverter: ({ convertAndFormat, originalAmount, selector }) => {
3 const optionValue = selector.getAttribute('data-select-option');
4 if (optionValue) {
5 return `${optionValue} - ${convertAndFormat(originalAmount)}`;
6 }
7 return convertAndFormat(originalAmount);
8 },
9});
預約演示

這個頁面有幫助嗎?


獲取支持·法律文件·© 2026 Zonos
在此頁面: