dw.web
Class FormElement
Object
dw.web.FormElement
Represents a form element.
Properties
dynamicHtmlName  :  String  (Read Only)
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  :  String  (Read Only)
The ID of the form element. The is is unique within the parent element of the form.
htmlName  :  String  (Read Only)
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  :  FormElement  (Read Only)
The parent within the form.
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  :  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.
Constructor Summary
This class does not have a constructor, so you cannot create it directly. To get an instance of this class, use one of the subclass constructors.
Method Summary
clearFormElement() : void
This method clears the whole form.
getDynamicHtmlName() : String
Returns a dynamic html name for the field.
getFormId() : String
The ID of the form element.
getHtmlName() : String
Returns the global unique name of the field, which can be used as name in the html form.
getParent() : FormElement
The parent within the form.
getValidationResult() : FormElementValidationResult
Provides a combined view on the validation status as per isValid() and getError().
invalidateFormElement() : void
The method can be called to explicitly invalidate a form element.
invalidateFormElement(error : String) : void
The method can be called to explicitly invalidate a field.
isValid() : boolean
Identifies if this element and all its children elements are valid.
Methods inherited from class Object
Method Detail
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
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.

X Privacy Update: We use cookies to make interactions with our websites and services easy and meaningful, to better understand how they are used and to tailor advertising. By continuing to use this site you are giving us your consent to do this.