| |||||||
FRAMES NO FRAMES |
Use the webuijsf:breadcrumbs
tag to display a set of hyperlinks
that can be used as a navigation aid in the rendered HTML page.
Breadcrumbs, or a parentage path, show the user's location within an
application, and the physical or logical path to a page. The user can
click breadcrumbs to navigate to other locations previously traversed
within the application.
A breadcrumb's hyperlinks may be specified in one of two ways:
webuijsf:hyperlink
tags within the webuijsf:breadcrumbs
tag. Hyperlinks specified in this manner
are referred to as "child" hyperlinks.
pages
attribute. The value must a value binding
expression that identifies an array of com.sun.webui.jsf.Hyperlink
components. Hyperlinks
specified in this manner are referred to as "bound" hyperlinks. Bound hyperlinks must
be uniquely identifiable by the value of their id
attribute, and this attribute
must not be null. Bound hyperlinks should not be part of a view tree, and the value of
their parent
property should be null.
Bound hyperlinks are treated as child hyperlinks for all phases of request processing, except that they are not asked to save or restore their state.
The breadcrumbs component has an immediate
property, the default
value of which is true
. If the breadcrumbs is immediate, all action events
generated by child or bound hyperlinks will be treated as though they too were immediate,
whether or not the source hyperlink is immediate. If the breadcrumbs is not immediate,
action events will be processed according to whether their source hyperlink is
immediate or not.
Breadcrumbs are rendered as a series of <a>
XHTML hyperlinks
separated by ">" symbols, similar to the following:
The last element in the breadcrumbs should correspond to the current page, and is rendered as static text.
Separators are rendered between hyperlinks that are visible and renderable. The last child hyperlink is always assumed to refer to the current page, whether or not it is visible or renderable.
<webuijsf:breadcrumbs id="breadcrumbs1">
<webuijsf:hyperlink url="http://google.com" label="Google"/>
<webuijsf:hyperlink url="http://yahoo.com" label="Yahoo"/>
<webuijsf:hyperlink url="http://sun.com" label="Sun"/>
</webuijsf:breadcrumbs>
<webuijsf:breadcrumbs id="breadcrumbs2" pages="#{FieldBean.pagelist}" />
Tag Information | |
Tag Class | com.sun.webui.jsf.component.BreadcrumbsTag |
TagExtraInfo Class | None |
Body Content | JSP |
Display Name | None |
Attributes | ||||
Name | Required | Request-time | Type | Description |
binding | false | false | java.lang.String | A ValueExpression that resolves to the UIComponent that corresponds to this tag. This binding allows the Java bean that contains the UIComponent to manipulate the UIComponent, its properties, and its children. |
styleClass | false | false | java.lang.String | CSS style class(es) to be applied to the outermost HTML element when this component is rendered. |
pages | false | false | java.lang.String | An array of zero or more Hyperlink components that constitute the current
path. If this property is not null, any child Hyperlinks will be ignored.
The hyperlinks must have non-null, unique id s.
|
immediate | false | false | java.lang.String | Indicates whether actions should be handled immediately when generated by hyperlinks that are part of this component. The default value is true. |
visible | false | false | java.lang.String | Indicates whether the component and its child components should be viewable by the user in the rendered HTML page. |
style | false | false | java.lang.String | CSS style(s) to be applied to the outermost HTML element when this component is rendered. |
rendered | false | false | java.lang.String | Use the rendered attribute to indicate whether the HTML code for the component should be included in the rendered HTML page. If set to false, the rendered HTML page does not include the HTML for the component. If the component is not rendered, it is also not processed on any subsequent form submission. |
tabIndex | false | false | java.lang.String | Position of this element in the tabbing order of the current document. Tabbing order determines the sequence in which elements receive focus when the tab key is pressed. The value must be an integer between 0 and 32767. |
id | false | true | java.lang.String | No Description |
Variables | No Variables Defined. |
| |||||||
FRAMES NO FRAMES |