You see the Properties window for a JavaServer Faces Component Label component when you select the outer part of the component on a page that you are editing in the Visual Designer or you select the Component Label part of this composite component in the Navigator window.
The Component Label component consists of an Output Text component embedded in an Component Label component . When you select this component in the Visual Designer, you also see it in the Navigator window, where you can select the part of the component you want to work with.
This standard JavaServer Faces component has the following properties.
General
id. Type: text
The name of the Component Label component in the page bean and the JSP file.
Appearance
for. Type: String
The component for which this Component Label provides a label.
style. Type: String
Cascading Style Sheet rules (CSS level 2) to be applied to the component. This property overrides any settings in the project CSS file. For example:
position: absolute; left: 288px; top: 312px
You can enter values directly or click the ellipsis (...) button to use the Style Editor.
For a list of CSS2 style attributes, see the web page at
styleClass. Type: String
Enter 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. 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.
title. Type: String
Information about the Component Label that 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.
Data
converter. Type: Converter
A JavaServer Faces converter that produces the correct type of value for the value property. If the user enters the wrong type of value, such as a word instead of a number for an Integer converter, the converter sends a message that you can display in an Inline Message component.
JavaScript
onblur. Type: String
JavaScript to be executed when the component loses focus.
onclick. Type: String
JavaScript to be executed when the user clicks the component.
ondblclick. Type: String
JavaScript to be executed when the user double-clicks the component.
onfocus. Type: String
JavaScript to be executed when the component gains focus.
onkeydown. Type: String
JavaScript to be executed when the component has focus and a key is pressed.
onkeypress. Type: String
JavaScript to be executed when the component has focus and a key is pressed and released.
onkeyup. Type: String
JavaScript to be executed when the component has focus and a key is released.
onmousedown. Type: String
JavaScript to be executed when the mouse cursor is over the component and the user presses down on the mouse button.
onmousemove. Type: String
JavaScript to be executed when the user moves the mouse cursor within the component.
onmouseout. Type: String
JavaScript to be executed when the user moves the mouse cursor away from the component after it has been over the component.
onmouseover. Type: String
JavaScript to be executed when the user moves the mouse cursor onto the component.
onmouseup. Type: String
JavaScript to be executed when the mouse cursor is over the component and the user releases the mouse button.
Advanced
accesskey. Type: String
A keyboard key, or keyboard shortcut, that activates this Component Label. You can enter any valid character that can be typed on the keyboard. Equivalent to the accesskey attribute of the HTML <input> tag.
dir. Type: String
An indicator of the directionality if the text does not inherit directionality (for example, because the text is English but the primary language for the page is Hebrew). Equivalent to the dir attribute of the HTML <input> tag.
Values can be:
LTR. Left-to-right.
RTL. Right-to-left.
lang. Type: String
Code describing the language used in the generated markup for the component. Equivalent to the lang attribute of the HTML <input> tag. To choose a language code, you can click the ellipsis button (...) to open the property editor. Some examples:
ar - Traditional Arabic
de - German
en - English
es - Spanish
fr - French
ja - Japanese
In addition to the codes available in the property editor, you can also enter additional codes using ISO standard names. Some examples:
en-US - United States English
ja-JP - Japanese
zh-guoyu - Mandarin or Standard Chinese
zh-Hans - Simplified Chinese script
zh-HanT - Traditional Chinese script
rendered. Type: boolean
If selected, the Component Label is to be rendered and processed on any subsequent page submission. If not selected, the Component Label does not appear on the page at all, not even as a hidden component. You can bind this property to a variable that determines when the Component Label does get rendered. For example, an airline reservation form might show a Component Label for frequent flyers and not show it for the general public. To bind this property, right-click the component in the Visual Designer and choose Property Bindings, and then select the All radio button to display all properties so you can select the rendered property.
tabindex. Type: String
Optionally specifies the position of the Component Label in the tab order of the document, determining when the Component Label will get focus if the user tabs through the document. The value must be an integer between 0 and 32767. Equivalent to the tabindex attribute of the HTML <input> tag.