@gladesinger/vue3-yandex-smartcaptcha

中文文档
1.0.1发布于 2025/12/19MITTypeScriptESM + CJS零依赖近 30 天下载 3032

Yandex 智能卡普查 Vue 组件

中文使用文档
文档目录23 节
  1. Описание
  2. Установка
  3. Импорт
  4. 类型脚本QQ
  5. 校对:Soup
  6. Пропсы
  7. Эмиты
  8. Методы
  9. Примеры
  10. Обычная
  11. Невидимая
  12. 说明
  13. 安装
  14. 使用量
  15. 导入组件
  16. 类型脚本支持
  17. 可用类型 :
  18. 道具
  19. 活动
  20. 方法
  21. 用法实例
  22. 常规控制
  23. 隐形队长

Yandex 智能卡普查 Vue 组件

Vue 3 Yandex 智能卡普查

Русская | 英文本

Описание

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}Yandex Smartcaptcha. {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得怎样? {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢? {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 Yandex Smartcaptcha (英语)

Установка

说吧

npm install @gladesinger/vue3-yandex-smartcaptcha@latest

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 YandexSmartCaptcha {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你应该知道 {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你是谁 校对:Soup

Импорт

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢? 阴:

import { YandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha'

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢? 阴:

import { createApp } from 'vue'
import App from './App.vue'
import { YandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha'

const app = createApp(App)
app.component('YandexSmartCaptcha', YandexSmartCaptcha)
app.mount('#app')

############################################################################################################################################## 客户端.

类型脚本QQ

================================================================================================ ========================================================================================================================================= (==================== 说吧

import type { 
  IYandexSmartCaptchaProps,
  IYandexSmartCaptchaEmits,
  IYandexSmartCaptcha,
  TCaptchaEvents,
  TSupportedLanguages,
  TShieldPositions
} from '@gladesinger/vue3-yandex-smartcaptcha/types';

校对:Soup

  • IYandexSmartCaptchaProps - типы пропсов компонента
  • IYandexSmartCaptchaEmits - типы эмитов компонента
  • IYandexSmartCaptcha - типы и и компонента
  • TCaptchaEvents - типы событий капчи
  • TSupportedLanguages - поддерживаемые языки
  • TShieldPositions - возможные позиции

Пропсы

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 YandexSmartCaptcha数字 :

ПропсТип{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢Описание
siteKeyString- 说吧Ключ.
languageTSupportedLanguages'ru'Язык. 校对:Soup 'ru', (中文(简体) ), 'en', (中文(简体) ), 'be', (中文(简体) ), 'kk', (中文(简体) ), 'tt', (中文(简体) ), 'uk', (中文(简体) ), 'uz', (中文(简体) ), 'tr'。 。 。 .
testBooleanfalse{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你说什么? {\fn华文仿宋\fs16\1cHD1D1D1}好! {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
webviewBooleanfalse################################################################################################################################################################################################################################################################.
invisibleBooleanfalseНевидимая.
shieldPositionTShieldPositions'bottom-right'{\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}你觉得呢? 校对:Soup 'top-left', (中文(简体) ), 'center-left', (中文(简体) ), 'bottom-left', (中文(简体) ), 'top-right', (中文(简体) ), 'center-right', (中文(简体) ), 'bottom-right'。 。 。 .
hideShieldBooleanfalse{\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}你觉得呢.
loadWidgetBooleantrue{\fn华文仿宋\fs16\1cHD1D1D1}好.
deferBooleantrue推迟.
asyncBooleanfalse{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
useOldUrlBooleanfalse{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}"聪明的captcha" yandexcloud.net {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你还好吧.

Эмиты

Компонент YandexSmartCaptcha 说吧

СобытиеОписаниеАргумент
callback{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.token: string
onChallengeVisible{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.() => void
onChallengeHidden{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.() => void
onNetworkErrorВозникла.error: { message: string }
onJavaScriptError联合来文.error: { filename: string, message: string, col: number, line: number }
onSuccessУспешная.token: string
onTokenExpired{\fn华文仿宋\fs16\1cHD1D1D1}好.() => void

Методы

说吧

МетодОписаниеАргумент
getResponse{\fn华文仿宋\fs16\1cHD1D1D1}好.
executeЗапускает. {\fn华文仿宋\fs16\1cHD1D1D1}好.
reset{\fn华文仿宋\fs16\1cHD1D1D1}好.
destroy{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
subscribeПодписывает. {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}你觉得怎么样.eventName: TCaptchaEvents, callbackFun: Function. Доступные: 'challenge-visible', (中文(简体) ), 'challenge-hidden', (中文(简体) ), 'network-error', (中文(简体) ), 'javascript-error', (中文(简体) ), 'success', (中文(简体) ), 'token-expired'。 。 。 .

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 widgetId。 。 。 .

Примеры

Обычная

Java 脚本

<script setup>
import { YandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha'

const success = (token) => {
  console.log(token)
}

const expired = () => {
  console.log('expired')
}
</script>

<template>
  <div>
    <YandexSmartCaptcha 
      siteKey="ваш_ключ_сайта"
      @onSuccess="success"
      @onTokenExpired="expired"
    />
  </div>
</template>

类型脚本

<script setup lang="ts">
import { YandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha'
import type { IYandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha/types'

const success = (token: string) => {
  console.log(token)
}

const expired = () => {
  console.log('expired')
}
</script>

<template>
  <div>
    <YandexSmartCaptcha 
      siteKey="ваш_ключ_сайта"
      @onSuccess="success"
      @onTokenExpired="expired"
    />
  </div>
</template>

类型脚本 Nuxt 3

<script setup lang="ts">
import { YandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha'
import type { IYandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha/types'

const success = (token: string) => {
  console.log(token)
}

const expired = () => {
  console.log('expired')
}
</script>

<template>
  <div>
    <ClientOnly>
      <YandexSmartCaptcha 
        siteKey="ваш_ключ_сайта"
        @onSuccess="success"
        @onTokenExpired="expired"
      />
    </ClientOnly>
  </div>
</template>

Невидимая

Java 脚本

<script setup>
import { YandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha'
import { ref } from 'vue'

const yaCaptcha = ref(null)

const success = (token) => {
  console.log(token)
}

const expired = () => {
  console.log('expired')
}

const fireCaptcha = () => {
  yaCaptcha.value.execute()
}
</script>

<template>
  <div>
    <YandexSmartCaptcha 
      ref="yaCaptcha"
      siteKey="ваш_ключ_сайта"
      :invisible="true"
      shieldPosition="top-left"
      @onSuccess="success"
      @onTokenExpired="expired"
    />
    <button @click="fireCaptcha">Тест</button>
  </div>
</template>

类型脚本

<script setup lang="ts">
import { YandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha'
import type { IYandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha/types'
import { ref } from 'vue'

const yaCaptcha = ref<IYandexSmartCaptcha | null>(null)

const success = (token: string) => {
  console.log(token)
}

const expired = () => {
  console.log('expired')
}

const fireCaptcha = () => {
  yaCaptcha.value?.execute()
}
</script>

<template>
  <div>
    <YandexSmartCaptcha 
      ref="yaCaptcha"
      siteKey="ваш_ключ_сайта"
      :invisible="true"
      shieldPosition="top-left"
      @onSuccess="success"
      @onTokenExpired="expired"
    />
    <button @click="fireCaptcha">Тест</button>
  </div>
</template>

说明

此软件包为 Yandex Smartcaptcha 带来了组件 。 在使用前,您需要从官方网站获取用户代币. 这里可用的 Smartcaptcha 文档 Yandex Smartcaptcha (英语)

安装

要安装此软件包, 请运行以下命令 :

npm install @gladesinger/vue3-yandex-smartcaptcha@latest

使用量

你可以用这个 YandexSmartCaptcha 您的 Vue 3 项目的组成部分如下:

导入组件

导入组件并在您的 Vue 文件中使用 :

import { YandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha'

或注册为 Vue 插件 :

import { createApp } from 'vue'
import App from './App.vue'
import { YandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha'

const app = createApp(App)
app.component('YandexSmartCaptcha', YandexSmartCaptcha)
app.mount('#app')

对于 Nuxt 的使用,请将组件调用包入 ClientOnly。 。 。 .

类型脚本支持

该组件完全支持TypeScript,并提供了所有道具,发件,和方法的类型. 类型可通过导入获取 :

import type { 
  IYandexSmartCaptchaProps,
  IYandexSmartCaptchaEmits,
  IYandexSmartCaptcha,
  TCaptchaEvents,
  TSupportedLanguages,
  TShieldPositions
} from '@gladesinger/vue3-yandex-smartcaptcha/types';

可用类型 :

  • IYandexSmartCaptchaProps - 组件道具的类型
  • IYandexSmartCaptchaEmits - 组件发射类型
  • IYandexSmartCaptcha - 组合方法和属性的类型
  • TCaptchaEvents - 事件类型
  • TSupportedLanguages - 支持的语言
  • TShieldPositions - 可能的盾牌位置

道具

这里有一张列表 可用的道具 YandexSmartCaptcha 组件 :

Prop类型默认值说明
siteKeyString- 说吧客户端密钥 .
languageTSupportedLanguages'ru'部件语言. 可用值 : 'ru', (中文(简体) ), 'en', (中文(简体) ), 'be', (中文(简体) ), 'kk', (中文(简体) ), 'tt', (中文(简体) ), 'uk', (中文(简体) ), 'uz', (中文(简体) ), 'tr'。 。 。 .
testBooleanfalse启用 Captcha 测试模式 。 用户总是会收到质疑. 只用于调试和测试.
webviewBooleanfalse运行WebView中的cabtcha,以提高使用WebView的移动应用程序的准确性.
invisibleBooleanfalse隐相相相相相相.
shieldPositionTShieldPositions'bottom-right'数据处理通知块的位置。 可用值 : 'top-left', (中文(简体) ), 'center-left', (中文(简体) ), 'bottom-left', (中文(简体) ), 'top-right', (中文(简体) ), 'center-right', (中文(简体) ), 'bottom-right'。 。 。 .
hideShieldBooleanfalse隐藏数据处理通知块.
loadWidgetBooleantrue组件挂起时装入部件 .
deferBooleantrue以延迟属性装入脚本 .
asyncBooleanfalse以 Aync 属性装入脚本 .
useOldUrlBooleanfalse使用旧智能captcha.yandexcloud.net url来装入脚本.

活动

这个 YandexSmartCaptcha 构成部分支持下列活动:

活动说明参数
callback回调函数, 成功时返回符号 .token: string
onChallengeVisible挑战窗口可见.() => void
onChallengeHidden挑战窗口变得隐蔽.() => void
onNetworkError网络出错 .error: { message: string }
onJavaScriptError发生了 JavaScript 关键错误 .error: { filename: string, message: string, col: number, line: number }
onSuccess用户验证成功 .token: string
onTokenExpired代币过期了.() => void

方法

该部分披露了以下方法:

方法说明参数
getResponse返回用户符号的当前值.
execute启动用户验证进程。 用来触发隐形相机.
reset将部件重置到初始状态 .
destroy删除部件及其处理器.
subscribe订阅特定部件事件的处理器 。 例如,跟踪挑战窗口的打开和关闭.eventName: TCaptchaEvents, callbackFun: Function。可用事件: 'challenge-visible', (中文(简体) ), 'challenge-hidden', (中文(简体) ), 'network-error', (中文(简体) ), 'javascript-error', (中文(简体) ), 'success', (中文(简体) ), 'token-expired'。 。 。 .

该部分还暴露了 widgetId 州,如果你需要它为你的案子.

用法实例

常规控制

Java 脚本

<script setup>
import { YandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha'

const success = (token) => {
  console.log(token)
}

const expired = () => {
  console.log('expired')
}
</script>

<template>
  <div>
    <YandexSmartCaptcha 
      siteKey="your_site_key"
      @onSuccess="success"
      @onTokenExpired="expired"
    />
  </div>
</template>

类型脚本

<script setup lang="ts">
import { YandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha'
import type { IYandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha/types'

const success = (token: string) => {
  console.log(token)
}

const expired = () => {
  console.log('expired')
}
</script>

<template>
  <div>
    <YandexSmartCaptcha 
      siteKey="your_site_key"
      @onSuccess="success"
      @onTokenExpired="expired"
    />
  </div>
</template>

类型脚本 Nuxt 3

<script setup lang="ts">
import { YandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha'
import type { IYandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha/types'

const success = (token: string) => {
  console.log(token)
}

const expired = () => {
  console.log('expired')
}
</script>

<template>
  <div>
    <ClientOnly>
      <YandexSmartCaptcha 
        siteKey="your_site_key"
        @onSuccess="success"
        @onTokenExpired="expired"
      />
    </ClientOnly>
  </div>
</template>

隐形队长

Java 脚本

<script setup>
import { YandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha'
import { ref } from 'vue'

const yaCaptcha = ref(null)

const success = (token) => {
  console.log(token)
}

const expired = () => {
  console.log('expired')
}

const fireCaptcha = () => {
  yaCaptcha.value.execute()
}
</script>

<template>
  <div>
    <YandexSmartCaptcha 
      ref="yaCaptcha"
      siteKey="your_site_key"
      :invisible="true"
      shieldPosition="top-left"
      @onSuccess="success"
      @onTokenExpired="expired"
    />
    <button @click="fireCaptcha">Test</button>
  </div>
</template>

类型脚本

<script setup lang="ts">
import { YandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha'
import type { IYandexSmartCaptcha } from '@gladesinger/vue3-yandex-smartcaptcha/types'
import { ref } from 'vue'

const yaCaptcha = ref<IYandexSmartCaptcha | null>(null)

const success = (token: string) => {
  console.log(token)
}

const expired = () => {
  console.log('expired')
}

const fireCaptcha = () => {
  yaCaptcha.value?.execute()
}
</script>

<template>
  <div>
    <YandexSmartCaptcha 
      ref="yaCaptcha"
      siteKey="your_site_key"
      :invisible="true"
      shieldPosition="top-left"
      @onSuccess="success"
      @onTokenExpired="expired"
    />
    <button @click="fireCaptcha">Test</button>
  </div>
</template>

版本与发布记录

@gladesinger/vue3-yandex-smartcaptcha 共发布 4 个版本,首次发布于 2024/08/06;过去 12 个月发布了 1 个版本。

版本发布日期距今
1.0.1latest2025/12/1910 个月前
1.0.02025/04/161.6 年前
0.0.22024/08/062 年前
0.0.12024/08/062 年前

关于 @gladesinger/vue3-yandex-smartcaptcha 的常见问题

@gladesinger/vue3-yandex-smartcaptcha 是什么?

Yandex 智能卡普查 Vue 组件

如何安装 @gladesinger/vue3-yandex-smartcaptcha?

在项目目录运行 npm install @gladesinger/vue3-yandex-smartcaptcha,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:vue(^3.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gladesinger/vue3-yandex-smartcaptcha 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gladesinger/vue3-yandex-smartcaptcha 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@gladesinger/vue3-yandex-smartcaptcha 可以商用吗?

@gladesinger/vue3-yandex-smartcaptcha 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gladesinger/vue3-yandex-smartcaptcha 的下载量有多少?

根据 npm 官方下载统计,@gladesinger/vue3-yandex-smartcaptcha 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,032 次,日均约 101 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gladesinger/vue3-yandex-smartcaptcha 还在维护吗?

最新版本 1.0.1 发布于 2025/12/19(10 个月前);至今共发布 4 个版本,其中过去 12 个月发布了 1 个;首次发布于 2024/08/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。