Angular Google reCAPTCHA

Google's reCAPTCHA is an awesome, UX-friendly way of ensuring that the users who are submitting your forms are actually humans.

Angular has fantastic built in forms functionality which makes it easy to write powerful custom components and validation logic.

This library makes it effortless to combine them!

If you ever need to reference the full reCAPTCHA docs you can find them here: reCAPTCHA docs

Installation

Head over to the command line and use your favourite package manager to install and save it as a dependency:

E.g.

``bash
npm install --save angular-google-recaptcha
`

or

`bash
yarn add angular-google-recaptcha
`

Usage

$3

Head over to:

https://www.google.com/recaptcha/admin#list

...and register your site.

Once you have done that, a "site key" will have been generated for you. You need to find this and copy it to you clipboard as it will be important in the next step!

$3

E.g.

`ts
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { ReactiveFormsModule } from '@angular/forms';
import { RecaptchaModule } from 'angular-google-recaptcha';

@NgModule({
imports: [
BrowserModule,
ReactiveFormsModule,
RecaptchaModule.forRoot({
siteKey: 'YOUR_SITE_KEY_HERE',
}),
],
bootstrap: [AppComponent]
})
export class AppModule { }
`

As you might expect, you need to be using the @angular/forms package (either the FormsModule or ReactiveFormsModule) within your project, otherwise this library will have nothing to hook into.

$3

E.g. For reactive forms

`ts
import { Component } from '@angular/core';
import { FormControl } from '@angular/forms';

@Component({
selector: 'app',
template:
[formControl]="myRecaptcha"
(scriptLoad)="onScriptLoad()"
(scriptError)="onScriptError()"
>

})
export class AppComponent {
myRecaptcha = new FormControl(false);

onScriptLoad() {
console.log('Google reCAPTCHA loaded and is ready for use!')
}

onScriptError() {
console.log('Something went long when loading the Google reCAPTCHA')
}
}
`

E.g. For template-driven forms

`ts
import { Component } from '@angular/core';

@Component({
selector: 'app',
template:
[(ngModel)]="myRecaptcha"
(scriptLoad)="onScriptLoad()"
(scriptError)="onScriptError()"
>

})
export class AppComponent {
myRecaptcha: boolean

onScriptLoad() {
console.log('Google reCAPTCHA loaded and is ready for use!')
}

onScriptError() {
console.log('Something went long when loading the Google reCAPTCHA')
}
}
``