Adaptable Forms

Summary

  • Adaptable Forms are widely used in AdapTable and are highly configurable and flexible
  • They dynamically display form data and is widely used including Export, Alerts and DataSets

There are a few places in AdapTable where a custom form can be displayed, including:

AdapTable provides an Adaptable Form to make displaying form data easy.

Adaptable Forms are primarily made up of 3 collections:

  • Title and Description
  • Form Fields
  • Adaptable Buttons

Adaptable Form Object

Adaptable Forms are defined using the AdaptableForm object, defined as folows:

PropertyDescription
buttonsButtons to include in the Form
descriptionAdditional information to appear in the Form
fieldsCollection of Dynamic Fields to display
titleTitle to appear in the Form

Title & Description

The form object has 2 string properties used to display information about the form:

  • title - text shown at the top of the Form
  • description - additional text showing information the form requires and displayed beneath the title

Fields

A Form can contain as many fields as required.

All fields are are of type AdaptableFormField which is defined as folows:

PropertyDescription
defaultValueField Default Value - can be of type string, boolean, number
fieldTypeField Type: text, date, number, checkbox, select, textOutput
labelLabel to display in the Field
nameName of the Field
optionsItems to populate the 'select' fieldType

Field Types

The fieldType property describes which UI control to display for the field.

It is of type AdaptableFormFieldType and can be any of:

  • text
  • select
  • date
  • number
  • checkbox
  • textOutput

Hint

If the field type is 'select', the options property can be used to populate what appears in the dropdown

Buttons

Forms can additionally include Buttons to perform actions.

The Buttons are of type AdaptableButton described above.

Find Out More

See the UI Guide to the AdapTable Button for detailed information on providing buttons