Note

  • h:link is intended to be used to render a hyperlink that navigates to other JSF views via HTTP GET, or perhaps to re-render the same view with different view parameters via f:param child tags.
  • h:outputLink is intended to be used to render a simple <a href="...">hyperlink</a> that requests a URL via HTTP GET.

h:link

HtmlLink is a UIOutcomeTarget component that renders an <a> element (hyperlink).

General Usage

The text/content of the hyperlink can be specified via the value of the component or by specifying child components. Setting includeViewParams=true will automatically include all of the f:viewParam tags (view parameters) as URL parameters.
Text for a link
Text for a link

Source Code

<ui:composition xmlns="http://www.w3.org/1999/xhtml" xmlns:h="http://xmlns.jcp.org/jsf/html"
	xmlns:ui="http://xmlns.jcp.org/jsf/facelets">

	<!-- Example 1: Styling via children -->
	<h:form>
		<h:link includeViewParams="true" >
			<h:outputText value=" #{i18n['text-for-a-link']} " />
			<h:graphicImage value="#{resource['images:jsf-logo-small.png']}" />
		</h:link>
	</h:form>

	<!-- Example 2: Styling via value attribute -->
	<h:form>
		<h:link includeViewParams="true" value=" #{i18n['text-for-a-link']} " />
	</h:form>

</ui:composition>
Liferay Faces Bridge Implementation 5.0.0 + Showcase Common 3.1.1 + Liferay Faces Util 3.4.1 + Mojarra 2.2.20