自定义文案与多语言设置
验证码默认提供了17种语言类型,您可以根据业务需求,在客户端接入时设置自定义验证码的文案与多语言。
支持的语言
下文是支持的语言,您可以通过language参数来设置所需的语言。
cn:简体中文
tw:繁体中文
en:英文
ar:阿拉伯语
de:德语
es:西班牙语
fr:法语
in:印尼语
it:意大利语
ja:日语
ko:韩语
pt:葡萄牙文
ru:俄语
ms:马来西亚
th:泰语
tr:土耳其
vi:越南
当所选语言设置分别为简体中文(cn)、繁体中文(tw)、英语(en)、日语(ja)或韩语(ko)时,验证码空间推理题目的题库将自动匹配对应的语言版本。对于其他未明确列出的语言选项,默认采用简体中文(cn)的题库。
空间推理验证形态即将下线,具体请参见【公告】空间推理验证形态下线通知。
代码示例
您可以参考以下代码示例自定义设置验证码(Captcha)不同语言下的文案提示。
验证码支持13个组件中的自定义文案,您可以通过传参数upLang: myLang,并定义myLang来自定义验证码组件的文案。
/**
* 语言名,可选cn、tw、en,也可添加自定义语言。
* 语言详情,key/value格式。
*/
var myLang = {
cn: {
// V3架构嵌入式触发按钮的文案。
START_VERIFY: "点击开始验证",
// 验证码提示标题文案,所有验证形态通用。
POPUP_TITLE: "请完成安全验证",
// 不同验证形态下的交互提示文案。
SLIDE_TIP: "请按住滑块,拖动到最右边",
CHECK_BOX_TIP: "确认您不是机器人",
PUZZLE_TIP: "请拖动滑块完成拼图",
INPAINTING_TIP: "请拖动滑块还原完整图片",
// 验证请求的过程提示文案,滑块验证和一点即过形态下适用。
VERIFYING: "验证中...",
// 验证通过的提示文案,所有验证形态通用。
SUCCESS: "验证通过!",
// 验证失败的提示文案,滑块验证和一点即过形态下适用。
SLIDE_FAIL: "验证失败,请刷新重试",
//验证失败的提示文案,拼图验证和图像复原形态下适用。
CAPTCHA_FAIL: "验证失败,请重试!",
// 网络情况异常的提示文案。
CONGESTION: "前方拥堵,请刷新重试",
// 交互完成,提交验证前的提示文案。V2架构-嵌入式特有,当前由业务按钮触发提交验证。
CAPTCHA_COMPLETED: "滑动完成",
// 未完成任何交互就直接提交验证的提示文案。V2架构-嵌入式特有,当前由业务按钮触发提交验证。
FINISH_CAPTCHA: "请先完成验证!",
},
en: {
// 字段同上
POPUP_TITLE: "Please complete captcha",
// ...
},
};
initAliyunCaptcha({
...
upLang: "",
language:"cn", // 验证码语言类型 比如 "cn"。
...
});
如果上述提供的语言不能满足您的需求,您可以在initAliyunCaptcha函数中的language参数中填写所需的语言类型,并自行翻译myLang里的13处提示文案(key值)。例如:
(language: 'xx' , "xx": { "POPUP_TITLE": "对应语言的文案"} )
。若您所定义的语言不在提供的语言范围内,则系统将默认返回中文语言文案。如果您定义的语言属于提供的语言范围,系统将返回对应语言的默认文案。
不支持自定义的系统文案:页面停留过长,请刷新页面重试。
文案对应显示的位置
以下是对 myLang
对象中存储验证码组件显示的文本,例如安全验证、加载状态提示、验证失败提示等。
key | 默认值 | 滑块验证-示例图 | 一点即过-示例图 | 拼图验证-示例图 | 图像复原-示例图 | 备注 |
START_VERIFY | "点击开始验证" | / | / | V3架构嵌入式触发按钮的文案。 | ||
POPUP_TITLE | "请完成安全验证" | 验证码提示标题文案,所有验证形态通用。 | ||||
|
| 不同验证形态下的交互提示文案。 | ||||
VERIFYING | "验证中..." | / | / | 验证请求的过程提示文案,滑块验证和一点即过形态下适用。 | ||
SUCCESS | "验证通过" | 验证通过的提示文案,所有验证形态通用。 | ||||
SLIDE_FAIL | "验证失败,请刷新重试" | / | / | 验证失败的提示文案,滑块验证和一点即过形态下适用。 | ||
CAPTCHA_FAIL | "验证失败,请重试!" | / | / | 验证失败的提示文案,拼图验证和图像复原形态下适用。 | ||
CONGESTION | "前方拥堵,请刷新重试" | 网络情况异常的提示文案。 | ||||
CAPTCHA_COMPLETED | "滑动完成" | / | 交互完成,提交验证前的提示文案。V2架构-嵌入式特有,当前由业务按钮触发提交验证。 说明
| |||
FINISH_CAPTCHA | "请先完成验证!" | 未完成任何交互就直接提交验证的提示文案。V2架构-嵌入式特有,当前由业务按钮触发提交验证。 说明 暂不支持更改提示位置,建议接入V3架构的嵌入式交互UI。 | ||||
/ |
| 不支持修改 |