# Link Element Element

Getting Started | API | Elements | Actions | Validators | Handlers | Configuration Options | About

## Table of Contents

- 1 Link Element - #link{}

## 1 Link Element - #link{}

The link element produces a clickable hyperlink. Depending on its settings, the link can either function as a normal client-side hyperlink, or can cause a Nitrogen postback.

### Usage

    #link { text="Example Hyperlink", url="http://nitrogenproject.com" },

    #link { text="Example Postback Link", postback=link_clicked }

    #link { body=#image { image="path/to/image.gif" }, postback=link_clicked}

### Attributes

text - (string)
  The text to display.
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.
url - (string)
  If set, clicking on the link will navigate to this URL.
new - (boolean)
  Set to true to make link open in a new window.
postback - (Erlang term)
  If set, clicking on the link will cause a Nitrogen postback with the supplied term.
mobiletarget - (Boolean)
  If set to false, this will work with jQuery Mobile to ensure that it skips using jQuery Mobile's automatic page transition loading system.
mobiledialog - (Boolean)
  If set to true, this will work with jQuery mobile to load the target URL in a jQuery Mobile Dialog.

### See Also

- base element
- button element
- jQuery Mobile Integration Guide

Date: 2012-10-18 03:25:13 CDT

Author: Rusty Klophaus (@rustyio)

Org version 7.8.02 with Emacs version 23

Validate XHTML 1.0

## Comments

Note:To specify code blocks, just use the generic code block syntax:

    <pre><code>your code here</code></pre>

comments powered by Disqus