mailto
Attribute Name
Type
Required
Default
Description
address
string
Yes
n/a
the e-mail address
text
string
No
n/a
the text to display, default is the e-mail address
encode
string
No
none
How to encode the e-mail. Can be one of none,
hex, javascript
or javascript_charcode.
cc
string
No
n/a
e-mail addresses to carbon copy. Separate entries by a comma.
bcc
string
No
n/a
e-mail addresses to blind carbon copy.
Separate entries by a comma.
subject
string
No
n/a
e-mail subject.
newsgroups
string
No
n/a
newsgroups to post to. Separate entries by a comma.
followupto
string
No
n/a
addresses to follow up to. Separate entries by a comma.
extra
string
No
n/a
any extra information you want passed to the link, such
as style sheet classes
mailto automates the creation of mailto links and optionally
encodes them. Encoding e-mails makes it more difficult for
web spiders to pick up e-mail addresses off of your site.
Technical Note
javascript is probably the most thorough form of
encoding, although you can use hex encoding too.
mailto
{mailto address="me@example.com"}
{mailto address="me@example.com" text="send me some mail"}
{mailto address="me@example.com" encode="javascript"}
{mailto address="me@example.com" encode="hex"}
{mailto address="me@example.com" subject="Hello to you!"}
{mailto address="me@example.com" cc="you@example.com,they@example.com"}
{mailto address="me@example.com" extra='class="email"'}
{mailto address="me@example.com" encode="javascript_charcode"}
OUTPUT:
<a href="mailto:me@example.com" >me@example.com</a>
<a href="mailto:me@example.com" >send me some mail</a>
<script type="text/javascript" language="javascript">eval(unescape('%64%6f%63%75%6d%65%6e%74%2e%77%72%6
9%74%65%28%27%3c%61%20%68%72%65%66%3d%22%6d%61%69%6c%74%6f%3a%6d%65%40%64%6f%6d%
61%69%6e%2e%63%6f%6d%22%20%3e%6d%65%40%64%6f%6d%61%69%6e%2e%63%6f%6d%3c%2f%61%3e
%27%29%3b'))</script>
<a href="mailto:%6d%65@%64%6f%6d%61%69%6e.%63%6f%6d" >me@domain.com</a>
<a href="mailto:me@example.com?subject=Hello%20to%20you%21" >me@example.com</a>
<a href="mailto:me@example.com?cc=you@example.com%2Cthey@example.com" >me@example.com</a>
<a href="mailto:me@example.com" class="email">me@example.com</a>
<script type="text/javascript" language="javascript">
<!--
{document.write(String.fromCharCode(60,97,32,104,114,101,102,61,34,109,97,105,108,116,111,58,109,101,64,101,120,97,109,112,108,101,46,99,111,109,34,32,62,109,101,64,101,120,97,109,112,108,101,46,99,111,109,60,47,97,62))}
//-->
</script>