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.


  #link { text="Example Hyperlink", url="" },
   #link { text="Example Postback Link", postback=link_clicked }
   #link { body=#image { image="path/to/image.gif" }, postback=link_clicked}


  • 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.

  • image (string) - The path to an image to display as the body. Largely a shortcut for making icon links. Serves as a shortcut for the following:

         #link{url="/edit" body=[
  • 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.

  • click (Action/ or /List of Actions) - Wires the selected actons to the "click" events. Due to the commonality of binding actions to the click event, this is merely a shortcut for

         #link{ text="Do Something", actions=[
  • postback (Erlang term) - If set, clicking on the link will cause a Nitrogen postback with the supplied term.

  • mobile_target (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.

  • mobile_dialog (Boolean) - If set to true, this will work with jQuery mobile to load the target URL in a jQuery Mobile Dialog.

See Also

View Source or Submit Corrections for this Documentation Page
Copyright © 2008-2024 Nitrogen Web Framework. Released under the MIT License.