0.2.12 • Published 6 months ago

arcaptcha-react v0.2.12

Weekly downloads
-
License
-
Repository
-
Last release
6 months ago

React Arcaptcha Component Library

Description

Arcaptcha Component Library for ReactJS.

Arcaptcha is a drop-replacement for reCAPTCHA and hCaptcha that protects user privacy, rewards websites, and helps companies get their data labeled.

Sign up at Arcaptcha to get your sitekey today. You need a sitekey to use this library.

Installation

You can install this library via npm with:

  npm i arcaptcha-react

Usage

The requirement for usage are the site-key prop. The component will automatically include and load the Arcaptcha API library and append it to the body.

  • Basic:
import React from "react";
import { ArcaptchaWidget } from "arcaptcha-react";

class YOUR_COMPONENT_NAME extends Component {
  constructor() {
    super();
    this.ArRef = React.createRef();
  }
  getToken = (token) => {
    //do something with your token.
  };
  render() {
    return (
      <div>
        <ArcaptchaWidget
          ref={this.ArRef}
          site-key="YOUR_SITE_KEY"
          callback={this.getToken}
          theme="dark" //it's not required. Default is light
          lang="en" //it's not required. Default is fa
        />
      </div>
    );
  }
}
  • Invisible:
import React from "react";
import { ArcaptchaWidget } from "arcaptcha-react";

class ArcaptchaReact extends React.Component {
  constructor() {
    super();
    this.ArRef = React.createRef();
  }
  onSuccess = (token) => {
    //do something with your token.
  };
  execute = () => {
    this.ArRef.current.execute();
  };
  reset = () => {
    this.ArRef.current.resetCaptcha();
  };
  render() {
    return (
      <div>
        <ArcaptchaWidget
          ref={this.ArRef}
          site-key="YOUR_SITE_KEY"
          callback={this.onSuccess}
          invisible={true}
        />
        <button type="button" onClick={this.execute}>
          execute
        </button>
        <button type="button" onClick={this.reset}>
          reset
        </button>
      </div>
    );
  }
}
export default ArcaptchaReact;
  • Invisible with promise:
import React from "react";
import { ArcaptchaWidget } from "arcaptcha-react";

class ArcaptchaReact extends React.Component {
  constructor() {
    super();
    this.ArRef = React.createRef();
  }
  execute = () => {
    this.ArRef.current.execute().then((token) => {
      console.log(token);
    });
  };
  reset = () => {
    this.ArRef.current.resetCaptcha();
  };
  render() {
    return (
      <div>
        <ArcaptchaWidget
          ref={this.ArRef}
          site-key="YOUR_SITE_KEY"
          invisible={true}
        />
        <button type="button" onClick={this.execute}>
          execute
        </button>
        <button type="button" onClick={this.reset}>
          reset
        </button>
      </div>
    );
  }
}
export default ArcaptchaReact;

Props

NameValues/TypeRequiredDefaultDescription
site-keystringYes-This is your sitekey, this allows you to load captcha. If you need a sitekey, please visit Arcaptcha, and sign up to get your sitekey
domainstringNOwindow.location.hostnameWhenever there is no access to window (Mobile enviroments) you can set domain manually
invisibleBooleanNOFalseThis allows you to use invisible captcha for you forms
langstringNOfaThis allows you to choose language by this prop. you can choose 'en' or 'fa' for english and persion language
themestringNOlightThis allows you to choose theme for your widget. The themes are light and dark
colorStringNonormalColor of every colored element in widget and challenge.
api_urlStringNohttps://widget.arcaptcha.ir/1/api.jsThis allows you to change default widget api.
callbackFunctionNOnullThis function would be called after solving captcha
rendered_callbackFunctionNOnullThis function would be called after rendering checkbox
closed_callbackFunctionNOnullThis function would be called after closing captcha challenge
opened_callbackFunctionNOnullThis function would be called after opening captcha challenge
error_callbackFunctionNOnullThis function would be called after error
reset_callbackFunctionNOnullThis function would be called after reseting captcha
expired_callbackFunctionNOnullThis function would be called after expiring
chlexpired_callbackFunctionNOnullThis function would be called after challange expiration

Methods

MethodDescription
execute()Programmatically trigger a challenge request. You can use this, to load invisible captcha after trigger a button
close()Programmatically trigger a close challenge request. You can use this to close challenge container
resetCaptcha()Reset the current challenge
0.2.12

6 months ago

0.2.11

10 months ago

0.2.10

1 year ago

0.2.9

1 year ago

0.2.8

2 years ago

0.2.7

3 years ago

0.2.6

3 years ago

0.2.5

3 years ago

0.2.1

3 years ago

0.2.3

3 years ago

0.2.2

3 years ago

0.2.4

3 years ago

0.1.15

3 years ago

0.2.0

3 years ago

0.1.16

3 years ago

0.1.17

3 years ago

0.1.18

3 years ago

0.1.10

3 years ago

0.1.11

3 years ago

0.1.12

3 years ago

0.1.13

3 years ago

0.1.14

3 years ago

0.1.8

3 years ago

0.1.7

3 years ago

0.1.9

3 years ago

0.1.6

3 years ago

0.1.5

3 years ago

0.1.4

3 years ago

0.1.3

3 years ago

0.1.2

3 years ago

0.1.1

3 years ago

0.1.0

3 years ago