自定义文案与多语言设置

更新时间:

验证码默认提供了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"。
  ...
});
重要
  1. 如果上述提供的语言不能满足您的需求,您可以在initAliyunCaptcha函数中的language参数中填写所需的语言类型,并自行翻译myLang里的13处提示文案(key值)。例如:(language: 'xx' , "xx": { "POPUP_TITLE": "对应语言的文案"} )

  2. 若您所定义的语言不在提供的语言范围内,则系统将默认返回中文语言文案。如果您定义的语言属于提供的语言范围,系统将返回对应语言的默认文案。

  3. 不支持自定义的系统文案:页面停留过长,请刷新页面重试。

文案对应显示的位置

以下是对 myLang 对象中存储验证码组件显示的文本,例如安全验证、加载状态提示、验证失败提示等。

key

默认值

滑块验证-示例图

一点即过-示例图

拼图验证-示例图

图像复原-示例图

备注

START_VERIFY

"点击开始验证"

/

/

image

image

V3架构嵌入式触发按钮的文案。

POPUP_TITLE

"请完成安全验证"

image

image

image

image

验证码提示标题文案,所有验证形态通用。

  • SLIDE_TIP

  • CHECK_BOX_TIP

  • PUZZLE_TIP

  • INPAINTING_TIP

  • "请按住滑块,拖动到最右边"

  • "确认您不是机器人"

  • "请拖动滑块完成拼图"

  • "请拖动滑块还原完整图片”

image

image

image

image

不同验证形态下的交互提示文案。

VERIFYING

"验证中..."

image

image

/

/

验证请求的过程提示文案,滑块验证和一点即过形态下适用。

SUCCESS

"验证通过"

image

image

image

image

验证通过的提示文案,所有验证形态通用。

SLIDE_FAIL

"验证失败,请刷新重试"

image

image

/

/

验证失败的提示文案,滑块验证和一点即过形态下适用。

CAPTCHA_FAIL

"验证失败,请重试!"

/

/

image

image

验证失败的提示文案,拼图验证和图像复原形态下适用。

CONGESTION

"前方拥堵,请刷新重试"

image

image

image

image

网络情况异常的提示文案。

CAPTCHA_COMPLETED

"滑动完成"

image

/

image

image

交互完成,提交验证前的提示文案。V2架构-嵌入式特有,当前由业务按钮触发提交验证。

说明
  • 交互体验欠佳,建议接入V3架构的嵌入式交互UI。

  • 若需要滑动完成直接提交验证,参考V2架构中初始化参数immediate设置为true。

FINISH_CAPTCHA

"请先完成验证!"

image

image

image

image

未完成任何交互就直接提交验证的提示文案。V2架构-嵌入式特有,当前由业务按钮触发提交验证。

说明

暂不支持更改提示位置,建议接入V3架构的嵌入式交互UI。

/

  • "验证超时,请关闭验证码重试"

  • "验证超时,请点击验证码框体重试"

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

不支持修改