arcaptcha-vue
ARCaptcha vue component
907
4
| Install | |
|---|---|
npm install arcaptcha-vue |
|
| Latest Version: | 0.0.13 |
| Vue: | 2 |
| License: | MIT |
| Last Updated: | Jul 21, 2025 |
| Links: | GitHub · npm |
Maintainer: yasaman.hbn
ARCaptcha Vue
ARCaptcha Component Library for Vue.js which is Compatible with Vue 2. (Vue3 support is under development)
If you use Vue version 3 please go to this link.
Installation
You can install this library via npm with:
- vue2:
npm install arcaptcha-vue --save
or via yarn:
- vue2:
yarn add arcaptcha-vue
or via script tag (Vue must be globally available)
- vue2
<script src="https://unpkg.com/vue"></script> <script src="https://unpkg.com/arcaptcha-vue"></script>
Usage
-
Basic:
<template> <arcaptcha-vue site_key="YOUR_SITE_KEY"></arcaptcha-vue> </template> <script> import ArcaptchaVue from 'arcaptcha-vue'; export default { components: { ArcaptchaVue } }; </script> -
Invisible:
<template> <div> <arcaptcha-vue site_key="YOUR_SITE_KEY" :callback="onSuccess" :invisible="true" ref="widget"></arcaptcha-vue> <button @click="execute">load invisible captcha</button> <button @click="reset">reset captcha</button> </div> </template> <script> import ArcaptchaVue from "arcaptcha-vue"; export default { components: { ArcaptchaVue }, methods: { onSuccess(token) { console.log("Captcha Solved! token:", token); }, reset() { this.$refs.widget.reset(); }, execute() { this.$refs.widget.execute(); }, }, }; </script> -
Invisible with promise:
<template> <div> <arcaptcha-vue site_key="YOUR_SITE_KEY" :invisible="true" ref="widget"></arcaptcha-vue> <button @click="execute">load invisible captcha with promise</button> <button @click="reset">reset captcha</button> </div> </template> <script> import ArcaptchaVue from "arcaptcha-vue"; export default { components: { ArcaptchaVue }, methods: { reset() { this.$refs.widget.reset(); }, execute() { this.$refs.widget.execute().then((token)=>{ console.log("Captcha Solved! token:", token); }) }, }, }; </script>
JS API
Props
| Name | Values/Type | Required | Default | Description |
|---|---|---|---|---|
| site_key | String | Yes | - | Your sitekey. Please visit ARCaptcha and sign up to get a sitekey. |
| invisible | Boolean | No | false | This specifies the visibility of the checkbox. To activate arcaptcha in invisible mode set this option to true |
| color | String | No | normal | Color of every colored element in widget and challenge. |
| theme | String | No | light | Theme of widget and challenge.(Available options: light/dark) |
| lang | String | No | fa | Language is used in widget and challenge contents.(Available options : en/fa) |
| callback | Function | NO | null | This function would be called after solving captcha |
| rendered_callback | Function | NO | null | This function would be called after rendering captcha |
| error_callback | Function | NO | null | This function would be called after error |
| reset_callback | Function | NO | null | This function would be called after reseting captcha |
| expired_callback | Function | NO | null | This function would be called after expiring |
| chlexpired_callback | Function | NO | null | This function would be called after challange expiration |
| closed_callback | Function | NO | null | This function would be called after a challenge is closed by user,programmatically or expiration |
Methods
| Method | Description |
|---|---|
execute() |
Programmatically trigger a challenge request |
reset() |
Reset the current challenge |
disableErrorPrint() |
Disable errors printed below the captcha box(You should handle errors yourself by setting error_callback) |
FAQ
How can I get a sitekey?
Sign up at ARCaptcha to get your sitekey. Check documentation for more information.
Demo
To run the demo:
- clone this repo
git clone https://github.com/arcaptcha/arcaptcha-vue.git cd example/yarn && yarn serve- it will start the demo app on localhost:8080
Related Packages
@hcaptcha/vue-hcaptcha
hCaptcha Component Library for Vue.js. Compatible with Vue 2 and 3.
424,724
215
google-recaptcha-vue3
A lightweight Vue 3 component library supporting Google reCAPTCHA v2 and v3 inte...
3,291
1
Version History
| Version | Released | Vue | License |
|---|---|---|---|
| 0.0.13 | ^2.6.14 | MIT | |
| 0.0.12 | ^2.6.14 | MIT | |
| 0.0.11 | ^2.6.14 | MIT | |
| 0.0.10 | ^2.6.14 | MIT | |
| 0.0.9 | ^2.6.14 | MIT | |
| 0.0.8 | ^2.6.14 | MIT | |
| 0.0.7 | ^2.6.14 | MIT | |
| 0.0.6 | ^2.6.14 | MIT | |
| 0.0.5 | ^2.6.14 | MIT | |
| 0.0.4 | ^2.6.14 | MIT | |
| 0.0.3 | ^2.6.14 | ||
| 0.0.2 | ^2.6.14 | ||
| 0.0.1 | ^2.6.14 |