Progress BarPRO

This field enables you to add a progress bar to your form. By default it will show the overall progress of the form being completed. The progress is calculated by assessing how many required fields in the form have been successfully filled out by the website visitor.

For forms that have multiple tabs, you can add the progress bar to each tab. The progress bar shows the overall progress of the entire form across all tabs.

To learn how to add, edit, clone, move, resize, offset, or delete a progress bar field, please click here.

When editing a progress bar field, the field settings sidebar will appear. This contains the following tabs:

You can edit any of the settings in each of these tabs and then click the ‘Save’ button to save your changes. If you do not want to save your changes, you can click the ‘Cancel’ button or click any other form element to close the field settings sidebar.

Basic

The basic tab contains settings that the majority of WS Form users will need to control a field. The settings are as follows:

Label

This is the label shown alongside the field. As well as entering a label into this field, you can also double click the label of the field in the editor. You should enter an easy-to-understand label for your field, for example ‘First Name’ or ‘Email’.

Render Label

If enabled the label will be shown on your form. If you do not want the label to appear for a particular field, uncheck this box.

Label Position

There are five positions you can choose for your label:

  • Default
  • Top
  • Left
  • Right
  • Bottom

The default position will place the label set in the form settings advanced tab. For new forms this will be ‘Top’ positioning.

Note that when using some frameworks some label positions may not be available.

Source

The source pulldown has two options:

  • No source
  • Form Progress (Default)

When ‘Form Progress’ is selected, the progress bar will automatically show the progress of the form.

When ‘No source’ is set, you can manually set the progress bar value using conditional logic or another javascript source of your choice.

Default Value

The default value setting is used to populate the field with a default value. Progress bars are usually set with a value from 0 to 1, so you should enter a numeric value from 0 to 1 in this field. If you leave it blank, it will be set to 0. For example 0.5 would set the progress bar to halfway.

WS Form variables can be entered into this field.

Help Text

The help text setting enables you to add smaller text under the field to assist the website visitor in completing that field.

As well as inserting plain text into this field, WS Form also provides extensive functionality for adding progress variables. The available progress variables are:

Progress
#progress The form progress represented as a number from 0 to 100.
#progress_percent The form progress represented as a percentage from 0% to 100%.
#progress_remaining The remaining form progress represented as a number from 100 to 0.
#progress_remaining_percent The remaining form progress represented as a percentage from 100% to 0%.

Other WS Form variables can be entered into this field.

Accessibility

ARIA Label

Accessible Rich Internet Applications (ARIA) defines ways to make web content and web applications more accessible to people with disabilities.

This setting enables you to define what text is made available to ARIA applications. This would, for example, provide a screen reader with specific text to read to someone with a disability.

The value of this setting defaults to your field label. If you would like to change this, enter a new value.

WS Form variables can be entered into this field.

Advanced

The advanced tab contains additional form attribute settings that provide further control over how a field is rendered.

Classes

For developers WS Form allows you to add your own classes to fields.

Wrapper CSS Classes

The wrapper CSS class setting enables you to add a class (or classes) to a field wrapper. Field wrappers are sections of HTML added around a field to position them on the page. To add multiple classes, add a space between the class names.

Field CSS Classes

To add a class to the actual field element itself, enter a class (or classes) to this setting. To add multiple classes, add a space between the class names.

Minimum

This is the minimum value for the progress bar. This defaults to 0 if left blank.

Maximum

This is the maximum value for the progress bar. This defaults to 1 if left blank.

Breakpoints

The breakpoint settings define the width of a field and also what the offset (how many columns from the left-hand side of the form or the previous field) of a field is for each breakpoint. For more information about the breakpoint settings and capabilities of WS Form, click here.