Initializing help system before first use

# Form Layout and Validation

The default layout for forms is horizontal, meaning that each field is on a separate line, contains a label on the left and an input control on the right.
Note: See Creating Grid Layouts for more on the grid layout used by the View Designer when creating Views.
Again by default, the label and input will have a grid size of 2 if placed within an unsized `<vdl-column>` element such as:

    <vdl version="5.8">
       <vdl-page>
        <vdl-section>
            <vdl-row>
              <vdl-column>
                <vdl-form>
                  <vdl-field entity="changeShare" options-set="ShareIds">
                  </vdl-field>
                  <vdl-field entity="cautionText"></vdl-field>
                </vdl-form>
              </vdl-column>
            </vdl-row>
        </vdl-section>
      </vdl-page>
    </vdl>

Figure : 1. Appearance of the Default Form Layout

This approach is representative of VDL forms as they were up to and including VDL version 2.0.

The width of a VDL form can be controlled by setting the `size` attribute to a grid value in the containing `<vdl-column>` element.

    <vdl version="5.8">
      <vdl-page>
        <vdl-section>
            <vdl-row>
              <vdl-column size="4">
                <vdl-form>
                  <vdl-field entity="changeShare" options-set="ShareIds">
                  </vdl-field>
                  <vdl-field entity="cautionText"></vdl-field>
                </vdl-form>
              </vdl-column>
            </vdl-row>
        </vdl-section>
      </vdl-page>
    </vdl>

Figure : 2. Rendered View of Alternative Form Layout
Using this method, the form uses the grid size for the form width via the `size` attribute. In this case, with a column size of 4, the label and input fields both have a grid size of 2 (half the column size). This arrangement works all the way from a grid size of 12 down to 2.

The layout mode can be changed to vertical, where each field remains on a separate line but the labels appear above the associated input controls. This is accomplished by simply specifying a `layout="vertical"` attribute on a `<vdl-form>` element.

A final available option is to use inline inputs, which display the input controls without labels, and float inline with text. This is easy to achieve with the `inline` attribute of the `<vdl-field>` element.

## Form Field Validation

Validation is applied to all fields in a form. There is standard, built-in validation, but it is also possible to define custom validators for fields, for more on custom validation see Using Validators. Validation is applied as you type or select values. When a value becomes invalid, the field is highlighted with a red background.
Figure : 3. Invalid Value
If you try to save an invalid value, a message dialog appears, containing a validation failure message.
Parent Topic Working with Forms

© 2001-2026 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.