Skip to content

Latest commit

 

History

History
108 lines (73 loc) · 5.28 KB

README.md

File metadata and controls

108 lines (73 loc) · 5.28 KB

react-copy-mailto

All Contributors

npm version npm version npm bundle size

A fully customizable React component for copying email from mailto links.

Motivation

The one thing we can all agree on is that we hate it when the default mail app pops up after clicking on the mailto link. Most of the time we just want to copy the email address and that's where this module comes into play. Big shout out to Kuldar whose tweet thread inspired us to build this.

Demo

here

Try it yourself!

Installation and Usage

The easiest way to use this library is to install it via yarn or npm

yarn add react-copy-mailto

or

npm install react-copy-mailto

Then just use it in your app:

import React from "react";
import CopyMailTo from "react-copy-mailto";

const YourComponent = () => (
    <div>
        <CopyMailTo email="[email protected]" />
    </div>
);

Props

You can customize almost every aspect of this component using the below props, out of which email is the only required prop.

Name Type Default Description
email string none The email to be copied.
theme string dark Use "light" for light background.
children ReactNode null Use this if you want to use some custom component inside the anchor tag.
defaultTooltip string "Copy email address" Text shown in the tooltip when the user hovers over the link.
copiedTooltip string "Copied to clipboard!" Text shown in the tooltip when the user clicks on the link and the text is copied to clipboard.
containerStyles style object none The styles to be applied to the container.
tooltipStyles style object none The styles to be applied to the tooltip.
anchorStyles style object none The styles to be applied to the anchor.

Development

  • Install the dependencies
yarn install
  • Run the example on the development server
yarn demo:dev

Contributing

GitHub issues GitHub pull requests

Feel free to open issues and pull requests!

License

NPM

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Prateek Surana

💻 🎨 🖋 📖

Ankit Raj

🔧 💻

Binu kumar

💻

Shravan Dhar

💻

This project follows the all-contributors specification. Contributions of any kind are welcome!