You see the Properties window for a Form component when you select the component in the Navigator window after you have added the component to the page.
The Form component has the following properties.
General
id. Type: String
The name of the Form 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.
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.
Behavior
autoComplete. Type: boolean
This property enables the auto-completion feature of the Microsoft Internet Explorer and Firefox browsers. The property is selected by default. If the property is not selected, it disables auto-completion in those browsers.
target. Type: String
The frame in which the form response should be rendered. If a frame with this name does not exist, the response is rendered in a new window unless overridden by the user. The following frame names have special meaning:
_blank - renders the response in a new, unnamed window
_self - renders the response in the current frame
_parent - renders the response in the immediate frameset parent
_top - renders the response in the full, unframed window
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.
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.
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.
onReset. Type: String
JavaScript to be executed when the user resets the form.
onSubmit. Type: String
JavaScript to be executed when the user submits the form.
Advanced
enctype. Type: String
The content type used to submit form data to the server. If you click the ellipsis button, you see a dialog box from which you can select media types or add a new media type. You can see a list of registered media types at:
The default media type for a form is application/x-www-form-urlencoded. In this media type, the form field names and values are escaped as follows:
Space characters are replaced by '+'.
Reserved characters are escaped by using a percent sign and two hexadecimal digits to represent the ASCII code of the character.
Fields are listed in the order in which they appear in the form. The name is separated from the value with an equals sign (=) and each field name is prefaced by an ampersand (&). Fields with null values, like unselected radio buttons and checkboxes, might be omitted. Hidden fields with value attributes present are included.
internalVirtualForms. Type: Form$VirtualFormDescriptor
The virtual forms used internally to components in the form, such as a table component. Component authors can manipulate this set of virtual forms independently of the set exposed to developers. This set is consulted only after consulting the set exposed to developers. To indicate descendants, use :* after the component ID. For example, tabel1:* indicates all descendants of the table1 component.
rendered. Type: boolean
If selected, the component is to be rendered and processed on any subsequent page submission. If not selected, the component does not appear on the page at all, not even as a hidden component, and its Output Text component does not appear either. If this property is not selected (false), it overrides the rendered property of its child component.
You can bind this property to a JavaBeans property that determines when the component gets rendered. For example, an airline reservation form might show a Form 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.
virtualFormsConfig. Type: String
The configuration of the virtual forms in this form. Each virtual form is represented as a String and is described by three parts, separated with pipe (|) characters: the virtual form name, a space-separated list of component ids that participate in the virtual form, and a space-separated list of component ids that submit the virtual form. Multiple virtual forms are separated by commas.