link - Link

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


Core Controls


<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


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.


This Link control opens a URL.
<xp:link escape="true" id="link1"
	value="" text="Google" title="Open Google">
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>