Documentation

Search 

Contents

  1. Introduction
  2. Getting Started
  3. Trinidad Concepts
  4. Code View Support
  5. Design View Support
  6. Tag Object Toolbars
  7. Server Behaviors
  8. Property Inspectors
Selected 9. Trinidad Tag Reference

10. Trinidad Core Tag Reference

Contents > Trinidad Core Tag Reference > tr:commandNavigationItem

tr:commandNavigationItem

The tr:commandNavigationItem tag produces a component (button, link, option) which can be used to navigate.

Example

<tr:navigationPane hint="tabs">
  <tr:commandNavigationItem text="Welcome" selected="#{true}" />
  <tr:commandNavigationItem text="Hello" />
  <tr:commandNavigationItem text="Goodbye" />  
</tr:navigationPane>

Rendered Output

Rendered tr:commandNavigationItem tag

Tag Attributes

accessKey Text
 
The accessKey attribute sets one character from the text on the component to use as a quick access key.
action Text
 
The action attribute accepts a method-binding expression for a backing bean action method to invoke when this component is activated by the user. An action method must be a public method with no parameters that returns a String. The returned string represents the logical outcome of the action (eg. "success", "failure", etc.) and is used by the JavaServer Faces MVC framework to determine which view to display next.
actionListener Text
 
The actionListener attribute accepts a method-binding expression for a backing bean action listener method that will be notified when this component is activated by the user. An action listener method must be a public method with an javax.faces.event.ActionEvent parameter and a void return type.
attributeChangeListener Text
 
The attributeChangeListener attribute contains the reference to a method that is invoked when the renderer changes a property without the application’s request.
binding Expression
 
The value-binding expression linking this component tag to a backing bean property.
destination Text
 
The destination attribute is used instead of the action attribute to set the URI that is activated from the component.
disabled Boolean
 
The disabled attribute is a boolean flag that when set to true indicates that this component should not receive focus or be included in a form submit.
icon Text
 
The icon attribute sets the URL of an image to be used on the component.
id Text
 
The unique identifier value for this component. The value must be unique within the closest naming container.
immediate Boolean
 
The immediate attribute is a boolean flag indicating that component events should be sent to registered event listeners immediately rather than after the validation phase of the JSF request processing lifecycle. The immediate flag allows you bypass JSF validation for a particular component.
inlineStyle Text
 
The inlineStyle attribute contains inline style information, such as background color.
launchListener Text
 
The launchListener attribute sets the method to be used as a launch listener.
onclick Text
 
The onclick attribute sets the JavaScript code to execute when the mouse pointer is clicked over this element.
ondblclick Text
 
The ondblclick attribute sets the JavaScript code to execute when the mouse pointer is double-clicked over this element.
onkeydown Text
 
The onkeydown attribute sets the JavaScript code to execute when a key is pressed down over this element.
onkeypress Text
 
The onkeypress attribute sets the JavaScript code to execute when a key is pressed and released over this element.
onkeyup Text
 
The onkeyup attribute sets the JavaScript code to execute when a key is released over this element.
onmousedown Text
 
The onmousedown attribute sets the JavaScript code to execute when the mouse pointer is pressed down over this element.
onmousemove Text
 
The onmousemove attribute sets the JavaScript code to execute when the mouse pointer is moved within this element.
onmouseout Text
 
The onmouseout attribute sets the JavaScript code to execute when the mouse pointer is moved away from this element.
onmouseover Text
 
The onmouseover attribute sets the JavaScript code to execute when the mouse pointer is moved onto this element.
onmouseup Text
 
The onmouseup attribute sets the JavaScript code to execute when the mouse button is released over this element.
partialSubmit Boolean
 
The partialSubmit attribute allows a partial submit of the page if set to "true". The default is "false".
partialTriggers Text
 
The partialTriggers attribute sets the ids of components that cause a partial update. Use single colon for components that are in naming containers and multiple colons to search through parent and grandparent containers.
rendered Boolean
 
A value-binding expression that evaluates to a Boolean condition indicating if this component should be rendered.
returnListener Text
 
The returnListener attribute sets the method to be used as a return listener.
selected Boolean
 
The selected attribute determines if the item is rendered as selected.
shortDesc Text
 
The shortDesc attribute displays help text you hover over the component.
styleClass CSS Class
 
The styleClass attribute sets the CSS class to apply to this component when it is rendered.
targetFrame Text
 
The targetFrame attribute sets the target frame for the go component.
text Text
 
The text attribute sets the text that is displayed on the component.
textAndAccessKey Text
 
The textAndAccessKey attribute sets the text and accessKey of the component by placing an "&" before the accessKey in the text. For example, "T&ext" makes the "e" the accessKey.
useWindow Boolean
 
The useWindow attribute determines if a secondary window is launched. The default is "false".
visited Boolean
 
The visited attribute determines if component is rendered in a visited style. Only used for train components.
windowHeight Text
 
The windowHeight attribute sets the height of the secondary window if the useWindow attribute is set to "true".
windowWidth Text
 
The windowWidth attribute sets the width of the secondary window if the useWindow attribute is set to "true".