Static Text Component Properties Window

See Also | Tutorials

You see the Properties window for a Static Text component  when you select the component on a page that you are editing in the Visual Designer or in the Outline window.

Most of the Static Text component's properties are both JSP attributes and properties of the StaticText Java component in the page bean.

This component has the following properties.

General

• id. Type: String
  The name of the Static Text component in the page bean and the JSP file.
   
  

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.
  • Note: 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
  http://www.w3.org/TR/REC-CSS2/propidx.html
   
  
• 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.
  • Note: 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.
  
   
  
• text. Type: Object
  The text that displays on the page. You can specify a value to be initially displayed, or you can click the ellipsis button and bind the property to a data provider or to an object so the property's value can be set dynamically.
   
  

Data

• converter. Type: Converter
  A JavaServer Faces converter that converts the value of the text property to a String so it can be displayed. The component will pick the correct converter for the text property if one is available, making it unnecessary to set this property in most cases. If the text property is bound to a value whose type is not on the list of converters, you have to supply your own converter and set this property.
   
  
• escape. Type: boolean
  Selecting this property causes characters like '<' that can cause problems with XML and HTML to be escaped. For example, with this property selected, '<' is represented as &lt;.
   
  

Behavior

• 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.
   
  
• 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, 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.
  • Note: 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.
  
   
  

JavaScript

• 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.
   
  
• 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

• rendered. Type: boolean
  If selected, the component is to be rendered and processed on any subsequent page submission. If not selected, the component doesn't appear on the page at all, not even as a hidden component. You can bind this property to a JavaBeans property that determines when the component does get rendered. For example, an airline reservation form might show a text field for frequent flyers and not show it for the general public. To bind this property, click the ellipsis button (...) to the right of the property and choose Use Binding in the dialog box.
   
  

See Also

Static Text Component

Working With Components

Component Tasks: Quick Reference

Tutorials

Delving Into Components Tutorial

About Stylesheets and Component Layout

Using Converters Tutorial

Understanding Scope and Managed Beans