---
name: "Jifty::Web::Form::Link"
section: "3pm"
platform: "linux"
package: "libjifty-perl"
version: "1.10518+dfsg-2"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/Jifty::Web::Form::Link"
---

# Jifty::Web::Form::Link(3pm)

Creates a state-preserving HTML link

## NAME

Jifty::Web::Form::Link - Creates a state-preserving HTML link

## DESCRIPTION

Describes an HTML link that may be AJAX-enabled.  Most of the computation of this comes from Jifty::Web::Form::Clickable, which generates Jifty::Web::Form::Links.

### accessors

Link adds `"url"` and `"escape_label"` to the list of possible accessors and mutators, in addition to those offered by "accessors" in Jifty::Web::Form::Element.

### new PARAMHASH

Creates a new Jifty::Web::Form::Link object.  Possible arguments to the `"PARAMHASH"` are:

- url (optional)

  The URL of the link; defaults to the current URL.

- tooltip

  Additional information about the link.

- target

  Target of the link.  Mostly useful when specified as "\_blank" to open a new window or as the name of a already existing window.

- escape\_label

  HTML escape the label and tooltip? Defaults to true

- anything from Jifty::Web::Form::Element

  Any parameter which "new" in Jifty::Web::Form::Element can take.

### url \[URL\]

Gets or sets the URL that the link links to.

### as\_string

Returns the string of the link, including any necessary javascript.

### render

Render the string of the link, including any necessary javascript.