Class FormElement

Represents a form element.

All Known Subclasses 

Form, FormAction, FormField, FormGroup, FormList, FormListItem

Property Summary 

PropertyDescription
dynamicHtmlName: String (read-only)Returns a dynamic html name for the field.
formId: String (read-only)The ID of the form element.
htmlName: String (read-only)Returns the global unique name of the field, which can be used as name in the html form.
parent: FormElement (read-only)The parent within the form.
valid: Boolean (read-only)Identifies if this element and all its children elements are valid.
validationResult: FormElementValidationResult (read-only)Provides a combined view on the validation status as per isValid() and getError().

Constructor Summary 

This class does not have a constructor, so you cannot create it directly.

Method Summary 

MethodDescription
clearFormElement()This method clears the whole form.
getDynamicHtmlName()Returns a dynamic html name for the field.
getFormId()The ID of the form element.
getHtmlName()Returns the global unique name of the field, which can be used as name in the html form.
getParent()The parent within the form.
getValidationResult()Provides a combined view on the validation status as per isValid() and getError().
invalidateFormElement()The method can be called to explicitly invalidate a form element.
invalidateFormElement(String)The method can be called to explicitly invalidate a field.
isValid()Identifies if this element and all its children elements are valid.

Methods inherited from class Object 

assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values

Property Details 

dynamicHtmlName 

dynamicHtmlName: String (read-only)

Returns a dynamic html name for the field. It can be used to suppress any autocompletion support from a browser, e.g. for credit card related fields. It can be also used for a unique form name, if one form is used multiple times in a page.


formId 

formId: String (read-only)

The ID of the form element. The is is unique within the parent element of the form.


htmlName 

htmlName: String (read-only)

Returns the global unique name of the field, which can be used as name in the html form. For radio buttons this name is not unique.


parent 

parent: FormElement (read-only)

The parent within the form.


valid 

valid: Boolean (read-only)

Identifies if this element and all its children elements are valid. A form element, which was not submitted in the last request is always valid.


validationResult 

validationResult: FormElementValidationResult (read-only)

Provides a combined view on the validation status as per isValid() and getError(). In addition it also provides the data as returned by the validation in case a validation script was used.


Method Details 

clearFormElement() 

clearFormElement(): void

This method clears the whole form. After clearing a form it contains no value or the default value, is not bound to any business object and has the status of being valid.


getDynamicHtmlName() 

getDynamicHtmlName(): String

Returns a dynamic html name for the field. It can be used to suppress any autocompletion support from a browser, e.g. for credit card related fields. It can be also used for a unique form name, if one form is used multiple times in a page.

Returns:

  • a dynamic html name.

getFormId() 

getFormId(): String

The ID of the form element. The is is unique within the parent element of the form.

Returns:

  • the ID of the form.

getHtmlName() 

getHtmlName(): String

Returns the global unique name of the field, which can be used as name in the html form. For radio buttons this name is not unique.

Returns:

  • the global unique name of the field.

getParent() 

getParent(): FormElement

The parent within the form.

Returns:

  • the parent within the form.

getValidationResult() 

getValidationResult(): FormElementValidationResult

Provides a combined view on the validation status as per isValid() and getError(). In addition it also provides the data as returned by the validation in case a validation script was used.

Returns:

  • the validation status (valid, error, data)

invalidateFormElement() 

invalidateFormElement(): void

The method can be called to explicitly invalidate a form element. The error text will be set to the one of two possible preconfigured custom error messages associated with the form definition. The "value-error" message will be used for FormField instances and "form-error" will be used for FormGroup instances.


invalidateFormElement(String) 

invalidateFormElement(error: String): void

The method can be called to explicitly invalidate a field. The error text is set to the given error message.

Parameters:

  • error - the error text to use.

isValid() 

isValid(): Boolean

Identifies if this element and all its children elements are valid. A form element, which was not submitted in the last request is always valid.

Returns:

  • true if this element and all its children elements are valid, false otherwise.