Angular Common - Utils - validationEngine
An object that serves as a namespace for the methods required to perform validation.
getGroupConfig()
Gets the default validation group.
The default validation group.
The object returned by the getGroupConfig(group) function has the following structure.
- validators
An array of Validator UI components that are included to the validated group. - validate()
The method that allows you to validate the UI components included to the current group. - validated
The event that occurs after the group is validated. You can attach/detach a handler using the on(eventName, eventHandler)/off(eventName) methods of the group.
let defaultValidationGroup = DevExpress.validationEngine.getGroupConfig(); // ===== or when using modules ===== import validationEngine from 'devextreme/ui/validation_engine'; let defaultValidationGroup = validationEngine.getGroupConfig();
getGroupConfig(group)
Gets a validation group with a specific key.
The validation group.
The object returned by the getGroupConfig(group) function has the following structure.
- group
The string or object passed as the parameter. - validators
An array of Validator UI components that are included to the validated group. - validate()
The method that allows you to validate the UI components included to the current group. - validated
The event that occurs after the group is validated. You can attach/detach a handler using the on(eventName, eventHandler)/off(eventName) methods of the group.
let validationGroup = DevExpress.validationEngine.getGroupConfig('myGroup'); // ===== or when using modules ===== import validationEngine from 'devextreme/ui/validation_engine'; let validationGroup = validationEngine.getGroupConfig('myGroup');
registerModelForValidation(model)
Registers all the Validator objects extending fields of the specified ViewModel.
The ViewModel object has fields extended by the dxValidator objects.
To specify validation rules for ViewModel fields, extend the latter with the dxValidator object.
var viewModel = { login: ko.observable("").extend({ dxValidator: { validationRules: [{ type: 'required', message: 'We need your credentials' }] } }), //... }
To register the rules that are defined within the dxValidator objects, call the DevExpress.validationEngine.registerModelForValidation(model) function passing the ViewModel object as a parameter.
DevExpress.validationEngine.registerModelForValidation(viewModel);
To validate the rules that are defined within the dxValidator objects, call the DevExpress.validationEngine.validateModel(model) function passing the ViewModel object as a parameter.
resetGroup()
Resets the values and validation result of the editors that belong to the default validation group.
DevExpress.validationEngine.resetGroup(); // ===== or when using modules ===== import validationEngine from 'devextreme/ui/validation_engine'; validationEngine.resetGroup();
resetGroup(group)
Resets the values and validation result of the editors that belong to the specified validation group.
DevExpress.validationEngine.resetGroup('myGroup'); // ===== or when using modules ===== import validationEngine from 'devextreme/ui/validation_engine'; validationEngine.resetGroup('myGroup');
unregisterModelForValidation(model)
Unregisters all the Validator objects extending fields of the specified ViewModel.
Specifies the model to unregister.
validateGroup()
Validates editors from the default validation group.
The validation result.
let validationResult = DevExpress.validationEngine.validateGroup(); // ===== or when using modules ===== import validationEngine from 'devextreme/ui/validation_engine'; let validationResult = validationEngine.validateGroup();
See Also
validateGroup(group)
Validates editors from a specific validation group.
The validation result.
See Also
validateModel(model)
Validates a view model.
The ViewModel object that has fields extended by the dxValidator objects.
The validation result.
To specify validation rules for ViewModel fields, extend the latter with the dxValidator object.
var viewModel = { login: ko.observable("").extend({ dxValidator: { validationRules: [{ type: 'required', message: 'We need your credentials' }] } }), //... }
To register the rules that are defined within the dxValidator objects, call the DevExpress.validationEngine.registerModelForValidation(model) function passing the ViewModel object as a parameter.
DevExpress.validationEngine.registerModelForValidation(viewModel);
To validate the rules that are defined within the dxValidator objects, call the DevExpress.validationEngine.validateModel(model) function passing the ViewModel object as a parameter.
DevExpress.validationEngine.registerModelForValidation(viewModel);
If you have technical questions, please create a support ticket in the DevExpress Support Center.