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).

Navigation Usage

The component can be used to navigate between pages with the outcome attribute. Setting includeViewParams=true will automatically include all of the f:viewParam tags (view parameters) as URL parameters.
foo=

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">

	<!-- Navigation based on outcome of navigation-case defined in navigation-rule.xml -->
	<h:link outcome="toParam">
		<h:outputText value="#{i18n['to-param-page']} >" />
	</h:link>
	<h:outputText id="parameterValue" value="foo=#{facesContext.externalContext.requestParameterMap['foo']}" />

</ui:composition>
<?xml version="1.0"?>

<faces-config xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.2" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-facesconfig_2_2.xsd">
	<navigation-rule>
		<from-view-id>/views/component.xhtml</from-view-id>
		<navigation-case>
			<from-outcome>toParam</from-outcome>
			<to-view-id>/views/component.xhtml</to-view-id>
			<redirect>
				<view-param>
					<name>componentPrefix</name>
					<value>#{showcaseModelBean.selectedComponent.prefix}</value>
				</view-param>
				<view-param>
					<name>componentName</name>
					<value>#{showcaseModelBean.selectedComponent.lowerCaseName}</value>
				</view-param>
				<view-param>
					<name>componentUseCase</name>
					<value>param</value>
				</view-param>
			</redirect>
		</navigation-case>
	</navigation-rule>
</faces-config>
Liferay Faces Bridge Implementation 5.0.0 + Showcase Common 3.1.1 + Liferay Faces Util 3.4.1 + Mojarra 2.2.20