全部產品
Search
文件中心

Captcha:自訂文案與多語言設定

更新時間:Jul 05, 2025

驗證碼預設提供了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

不支援修改