guide本地化

UI 的默认语言是英语,但您可以从 40 多种支持的语言中选择。如果您想使用其他语言,则必须加载其语言资源文件。根据安装方法,您可能需要使用 CDNnpm压缩包 来加载语言资源。然后可以使用 language 配置选项来设置语言。

在以下示例中,CKBox 被配置为使用西班牙语。

CKBox.mount(document.querySelector('#ckbox'), {
    tokenUrl: 'https://your.token.url',
    language: 'es'
});

# 包含语言文件

# CDN

如果您使用 CDN,则可以与 CKBox 一起加载额外的语言文件。使用以下 URL 格式来加载语言脚本
https://cdn.ckbox.io/ckbox/2.5.1/translations/[lang-code].js

<script src="https://cdn.ckbox.io/ckbox/2.5.1/ckbox.js"></script>
<script src="https://cdn.ckbox.io/ckbox/2.5.1/translations/es.js"></script>

# npm

如果您将 CKBox 作为 npm 依赖项使用,则可以使用以下模式在您的应用程序中 import 所需的语言:import 'ckbox/dist/translations/[lang-code]';

import * as CKBox from 'ckbox';
import 'ckbox/dist/styles/ckbox.css';
import 'ckbox/dist/translations/es';

CKBox.mount(document.querySelector('#ckbox'), {
    tokenUrl: 'https://your.token.url',
    language: 'es',
});

请注意,在这种情况下,仍然可以使用 <script> 标签动态加载语言。

# 压缩包

在压缩包中,语言文件位于 ckbox/translations 文件夹中,可以与 CKBox 脚本一起加载

<script src="ckbox/ckbox.js"></script>
<script src="ckbox/translations/[lang-code].js"></script>

# 支持的语言列表

语言 代码
孟加拉语 bn
保加利亚语 bg
加泰罗尼亚语 ca
简体中文 zh
繁体中文 zh-tw
捷克语 cs
丹麦语 da
荷兰语 nl
英语 en
爱沙尼亚语 et
芬兰语 fi
法语 fr
加拿大法语 fr-ca
德语 de
希腊语 el
印地语 hi
匈牙利语 hu
印尼语 id
意大利语 it
日语 ja
韩语 ko
拉脱维亚语 lv
立陶宛语 lt
马来语 ms
马拉地语 mr
挪威语 no
波兰语 pl
巴西葡萄牙语 pt-br
欧洲葡萄牙语 pt
罗马尼亚语 ro
俄语 ru
塞尔维亚语 sr
斯洛伐克语 sk
西班牙语(西班牙) es
西班牙语(拉丁美洲) es-la
西班牙语(墨西哥) es-mx
瑞典语 sv
泰语 th
土耳其语 tr
乌克兰语 uk
越南语 vi