Create new RichFaces Documentation Jira issue
This will launch the RichFaces Jira page - to complete your feedback please login if needed, and submit the Jira.
JBoss.orgCommunity Documentation
The <a4j:htmlCommandLink> component is very similar to the same component from the JSF HTML library, the only slight difference is in links generation and problem solving that occurs when an original component is used.
The difference with the original component is that all hidden fields required for command links with the child <f:param> elements are always rendered and it doesn't depend on links rendering on the initial page. It solves the problem with invalid links that weren't rendered on a page immediately, but after some Ajax request.
Example:
<a4j:form>
...
<a4j:htmlComandLink action="action" value="link" rendered="#{bean.rendered}">
<f:param .../>
<a4j:htmlComandLink>
...
</a4j:form>
In this example <a4j:htmlCommandLink> works as standard <h:commandLink> , but here hidden fields required for correct functionality are rendered before the first downloading of a page, though it doesn't happen if its attribute isn't set to "false".
Table of <a4j:htmlCommandLink> attributes.
Table 6.28. Component Identification Parameters
| Name | Value |
|---|---|
| component-type | javax.faces.HtmlCommandLink |
| component-family | javax.faces.Command |
| component-class | javax.faces.component.html.HtmlCommandLink |
| renderer-type | org.ajax4jsf.HtmlCommandLinkRenderer |
On RichFaces LiveDemo page you can found some additional information for <a4j:htmlCommandLink> component usage.
On RichFaces LiveDemo page you can found some additional information about <f:param> component.