Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

When a form element is added to a step, the basic properties for the form element can be defined. For example, when you click on a Date form element in a step, its properties appear in the "Properties" section. By default, XperienCentral gives each form element the title "<step name> <Input x>" where x increases by a value of 1 each time a new form element is added. In almost all cases you should change the title of a form element to something meaningful if the titles are shown in the form on the front-end. Because of this default naming scheme, you may sometimes see that a new step added using drag and drop does not seem to have a logical digit. For example, if you add an eighth step between steps 3 and 4 using drag-and-drop, it is named "step 8" — this is nevertheless correct because it was the eighth step added to the form.

To show all properties for a form element, click the expand icon. The full set of properties then appears. Each of the standard form elements is described in the following sections. The front-end examples of how the form elements will look to website visitors will not appear exactly as shown because the presentation you will see is based on your corporate style.

 

...

 

Text form elementImage RemovedImage Added

Text Form Element

...

PropertyDescription
TitleThe text that appears next to the text input field in the step pane and in the form on the front-end.
Required fieldSpecifies whether the field is required.
Show titleSpecifies whether to show the title of the form element in the step pane and in the form on the front-end.
Design templateSpecifies the design template to use to render the form element on the front-end. This property will only be available if there are two or more design template for the form element.
Identifier

The unique identifier to use for this form element. The unique identifier is used in expressions for (pre)filling and (pre)conditions. Click here for information about renaming an identifier.

 

Note

GX Software highly recommends that all form fragment identifiers be unique.

PreconditionThe precondition decides in what situations the form element will be visible to the website visitor.
Help textIn this field you can enter text that displays next to the form element in the form in order to provide useful information on what input is requested/expected. How/whether this text appears in the form is controlled by your presentation.
Extra textThis is extra text that you can show by a form element to provide extra guidance regarding what the expected input is. How/whether this text appears in the form is controlled by your design template.
PrefillingPrefilling determines the initial value of this form element for the website visitor. Prefilling is further described in the section and Prefilling a Form Element.
ValidationsSelect one or more validator(s) to evaluate the input received by a form element in order to ensure that it conforms to the constraints you indicate. See the section Form Element Validations for complete information on using the validators.
CSS classnameSpecifies the CSS class to use for rendering the form element. This option allows you to alter the how selected form elements appear in the form without globally altering the presentation.
Fragment TagA unique tag to identify the form fragment. This tag is rendered in the form element presentation as a custom data attribute of the form element itself. The attribute name is data-fragment-tag. When filling out this property for a form element, the attribute is added to the presentation and can be used by external applications like GX Software's BlueConic.
Maximum lengthSpecifies the maximum number of characters that will be accepted for the Text, Password, Textarea, and Email form elements.
WidthSpecifies the width of the input box for the Text, Number, Password, Textarea, and Email form elements. What the value represents (pixels, characters, etc.) is determined by your presentation.

 

...

 

 

Number form elementImage RemovedImage Added

Number Form Element

...