bbonch / vue3-recaptcha2

Vue v3 component for Google reCAPTCHA v2
38 stars 9 forks source link

vue3-recaptcha2

Vue v3 component for Google reCAPTCHA v2

## Installation ``` bash npm install vue3-recaptcha2 ``` ## Example usage ### With bundlers ``` vue ``` ### With CDN ``` html
``` ## API ## ### Props ### - sitekey (required) Your sitekey - size (optional) The size of the widget - theme (optional) The color theme of the widget - hl (optional) Forces the widget to render in a specific language. Auto-detects the user's language if unspecified. - loading-timeout (optional) Milliseconds to wait for widget to load before triggering a timeout error. Defaults to 0 (i.e. never timeout). ### Methods ### - reset Resets the reCAPTCHA widget - execute Programmatically invoke the challenge ### Events ### - verify(response) The name of your callback function, executed when the user submits a successful response. The g-recaptcha-response token is passed to your callback - expire The name of your callback function, executed when the reCAPTCHA response expires and the user needs to re-verify - fail The name of your callback function, executed when reCAPTCHA encounters an error (usually network connectivity) and cannot continue until connectivity is restored. If you specify a function here, you are responsible for informing the user that they should retry - error The name of your callback function, executed when reCAPTCHA fails to load. If you specify a function here, you are responsible for either reloading (e.g. by unmounting / re-mounting the component) or notifying the user that they should reload / retry