History | Edit

Oxygen XML Web Author supports a variety of built-in form controls that allow users to interact with documents with familiar user interface objects. The oxy_label function is also supported and can be used to change the style of generated text.

For information about implementing custom form controls in Web Author, see Tutorial: Implementing a Custom Form Control.

Table 1. Supported Properties for Form Controls and Functions in Oxygen XML Web Author
Form Control Description Supported Properties
Button form control This form control provides a button object that is used to invoke a specific action.

color
actionID
transparent

Button Group form control This form control provides a group of button objects that are used to invoke specific actions.

label
icon
actionDisplayStyle
tooltips
transparent

Checkbox form control This form control offers a single checkbox or multiple checkboxes that can be used to enable or disable an option.

resultSeparator
tooltips
values
uncheckedValues
labels
color

Combo Box form control This form control provides a graphical object that is a drop-down menu of proposed values. It can also be used for a combination of a drop-down menu and an editable single-line text field.

columns
editable
tooltips
values
fontInherit (always true)
labels
color

Date Picker form control
Note: Some browsers interpret the HTML5 datePicker as a text-field.
This form control offers a text field that allows the user to choose a date in a specified format. Some browsers include a calendar browsing mechanism along with the text field.

columns
color
format

HTML Content form control This form control is used for rendering HTML content. It is displayed as a graphical element shaped as a box. The shape of the box is determined by a specified width and the height is computed based upon the length of the text.

href
ID
width

Pop-up form control This form control offers a contextual menu that provides quick access to various actions. A pop-up form control can display single or multiple selections.

color
tooltips
values
resultSeparator
selectionMode
labels
columns
rendererSort (has to be identical to editorSort)

Text Area form control This form control provides a text box that can be used to enter multiple lines of text.

type
columns (in average character width)
rows
fontInherit
color

Text Field form control This form control provides a text field box that is used for entering a single line of text.

type
columns
fontInherit (always true)
tooltip
color

URL Chooser form control This form control provides a dialog box that allows you to select the location of local or remote resources. The inserted reference is made relative to the URL of the currently opened editor.

columns
color
fontInherit (always true)

oxy_label() function This function can be used as a value for the CSS content property to change the style of generated text.

text
width
color
background-color
inherit
styles

For more information about form controls, see our video demonstration: Oxygen Video Demo: Form Controls.