Form

Forms collects one or multiple user input, that replaces placeholders in the phrase contents.

Example:

This phrase example contains static text and form macro place holders:

Customer Name: Name?

The user is an IsCustomer? existing customer.

The customer is using version version number.

If you trigger such phrase, PhraseExpress would not immediately output the phrase but scan the phrase for all form macros first, and render a form which prompts for input:

After filling the form, PhraseExpress replaces the form macro place holders in the phrase contents with the user input and outputs the phrase:

Customer Name: Mike

The customer is an existing customer.

The customer is using version 14.

Form macros are an exception to the normal sequential macro processing as they are processed before any other phrase content.

If the same input is required at multiple positions throughout a phrase, use the identical label for all related form macros. Only one instance of the objects that have the same label will be shown in the form.

How to create a form:
  1. Open the main program window.
  2. Select the phrase, you wish to extend with user input.
  3. Place the cursor at the position in the phrase where you wish to insert user input and select User Input » Form input:

  4. Configure the form macro.
  5. Repeat from step 2 for all desired user inputs.

Appearance

This macro function specifies the form window title text, width and height.

You can also specify if the the form output preview is shown automatically with the form.

This macro must be placed in the very beginning of the phrase.

Form input

The form input provides multiple different types of input controls.

Text input

The single- or multi-line text input replaces the macro placeholder in the phrase.

Single-line text input

PhraseExpress can optionally prevent input mistakes by checking the syntax (e.g. URL, email address, file path, numbers, letters, etc.).

Checkbox

PhraseExpress outputs the content as specified for the ticked or unticked checkbox.

Checkbox group

Outputs the content as specified for ticked or unticked checkboxes. The output for each checkbox of group is enumerated with the specified enumeration text. The last two outputs are concatened by the corresponding enumeration text as specified.

Checkbox Dropdown

Checkbox Drop down menus offer you to select multiple items while saving vertical space in the form.

Disadvantage: You need to click the drop-down menu first to access the options.

Radio button group

Radio buttons allow you to make one single choice out of multiple options.

Input Grid

An input grid adds a table, consisting of multiple input types.

After filling out the form, the outputs associated with the selected column elements are replaced with the macro placeholder. If several options are selected, the output will be enumerated with the defined separator and the final last separator. The individual lines will be separated with the defined line separator.

Single-line input

Multi-line input

Checkbox

Radio button

Dynamic forms

Form input elements can be shown depending on the input of another form input of the same form.

To control, visibility of a form input element, check option "Visible only on input in…" and select the user input, that shall control the visibility:

Phrase Dropdown

This form input element allows you to select a phrase from the defined phrase folder that is identified by its autotext.

Date input

This form element adds a date input field with calendar window to the form:

Numeric slider

This macro function adds a slider for number input:

Numeric input

This macro function adds a numeric input box to a form:

Form group

This macro function groups a set of form elements and outputs the user input by customizable enumerators:

The example creates a group of 3 checkboxes. The checked items will be separated by ", ". The last checked item will be separated by " and ".

Output examples:

ear, nose and mouth

ear and nose

Text label

This macro function adds a text label to the form:

You can also specify a clickable link.

The form text label is not output into the phrase.

Separator

This macro function inserts a horizontal line to visually separate form contents:

WYSIWYG forms

WYSIWYG forms allow you to place text input boxes, dropdowns, phrase selection dropdowns, checkboxes and date selection within a formatted phrase:

Any form input is inserted the actual position of the input control.

If nesting with other macro functions is required, we recommend that you use the form functions described above.

Table of Contents


    Table of Contents