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}你觉得呢 | Описание |
|---|---|---|---|
siteKey | String | - 说吧 | Ключ. |
language | TSupportedLanguages | 'ru' | Язык. 校对:Soup 'ru', (中文(简体) ), 'en', (中文(简体) ), 'be', (中文(简体) ), 'kk', (中文(简体) ), 'tt', (中文(简体) ), 'uk', (中文(简体) ), 'uz', (中文(简体) ), 'tr'。 。 。 . |
test | Boolean | false | {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你说什么? {\fn华文仿宋\fs16\1cHD1D1D1}好! {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢. |
webview | Boolean | false | ################################################################################################################################################################################################################################################################. |
invisible | Boolean | false | Невидимая. |
shieldPosition | TShieldPositions | 'bottom-right' | {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}你觉得呢? 校对:Soup 'top-left', (中文(简体) ), 'center-left', (中文(简体) ), 'bottom-left', (中文(简体) ), 'top-right', (中文(简体) ), 'center-right', (中文(简体) ), 'bottom-right'。 。 。 . |
hideShield | Boolean | false | {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}你觉得呢. |
loadWidget | Boolean | true | {\fn华文仿宋\fs16\1cHD1D1D1}好. |
defer | Boolean | true | 推迟. |
async | Boolean | false | {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢. |
useOldUrl | Boolean | false | {\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 | 类型 | 默认值 | 说明 |
|---|---|---|---|
siteKey | String | - 说吧 | 客户端密钥 . |
language | TSupportedLanguages | 'ru' | 部件语言. 可用值 : 'ru', (中文(简体) ), 'en', (中文(简体) ), 'be', (中文(简体) ), 'kk', (中文(简体) ), 'tt', (中文(简体) ), 'uk', (中文(简体) ), 'uz', (中文(简体) ), 'tr'。 。 。 . |
test | Boolean | false | 启用 Captcha 测试模式 。 用户总是会收到质疑. 只用于调试和测试. |
webview | Boolean | false | 运行WebView中的cabtcha,以提高使用WebView的移动应用程序的准确性. |
invisible | Boolean | false | 隐相相相相相相. |
shieldPosition | TShieldPositions | 'bottom-right' | 数据处理通知块的位置。 可用值 : 'top-left', (中文(简体) ), 'center-left', (中文(简体) ), 'bottom-left', (中文(简体) ), 'top-right', (中文(简体) ), 'center-right', (中文(简体) ), 'bottom-right'。 。 。 . |
hideShield | Boolean | false | 隐藏数据处理通知块. |
loadWidget | Boolean | true | 组件挂起时装入部件 . |
defer | Boolean | true | 以延迟属性装入脚本 . |
async | Boolean | false | 以 Aync 属性装入脚本 . |
useOldUrl | Boolean | false | 使用旧智能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>