# vim: sw=3 ts=3 ft=org

#+TITLE: Link Element Element
#+STYLE: <LINK href='../stylesheet.css' rel='stylesheet' type='text/css' />
#+AUTHOR: Rusty Klophaus (@rustyio)
#+OPTIONS:   H:2 num:1 toc:1 \n:nil @:t ::t |:t ^:t -:t f:t *:t <:t
#+EMAIL: 
#+TEXT: [[file:../index.org][Getting Started]] | [[file:../api.org][API]] | [[file:../elements.org][*Elements*]] | [[file:../actions.org][Actions]] | [[file:../validators.org][Validators]] | [[file:../handlers.org][Handlers]] | [[file:../config.org][Configuration Options]] | [[file:../about.org][About]]

* Email Link Element - #email_link{}

  The link element produces a clickable email link.
** Usage

#+BEGIN_SRC erlang
  #email_link { email="joe@mycompany.com" },
#+END_SRC

#+BEGIN_SRC erlang
   #email_link { email="samantha@yourcompany.com", text="Click to Mail me" }
#+END_SRC

#+BEGIN_SRC erlang
   #email_link { email="support@somecompany.com", body=#image { image="path/to/email_support.gif" } }
#+END_SRC

** Attributes

   + email - (/string/) :: The email address to mail to.

   + text - (/string/) :: The text to display.  If none is specified, will default to the email address provided.

   + body - (/Nitrogen elements/) :: Instead of text, specify one or more Nitrogen elements (such as an #image) to wrap in a link.

   + html\_encode - (/boolean/) :: Set to true to safely html-encode the link's title.

** See Also

   + [[./base.html][base element]]

   + [[./link.html][link element]]

 
