本地化
UI 的默认语言是英语,但您可以从 40 多种支持的语言中选择。如果您想使用其他语言,则必须加载其语言资源文件。根据安装方法,您可能需要使用 CDN、npm 或 压缩包 来加载语言资源。然后可以使用 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 |
需要更多功能?参与调查,帮助我们开发 CKBox 以更好地满足您的需求!