DOCS

自定义显示货币

自定义显示货币

覆盖 Hello 显示外币金额的方式。

您可以通过在 JavaScript 集成中自定义货币显示格式来调整外币的显示方式,以满足您的需求和偏好。

货币显示格式 

Hello 支持以下货币显示格式:

  • symbol(默认)- 显示本地化的货币符号,例如 €123
  • code - 使用 ISO 货币代码,例如 123 USD
  • name - 显示本地化的货币名称,例如 123 美元

您可以通过使用 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});
预约演示

这个页面有帮助吗?


在此页面: