mailtolink

mailtolink.js

Makes mailto: links.

In the browser:

<script src="mailtolink.js"></script>
<script>
// Set the .email-link's href to "mailto:[e-mail]".
var emailLink = document.querySelector('a.email-link');
emailLink.href = mailtoLink('[e-mail]');
</script> 

In a CommonJS environment like Node or Browserify:

var mailtoLink = require('mailtolink');
console.log(mailtoLink('[e-mail]'));

Examples

Generate a link for one email address:

mailtoLink('[e-mail]')
// => mailto:[e-mail]

Generate a link for multiple email addresses:

mailtoLink(['[e-mail]', '[e-mail]'])
// => mailto:[e-mail],[e-mail]

Generate a link with an email and a subject:

mailtoLink('[e-mail]', { subject: '¡Hola!' })
// => mailto:[e-mail]?subject=%C2%A1Hola!

Generate a link with just a subject:

mailtoLink({ subject: '¡Hola!' })
// => mailto:?subject=%C2%A1Hola!

Generate a link with a subject and a body:

mailtoLink({
  subject: 'Check out this photo',
  body: [
    'I thought you might really enjoy this photo of a store I found:',
    '',
    'http://example.com/tienda.jpg',
  ].join('\n')
})
// => mailto:?subject=Check%20out%20this%20photo&body=I%20thought%20you%20might%20really%20enjoy%20this%20photo%20of%20a%20store%20I%20found%3A%0D%0A%0D%0Ahttp%3A%2F%2Fexample.com%2Ftienda.jpg'

Generate a link with an email, a subject, a CC, a body, and some BCCs:

mailtoLink('[e-mail]', {
  subject: 'Hi',
  cc: '[e-mail]',
  bcc: ['[e-mail]', '[e-mail]'],
  body: 'Hope you are doing well.'
})
// => mailto:[e-mail]?subject=Hi&cc=[e-mail]&bcc=[e-mail],[e-mail]&body=Hope%20you%20are%20doing%20well.