HTML_BASIC render-kit
component-family: javax.faces.Command renderer-type: javax.faces.Link

Render an HTML "a" anchor element that acts like a form submit button when clicked.

Decode Behavior

Obtain the "clientId" property of the component. Obtain theMap from the "requestParameterMap" property of theExternalContext. If the Map contains no entry, or an empty String entry, under the key that is the value of the "clientId" property, return immediately. If there is an entry, create a new javax.faces.event.ActionEvent instance around the component and callqueueActionEvent() on the component, passing the event.

Encode Behavior

Render "#" as the value of the "href" attribute. Render javascript that is functionaly equivalent to the following as the value of the "onclick" attribute:

document.forms['CLIENT_ID']['CLIENT_ID'].value='CLIENT_ID'; document.forms['CLIENT_ID']['PARAM1_NAME'].value='PARAM1_VALUE'; document.forms['CLIENT_ID']['PARAM2_NAME'].value='PARAM2_VALUE'; return false;

document.forms['CLIENT_ID'].submit()" where CLIENT_ID is the clientId of the UICommand component, PARAM*_NAME and PARAM*_VALUE are the names and values, respectively, of any nested UIParameter children. The name and the value must be URLEncoded. If the "styleClass" attribute is specified, render its value as the value of the "class" attribute. Render any non-UIParameter children as normal inside of the "a" element. These will appear as the link text. Allow the form renderer to output an "input" element of "type" "hidden" for each of the nested UIParameter children, taking the name property (but not the value) from each one in turn.

This renderer is responsible for rendering its children.

Note:

Attributes with a pass-through value of true are not interpreted by the renderer and are passed straight through to the rendered markup, without checking for validity. Attributes with a pass-through value of false are interpreted by the renderer, and may or may not be checked for validity by the renderer.