Introduction

A useful function in Yooba Studio is the ability to create forms that collect data from the visitor. Forms can be used for many purposes, for example interest registrations for product launches, registration forms for events, competitions and so on.

Give your form objects names that are easy to identify. This will simplify your work with the data collected by your project.

All form objects have certain properties that are worth noting:

• Unique ID - a unique name that indentifies the form object. This is the name that will be shown in the subsequent report on the captured data, so it's a good idea to label it with a name that is readily identifiable with the information the form object is collecting. E.g. if you're collecting the visitor's full name, label it 'Full name'.
• Validator - Determines how the data the visitor fills out, or chooses, will be validated.

You'll find these properties in the panel for the respective form objects.

If a required form object exists in the scene, the user will not be able to continue to the next scene until all required fields have been filled. This can be avoided by unchecking Submit Form at the action for the button that sends the user to another scene. This could be useful if you want to give the user the opportunity to go back and change something in a previous scene.

Form objects cannot be placed in a master scene.

Form Objects

Below is a description of all the different form objects and their available settings.

Text Input

A single-row text field is used for input of name, email and other short text data. You can change the text field's colour, opacity, border, corner radius and text-specific settings.

Radiobutton

Radio buttons are suitable when the visitor is given a list of multiple options and can only choose one. Radio buttons that are to be in the same group must have the same group name. There can only be one selected radio button in each group. You can choose to change the colour of the radio button and its icon (the dot in the middle).

Checkbox

Checkboxes are used when the visitor is given a list of options where they can make multiple choices. All checkboxes in the same group need to have the same group name.

A checkbox could also be used for a single option that the visitor can turn on or off.

It is possible to set the colour and icon colour of the checkbox, and to select one or many checkboxes initially.

List

A list can contain numerous options for the visitor. The visitor is allowed to select multiple options by pressing Control while choosing them.

To add options to a list, input an option in the list's settings panel and press the plus sign. To remove an option, select it and press the minus sign.

You can change the list's colour, opacity, border, corner radius and text-specific settings.

Combobox

A combobox contains a list of options where the visitor can only choose one option.

To add options to the combobox, input a text in its settings panel and press the plus sign. To remove an option, select it and press the minus sign.

You can change the combobox colour, opacity, border, corner radius and text-specific settings.

Textarea

When the visitor is supposed to input a text that does not fit in a text field, a text area could be used.

You can change the textarea colour, opacity, border, corner radius and text-specific settings.

Template

A Form Template is an easy way to add common types of form to your project, e.g. registration forms. To add a form template to your scene, select one from the list of pre-defined forms to view it and then click OK.

It is also possible to create your own templates that you can re-use again and again in different projects, without the need to create the same form every time. Create your form exactly as you require and click the button Save Current Scene As Form Template in the Form Template window. Your form will be saved as a template, just as it appears in the scene.