You see the Properties window for a Tree component when you select the component on a page that you are editing in the Visual Designer or in the
.
This JavaServer Faces 1.2 component has the following properties.
General
id. Type: String
The name of the Tree component in the page bean and the JSP file. In the page bean, the Tree component is represented by a Tree object.
Appearance
style. Type: String
Cascading Style Sheet rules (CSS level 2) to be applied to the component. For example:
position: absolute; left: 288px; top: 312px
You can enter values directly or click the ellipsis (...) button to use the Style Editor.
This property overrides any settings in the theme or the project CSS file for this component. If a style specified in this property does not appear to take effect, it is because an area of the component is obscured by a child component that has different style settings.
For a list of CSS2 style attributes, see the web page at
styleClass. Type: String A space-separated list of CSS2 style classes to be applied when the component is rendered. The style classes must be defined in the project's style sheet or in the theme's CSS file. If you click the ellipsis button (...), you see a list of all styles you can add to this property. For information on adding CSS classes and rules to the project's cascading style sheet, see CSS Editor.
See the note above under the style property description for an explanation of why a class added to this property might appear to have no effect on the component.
See the note above under the style property description for an explanation of why a class added to this property might appear to have no effect on the component.
If you add a CSS style class from the current theme to your project CSS file and you redefine the style class, the change affects all components that use this style class. However, you can add your own style classes to the project CSS file that redefine the default style classes, and then when you add them to this property, the changes affect only this instance of this component.
text. Type: String
The label describing the root node for the tree.
Data
selected. Type: String
The ID of the tree node that is currently selected. Setting this property to one of the nodes in the tree causes the tree to display initially with that node selected. When the user selects a node, this property's value changes to that node's ID and the tree shows that node as selected.
Behavior
clientSide. Type: boolean
If this property is selected, expanding and collapsing the tree affects only the client, without involving the server. If this property is not selected, every time the user expands or collapses a node of the tree, a request is sent to the server.
expandOnSelect. Type: boolean
If selected, indicates that nodes are to be expanded when the user selects them.
required. Type: boolean
If this property is set, the user must select a tree node before the page can be submitted. The first node in the tree might appear to be selected when the page is first shown, but a node must be explicitly selected by the user if this property is set. If you add a Message component to the page and link its for property to this component, an error message will be displayed if the user tries to submit the page without selecting a node.
toolTip. Type: String
Rendered as the HTML title attribute of the component, which is readable by a screen reader and can be displayed as a tool tip.
If the component is disabled, the tooltip will not display in most browsers.
visible. Type: boolean
Indicates whether or not the component can be seen by the user on the rendered HTML page. This property is selected by default. If you deselect this property, the component's HTML code is rendered on the page, but the component is not visible in the browser because it is hidden by a style setting. Because the HTML code is rendered, the component can still be processed on form submissions, and users who view source in the browser can see the HTML code. In addition, your web application can use client-side JavaScript to show or hide the component.
If you need to completely hide the component, for example, because it contains sensitive information that certain users should not see, deselect the rendered property.
Advanced
immediate. Type: boolean
If this property is selected, when the user submits the page, code for this component in the page bean is executed before the validation, updating of model values, and so on. Essentially, code execution happens right away on the server, which then returns the page.
You must select this property if you want the selected property to return the ID of the selected node.
rendered. Type: boolean
If selected, the tree is to be rendered and processed on any subsequent page submission. If not selected, the tree does not appear on the page at all, not even as a hidden component.