Skip to content

Hyperlink

Hyperlink displays a template-based link. Text supplies its visible literal/template content, and Url supplies the target as literal/template content. When Url is omitted, the widget uses the current node value ({{.}}).

The widget does not write a changed value back to the form data. Absolute HTTP URLs, root-relative URLs, and links shown in monitoring mode open in a new tab; other link types use the current target. If the evaluated URL is empty, the rendered text has no href.

Only configure URLs from trusted data or validate them before they enter the form data. Do not use template content to introduce unvalidated navigation targets.

XML Fields

  • XPath establishes the current data context. When Url is empty, its value is also used as the link target.
  • Text/Content supplies the visible text. It may be literal text or a data template evaluated in the widget's current context.
  • Url supplies the target as literal or template content. Use {{.}} to make the current value explicit.
  • Hints provides help text and Rules contains form rules. Neither field changes where the link navigates.

Hyperlink is display-only: selecting it never writes a value back through XPath.

Example

1
2
3
4
5
6
<Hyperlink XPath="Documents/PortalUrl">
    <Text><Content><![CDATA[Open customer portal]]></Content></Text>
    <Url><![CDATA[{{.}}]]></Url>
    <Hints><![CDATA[]]></Hints>
    <Rules />
</Hyperlink>