Create a signature pad in React
Tags: react, javascript, webdev, hooks
Published: 2019-09-06 15:39:39

---
title: Create a signature pad in React
published: true
description: Learn how to build a signature pad for your forms in React
cover_image: 
tags: React, Javascript, webdev, Hooks
---

I was recently asked by a client to build a form that allows users to sign using a wireless pen mouse. The goal of the client was to obtain user signatures for a report that would be used for a future audit. 

At first I was considering building my own signature pad from scratch. However, I didn't have the time to do that. This feature needed to be live in a week. This unfortunately is the reality when working in real life situations. This is why I wanted to write about this specific case. You won't always have the time to build every single feature in an app from scratch. Sometimes you have to rely on libraries created by other developers. This article will help beginners see how you can combine different libraries to create a working product. 

OK let start building the signature pad. First I wrote a [user story](https://en.wikipedia.org/wiki/User_story). Below is the user story for what we will be building: 

* User sees a button that can be clicked to open a popup
* User can see and draw on a canvas when the popup is opened
* User has the option to exit popup via an 'Close' button, clear the canvas via a 'Clear' button, or save the signature as an image via the 'Save' button.

Now that we know what we are building lets start coding it. We can use the user story list items as our milestones.

##  User sees a button that can be clicked to open a popup

I will use React for this task, so lets bootstrap the project by using create-react-app. 

To do that all we need to do is type the following command on our terminal:

```
npx create-react-app signature-pad
```

For more information on create-react-app check out this [Github Repo](https://github.com/facebook/create-react-app)

Once our project is ready, we navigate into our folder and start up our code editor. In my case I am using [VS Code](https://code.visualstudio.com/).


```
# navigate to the project folder in your terminal
cd signature-pad

# command to start VS Code once you are in root folder of the project
code .
```

Now that we have everything set lets start up our project by typing the following command:

```
# start project
npm start
```

This is what we should see once the project starts:

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/9qgyxthglqithu46vk07.PNG)

If you open up your `App.js` file this is what we should see:

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/125kinoret8n7cm5qprq.png)

Lets get rid of all this code and add the one thing we need. A button that when clicked should open up a popup with a signature pad, per our user story.

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/bkhrlzhv2uqxbztz5ecq.png)

This is what our app should look like now:

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/kghmxxybim76464v6u5v.PNG)

Our final step for this part of the project is to show a popup when the button is clicked. A good library that can help with this is reactjs-popup. To install it we type

```
npm install --save reactjs-popup
```

This library can be used to create Popup Models, Tool-tips, and Nested Menus. In our case we will focus on using it to create Popup Models. For more information on it check out their very helpful [documentation page](https://react-popup.elazizi.com/introduction/)

Once we have the library installed we import it into our `App.js` file. Next we add the `Popup` component to our render method. This component takes in many props. In our case we focus on two: modal props (by default this is false which results in getting a tool-tip) and the trigger props which takes in a component that will trigger the popup. In our case this is our button that we already created. 

Now when we click on the button we should get a popup. the content of the popup will go inside our `Popup` component.

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/ial8f4lv376vijo124mi.png)

This is what we should have now:

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/7sx7ga2jbl0eaitt37os.gif)

We have successfully completed the first part of our User story. Now lets more to the next one!

## User can see and draw on a canvas when the popup is opened

To build the canvas inside our popup we will be using react-signature-canvas. This is a powerful library that will make working with a signature pad very easy. Specifically when we start thinking about adding features such as clear and save to our pad. 

To install it we type:

```
npm install --save react-signature-canvas
```

Once we have that installed we import the `SignatureCanvas` component and place it inside our `Popup` component. That is all!

We now have a canvas inside our popup. This is what the code looks like:

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/65frxbbm7raxop89z6ot.png)

and this is what our app should be showing:

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/cpbqvuw29g34ty2u1ycu.gif)

Before we move to the next item in the user story lets add some styling to our canvas. All I will do is give give our canvas a border in order for us to easily identify it and give it a width and height. 

the `SignaturePad` component has a prop called `canvasProps` which allows us to pass attributes to the canvas. In this case I will give the canvas a class called  "signatureCanvas".

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/nzvenjmpm0a84mat838n.png)

You probably noticed that I am also importing a css file called `sigCanvas.css`. This is where I will put all my canvas related styles. 

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/5a4poqag5qzd34fnvzqb.png)

The result should look like this:

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/j8dioinywl970demx660.gif)

OK ready for our final step.

## User has the option to exit popup via an 'Close' button, clear the canvas via a 'Clear' button, or save the signature as an image via the 'Save' button.

lets start with the close button. lets add a button with an onClick, inside that onClick will be a way to close the popup. The `reactjs-popup` docs recommend providing a function as a child to the `Popup` component. this function has a parameter `close` that will handle our close event and will return the components that we want inside the popup.

In addition we should not allow users to close the popup except via this button. To do that we need to pass the `closeOnDocumentClick` prop and pass it a true value. 

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/tlar1rs5gmy3xps7txte.png)

This is what our app looks like now:

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/i1itxvv3vx2kdjal67ay.gif)

Next we need a button to clear the canvas. `react-signature-canvas` provides several methods that help with manipulating our canvas. In order to use this method we need to get an instant of our canvas. This can be done via React refs.

Let use React Hooks for this. First we create a ref called `sigCanvas` using `useRef` hook, the initial value is an empty object. Next we pass this into a `SignaturePad` component using a prop called ref. finally we create a function called `clear` that will be called anytime the clear button is clicked. 

inside the clear function, we simply invoke the method `clear()` via our canvas ref `sigCanvas`. I realize these are a lot of steps, so I wrote comments in the code shown below:

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/oev6dgxn8va6p116yje2.png)

This is what our app should look like now:

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/k16uhqdcwbo8buw3mz1j.gif)

Now for the final button, the save button. This button should simply output a base64 string representing the image. You can use this to store it in a database or instead you can upload the image into your server. In our case we won't be connecting to any servers, so we will simply log the base64 code to the console.

`react-signature-canvas` has a method called `getTrimmedCanvas()` that can trim the white space from the canvas (to optimize the image) and give back a base64 string representing the image. All this via our `sigCanvas` ref.

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/r13v0e309kyu2gudvz4n.png)

This is what our app should look like now:

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/kipqi1bf7xpo1jjzsdle.gif)

Alright! all basic functionalities are complete!

I do want to add one more part to this project. Lets output the saved signature on our screen instead of just logging it. 

We can simply add an image tag below our popup button and pass it our image URL. Of course this image URL will be what we logged into the console, so instead of doing that we can store it in state. 

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/khhpy6z4oi946k92ak2z.png)

This should be the result: 

![Alt Text](https://thepracticaldev.s3.amazonaws.com/i/6kacvb3k8u2v164inrop.gif)

That's all folks! we successfully completed our user story. Of course there is room to improve but all the basic functionalities are there. 

You can play around with the code and add more features to it by following the [link](https://codesandbox.io/s/react-signature-canvas-example-xevhz)

Got questions? Feel free to reach out via the comments or [my twitter](https://twitter.com/maheralkendi)

Ok! Now back to learning 👨🏿‍💻