文档

自定义文案与多语言设置

更新时间:
一键部署

验证码默认提供了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)不同语言下的文案提示。

说明

验证码支持10个组件中的自定义文案,您可以通过传参数upLang: myLang,并定义myLang来自定义验证码组件的文案。

/**
 * 语言名,可选cn、tw、en,也可添加自定义语言。
 * 语言详情,key/value格式。
 */
var myLang = {
  	"cn": {
      // 加载状态提示
      "LOADING": "加载中...",
      // 弹出式窗口标题
      "POPUP_TITLE": "请完成安全验证",
      // 嵌入式下未完成验证时触发了验证请求的提示
      "FINISH_CAPTCHA": "请先完成验证!",
       // 嵌入式下滑块和拼图滑动完成提示
      "CAPTCHA_COMPLETED": "滑动完成",
       // 验证中提示
      "VERIFYING": "验证中...",
      // 验证通过状态提示
      "SUCCESS": "验证通过!",
     // 滑块验证失败状态提示
      "SLIDE_FAIL": "验证失败,请刷新重试",
      // 滑块提示
      "SLIDE_TIP": "请按住滑块,拖动到最右边",
      // 空间验证验及其他模式证失败状态提示
      "CAPTCHA_FAIL": "验证失败,请重试!",
      // 拼图模式提示文案
      "PUZZLE_TIP": "请拖动滑块完成拼图",
    },
    "en": {
      // 字段同上
      "POPUP_TITLE": "Please complete captcha",
      // ...
    }
  };

initAliyunCaptcha({
  ...
  upLang: myLang
  language: 'cn', // 验证码语言类型 比如 "cn"。
  ...
});

重要
  1. 如果上述提供的语言不能满足您的需求,您可以在initAliyunCaptcha函数中的language参数中填写所需的语言类型,并自行翻译myLang里的10处提示文案(key值)。例如:(language: 'xx' , "xx": { "POPUP_TITLE": "对应语言的文案"} )

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

文案对应显示的位置

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

文案key

出现场景

备注

LOADING

image.png

通用

POPUP_TITLE

image.png

通用

FINISH_CAPTCHA

image.png

通用

CAPTCHA_COMPLETED

image.png

通用

VERIFYING

image.png

通用

SUCCESS

image.png

通用

SLIDE_FAIL

image.png

仅滑块

SLIDE_TIP

image.png

仅滑块

CAPTCHA_FAIL

image.png

滑块验证

PUZZLE_TIP

image.png

拼图模式

  • 本页导读 (1)
文档反馈