react-recaptcha
A react.js reCAPTCHA for Google. The FREE anti-abuse service. Easy to add, advanced security, accessible to wide range of users and platforms.
What is reCAPTCHA?
reCAPTCHA is a free service that protects your site from spam and abuse. It uses advanced risk analysis engine to tell humans and bots apart. With the new API, a significant number of your valid human users will pass the reCAPTCHA challenge without having to solve a CAPTCHA (See blog for more details). reCAPTCHA comes in the form of a widget that you can easily add to your blog, forum, registration form, etc.
See the details.
Sign up for an API key pair
To use reCAPTCHA, you need to sign up for an API key pair for your site. The key pair consists of a site key and secret. The site key is used to display the widget on your site. The secret authorizes communication between your application backend and the reCAPTCHA server to verify the user's response. The secret needs to be kept safe for security purposes.
Installation
Install package via node.js
$ npm install --save react-recaptcha
Usage
You can see the full example by follwing steps.
$ npm install
$ npm start
open the http://localhost:3000
in your browser.
Automatically render the reCAPTCHA widget
Html example code:
<html>
<head>
<title>reCAPTCHA demo: Simple page</title>
<script src="build/react.js"></script>
<script src="https://www.google.com/recaptcha/api.js" async defer></script>
</head>
<body>
<div id="example"></div>
<script src="build/index.js"></script>
</body>
</html>
Jsx example code: build/index.js
var Recaptcha = require('react-recaptcha');
ReactDOM.render(
<Recaptcha
sitekey="xxxxxxxxxxxxxxxxxxxx"
/>,
document.getElementById('example')
);
Explicitly render the reCAPTCHA widget
Deferring the render can be achieved by specifying your onload callback function and adding parameters to the JavaScript resource.
<html>
<head>
<title>reCAPTCHA demo: Simple page</title>
<script src="build/react.js"></script>
<script src="https://www.google.com/recaptcha/api.js?onload=onloadCallback&render=explicit" async defer></script>
</head>
<body>
<div id="example"></div>
<script src="build/index.js"></script>
</body>
</html>
Jsx example code: build/index.js
var Recaptcha = require('react-recaptcha');
// specifying your onload callback function
var callback = function () {
console.log('Done!!!!');
};
ReactDOM.render(
<Recaptcha
sitekey="xxxxxxxxxxxxxxxxxxxx"
render="explicit"
onloadCallback={callback}
/>,
document.getElementById('example')
);
Define verify Callback function
var Recaptcha = require('react-recaptcha');
// specifying your onload callback function
var callback = function () {
console.log('Done!!!!');
};
// specifying verify callback function
var verifyCallback = function (response) {
console.log(response);
};
ReactDOM.render(
<Recaptcha
sitekey="xxxxxxxxxxxxxxxxxxxx"
render="explicit"
verifyCallback={verifyCallback}
onloadCallback={callback}
/>,
document.getElementById('example')
);
Change the color theme of the widget. Please theme
property light|dark
. Default value is light
.
ReactDOM.render(
<Recaptcha
sitekey="xxxxxxxxxxxxxxxxxxxx"
theme="dark"
/>,
document.getElementById('example')
);
Change the type of CAPTCHA to serve. Please type
property audio|image
. Default value is image
.
ReactDOM.render(
<Recaptcha
sitekey="xxxxxxxxxxxxxxxxxxxx"
type="audio"
/>,
document.getElementById('example')
);
Explicitly reset the reCAPTCHA widget
The reCAPTCHA widget can be manually reset by accessing the component instance via a callback ref and calling .reset()
on the instance.
var Recaptcha = require('react-recaptcha');
// create a variable to store the component instance
let recaptchaInstance;
// create a reset function
const resetRecaptcha = () => {
recaptchaInstance.reset();
};
ReactDOM.render(
<div>
<Recaptcha
ref={e => recaptchaInstance = e}
sitekey="xxxxxxxxxxxxxxxxxxxx"
/>
<button
onClick={resetRecaptcha}
>
Reset
</button>
</div>,
document.getElementById('example')
);
Contributing
-
- Fork it
-
- Create your feature branch (git checkout -b my-new-feature)
-
- Commit your changes (git commit -am 'Add some feature')
-
- Push to the branch (git push origin my-new-feature)
-
- Create new Pull Request