The HTML form elements can be connected via a property connection from a Java Client Cursor component, a JavaScript Client Cursor component, or either of the dummy cursors. You can make a property connection between a propertyChange
event in one of these cursors and an HTML form element's Value
property, so that the form element displays the current data for a specific row and column.
To view descriptive source files (component
.hi
) for most HTML components, see the palomar/hi
directory in your Visual JavaScript installation.
A few components listed here differ from other HTML components in that they are fragments of HTML code, rather than simple tags, and are defined in the Palette archive. This type of "Palette component" (a fragment of HTML treated as a component) is also the result when you select a block of HTML in the Page Editor's Structure view and drag it to the Palette.
Components are presented below alphabetically. The properties are listed alphabetically by the display name with which they are presented in the Inspector. Note that these differ from the actual property names that are used to access property values in code.
These are the built-in HTML components:
<INPUT TYPE=BUTTON>
HTML tag. It is a client-side component. The text label of the button is specified in the Button Label
property. To add behavior to a Button component, connect a script or method to its click
event.
A descriptive source file for this component is install dir
/palomar/hi/button.hi
Button | |
---|---|
Event | Description |
onBlur | Occurs when the button loses keyboard focus. |
onClick | Occurs when the button is clicked. |
onFocus | Occurs when the button is given keyboard focus. |
Check Box
The Check Box component is an HTML check box form element that corresponds to the <INPUT TYPE=CHECKBOX>
HTML tag. It is a client-side component. (Compare the JavaScript Check Box, which supports property and event connections.)
A descriptive source file for this component is
install dir
/palomar/hi/checkbox.hi
Properties
Client Script
The Client Script component is a client-side HTML component that corresponds to the <SCRIPT>
HTML tag. It is a client-side component. The tag contains arbitrary client-side JavaScript code that you provide. To create or edit the code, edit the JavaScript Code
property of the component. Alternatively, specify a file containing JavaScript code. The code is run on the client when the page is requested.
The component has no methods or events.
This component is an HTML fragment defined in the Palette archive. A descriptive source file for this Palette component is install dir>
/palettes/ClientJS_pe.html
Properties
Drop-down List
The Drop-down List component is an HTML selection list form element that corresponds to the <SELECT>
HTML tag. It is a client-side component. A selection list contains a number of options, each of which corresponds to a different return value for the element. (Compare the JavaScript Select List, which supports property and event connections.)
The Drop-down List component is identical to the Scrolling List component except that in the Drop-down List the
Size
property has a default value of 1, so that it displays a single item until the user clicks it to activate a drop-down list. When the value is greater than 1, the component displays multiple items, through which the user can scroll.
A Drop-down List (or Scrolling List) component can have one or more Option sub-components, representing the options displayed by the component. When you inspect the component, the Inspector displays an option editor that lists all the options in the component. To add a new option, right-click an option in the Text column to display the context menu. You can choose Insert Option Before, Insert Option After, or Delete This Option. Each option has a text label, a return value, and a selected flag that specifies whether the option is selected by default when the component is displayed. By default, the component has three options with labels one
, two
, and three
, of which the first is selected.
The properties, methods, and events of the Drop-down List are the same as those of the Scrolling List.
A descriptive source file for this component is install dir
/palomar/hi/select.hi
Properties
Drop-down List | |
---|---|
Method | Description |
blur | Removes keyboard focus from the list. Arguments: none Return value: none |
focus | Gives keyboard focus to the list. Arguments: none Return value: none |
Drop-down List | |
---|---|
Event | Description |
onBlur | Occurs when the list loses keyboard focus. |
onChange | Occurs when the user selects or deselects an item. |
onFocus | Occurs when the list is given keyboard focus. |
File Upload
The File Upload component is an HTML form element that corresponds to the following HTML tag:
<INPUT TYPE="FILE" SIZE=
You use this component to allow the user to enter or browse for a path and filename. It appears as a text field with a Browse button next to it. The user can either enter a path directly in the text field or click the button to display a file chooser; the path of the selected file is inserted in the text field.
The file specified in the text field is submitted with the form. The path value returned by this component cannot be used unless the containing form's <x>
MAXLENGTH=<y>
NAME="<name>
">Encoding
property is set to Multipart/Form-data
and its Method
property is set to Post
. You must create some logic on the server-side to handle the submitted file.
A descriptive source file for this component is install dir
/palomar/hi/file.hi
Properties
Form
The Form component is an HTML container component for all form elements. It corresponds to the <FORM>
HTML tag. It is a client-side component.
Submit a form by calling the Form component's submit
method. When you put a Submit Button on a form, that button's click
event automatically calls the submit
method of the containing form.
When a Form is submitted, the page identified in its Action
property is loaded, and the values of the form's elements are passed to the page via the LiveWire request
server object. (Compare the JavaScript Validated Form, which allows validation of user-entered data before it is submitted.)
A descriptive source file for this component is
install dir
/palomar/hi/form.hi
Properties
Form | |
---|---|
Event | Description |
onReset | Occurs just before the elements of the form are reset. |
onSubmit | Occurs just before the form is submitted. |
Hidden Field
The Hidden Field component is an HTML form element that does not appear visually at run time. It corresponds to the <INPUT TYPE=HIDDEN>
HTML tag. It is a client-side component. It is used to submit a value to a server without any display. The component has no methods.
A descriptive source file for this component is install dir
/palomar/hi/hidden.hi
Properties
Hidden Field | |
---|---|
Event | Description |
property value change |
Occurs when the Value property changes.
|
HTML Table
The HTML Table component is a general-purpose table form element. By default, the table has two rows and two columns, and corresponds to the <TABLE>
HTML tag, containing two <TR>
tags, each with two <TD>
tags.
Some of the visual features of the table are controlled by the HTML Table properties. Other features, such as the number of rows or cells and the text content of cells, can be edited directly in the Page Editor or through the properties of the HTML tags. You can select these tags in the Structure view of the Page Editor and display their properties in the Inspector.
This component is an HTML fragment defined in the Palette archive. A descriptive source file for this Palette component is install dir
/palettes/Table_pe.html
Properties
Image
The Image component is an HTML component displaying an embedded image. It corresponds to the <IMG>
HTML tag. It is a client-side component. The properties determine how the image is displayed. The image file is specified in the Source
property. You can import the image file into the project and specify only the filename, or you can specify an absolute URL for the image.
You cannot define event handlers for an Image component in the Connection Builder. Use an HTML source editor to define event handlers in the HTML tag. Refer to HTML documentation for details.
The component has no methods and no events.
A descriptive source file for this component is
install dir
/palomar/hi/image.hi
Properties
Link
The Link component is an HTML hyperlink component that corresponds to the <A>
HTML tag. It is a client-side component. Replace the default text of the link by selecting the text in the Page Editor (Layout or Structural view) and typing over it.
A descriptive source file for this component is install dir
/palomar/hi/a.hi
Properties
Link | |
---|---|
Event | Description |
onClick | Occurs when the user clicks the link. |
onMouseOut | Occurs when the user moves the cursor off the link. |
onMouseOver | Occurs when the user moves the cursor over the link. |
Multi-line Text Field
The Multi-line Text Field component is an HTML multi-line text field form element with scrollbars. This component corresponds to the <TEXTAREA>
HTML tag.
A descriptive source file for this component is install dir
/palomar/hi/textarea.hi
Properties
Password Field
The Password Field component is an HTML editable text-field form element that corresponds to the <INPUT TYPE=PASSWORD>
HTML tag.
The Password Field component differs from the Text Field component in that the value is not displayed visually in the end-user interface, or echoed to the screen as the user types into it. The properties, methods, and events are the same as those of the Text Field component.
A descriptive source file for this component is install dir
/palomar/hi/password.hi
Properties
Radio Button
The Radio Button component is an HTML radio button form element that corresponds to the <INPUT TYPE=RADIO>
HTML tag. It is a client-side component. Give several Radio Button components the same Name
property value to make them a radio button group. Within a radio button group, selection of a button deselects all other buttons in the group. (Compare the JavaScript Radio Group component, which supports property and event connections.)
A descriptive source file for this component is
install dir
/palomar/hi/radio.hi
Properties
Radio Button | |
---|---|
Event | Description |
onBlur | Occurs when the radio button loses keyboard focus. |
onClick | Occurs when the radio button is clicked. |
onFocus | Occurs when the radio button is given keyboard focus. |
Reset Button
The Reset Button component is a special-purpose button form element intended to be used with a form connected to a database. It has predefined behavior, which clears all current values from other elements in the containing form, and a predefined label, "Reset
." You can change the label by setting the Button Label
property.
This component corresponds to the <INPUT TYPE=RESET>
HTML tag. It is a client-side component. The properties, methods, and events are the same as for the Button component.
A descriptive source file for this component is install dir
/palomar/hi/reset.hi
Properties
Reset Button | |
---|---|
Event | Description |
onBlur | Occurs when the button loses keyboard focus. |
onClick | Occurs when the button is clicked. |
onFocus | Occurs when the button is given keyboard focus. |
Scrolling List
The Scrolling List component is an HTML selection list form element that corresponds to the <SELECT>
HTML tag. It is a client-side component. A selection list contains a number of options, each of which corresponds to a different return value for the element. (Compare the JavaScript Select List, which supports property and event connections.)
When the
Size
property has a value of 1, the component displays a single item until the user clicks it to activate a drop-down list. When the value is greater than 1, the component displays multiple items, through which the user can scroll. (Note that the Drop-down List component is identical except that the Size
property has a default value of 1.)
A Scrolling List (or Drop-down List) component can have one or more Option subcomponents, representing the options displayed by the component. When you inspect the component, the Inspector displays an option editor that lists all the options in the component. To add a new option, right-click an option in the Text column to display the context menu. You can choose Insert Option Before, Insert Option After, or Delete This Option. Each option has a text label, a return value, and a selected flag that specifies whether the option is selected by default when the component is displayed. By default, the component has three options with labels one
, two
, and three
, of which the first is selected.
A descriptive source file for this component is install dir
/palomar/hi/select.hi
Properties
Scrolling List | |
---|---|
Method | Description |
blur | Removes keyboard focus from the list. Arguments: none Return value: none |
focus | Gives keyboard focus to the list. Arguments: none Return value: none |
Scrolling List | |
---|---|
Event | Description |
onBlur | Occurs when the list loses keyboard focus. |
onChange | Occurs when the user selects or deselects an item. |
onFocus | Occurs when the list is given keyboard focus. |
Server Script
The Server Script component is a server-side HTML component that corresponds to the <SERVER>
HTML tag. The tag contains arbitrary server-side JavaScript code that you provide. To create or edit the code, edit the JavaScript Code
property of the Server Script component. The code is run on the server when the page is requested.
The component has no methods or events.
This component is an HTML fragment defined in the Palette archive. A descriptive source file for this Palette component is install dir
/palettes/ServerJS_pe.html
Properties
Server Script | |
---|---|
Property | Description |
JavaScript Code |
Server-side JavaScript code that is run when the containing page is requested. This is the content of the <SCRIPT> tag.
Value type: string
|
Submit Button
The Submit Button component is a special-purpose button form element intended to be used with a form connected to a database. It has predefined behavior, which submits the containing form, and a predefined label, Submit
. You can change the label by setting the Button Label
property.
This component correspond to the <INPUT TYPE=SUBMIT>
HTML tag. It is a client-side component. The properties, methods, and events are the same as for the Button component.
A descriptive source file for this component is install dir
/palomar/hi/submit.hi
Properties
Submit Button | |
---|---|
Event | Description |
onBlur | Occurs when the button loses keyboard focus. |
onClick | Occurs when the button is clicked. |
onFocus | Occurs when the button is given keyboard focus. |
Text Field
The Text Field component is an HTML editable text-field form element that corresponds to the <INPUT TYPE=TEXT>
HTML tag. It is a client-side component.
A descriptive source file for this component is install dir
/palomar/hi/text.hi
Properties
Last Updated: 11/07/97 14:09:05