link - Link

Opens a URL, a control (anchor link), or another XPage.

Category

Core Controls

Syntax

<xp:link attributes>content</xp:link>
Table 1. Essential properties
Property Description
id Defaults to link1, link2, and so on.
text Provides a label.
value Specifies the target of the link: a URL, a control on the page, or an XPage.
  • URL: value="url"
  • Control: value="##{id:controlId}"
  • XPage: value="/pagename.xsp"
Table 2. All properties
Category Properties
accessibility accesskey, role, tabindex, title
basics attrs, binding, charset, dir, escape, hreflang, htmlFilter, id, lang, loaded, rel, rendered, rendererType, rev, target, text, type
data converter, parameters, value
events onblur, onclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup
format contentType, coords, shape
styling disableTheme, outerStyleClass, style, styleClass, themeId

Usage

At run time, the label appears on the page as hot text. The user can click the label to open the URL.

The role property defaults to link which renders this control as an anchor element. If the control does not change focus, for example, simply performs an action, consider changing role to button.

Examples

This Link control opens a URL.
<xp:link escape="true" id="link1"
	value="http://www.google.com" text="Google" title="Open Google">
</xp:link>
This Link control opens a control.
<xp:link escape="true" id="link2" value="##{id:inputText1}"	text="Subject"></xp:link>
This Link control opens an XPage.
<xp:link escape="true" id="link3" value="/xpage1.xsp" text="Page 1"></xp:link>