You see the Properties window for a Page Alert Component when you select the component on a page that you are editing in the Visual Designer. Most of the component's properties are both JSP attributes and properties of the PageAlert Java component in the page bean.
This JavaServer Faces 1.2 component has the following properties.
General
id. Type: String
The name of the Page Alert Component in the page bean and the JSP file.
Appearance
detail. Type: String
Text that provides more detailed information about the page alert and possibly what to do about it. The detail text appears below the summary.
style. Type: String
Cascading Style Sheet rules (CSS level 2) to be applied to the component. 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.
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.
summary. Type: String
Brief text that tells the user why the page alert was displayed. This text appears below the title, if there is one.
title. Type: String
The title of the page, if any. Set the message text in the summary property.
Data
escape. Type: boolean
Indicates that the message text should be escaped so that it is not interpreted by the browser.
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 <.
Behavior
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.
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.
Accessibility
alt. type: String
The alt text for the page alert's icon, which varies depending on the value of the type property. The alt text describes the icon in the HTML page, is readable by screen readers, can display as a tool tip, and displays when the user has display of images turned off in the web browser.
tabIndex. Type: String
Optionally specifies the position of the page alert component in the tab order of the document. Determines when the page alert will get focus if the user tabs through the document. The value must be an integer between 0 and 32767.
Advanced
rendered. Type: boolean
If selected, the component is to be rendered. 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.
type. Type: String
The category of the page alert: error, warning, information, or question. The category determines the icon that displays with the page alert.