Hopiu/angular.js
1
0
Fork 0
mirror of https://github.com/Hopiu/angular.js.git synced 2026-05-09 23:34:42 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs(ngModel): validators should return undefined for invalid values.

Browse source 
Closes #3525
This commit is contained in:
Niall Smart 2013-08-09 09:52:27 -07:00 committed by Igor Minar
parent 6da835f4bc
commit 1dd5d2ec1f
1 changed files with 7 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
src/ng/directive/input.js
View file

@ -794,8 +794,12 @@ var VALID_CLASS = 'ng-valid',
* @property {string} $viewValue Actual string value in the view. * @property {string} $viewValue Actual string value in the view.
* @property {*} $modelValue The value in the model, that the control is bound to. * @property {*} $modelValue The value in the model, that the control is bound to.
* @property {Array.<Function>} $parsers Array of functions to execute, as a pipeline, whenever * @property {Array.<Function>} $parsers Array of functions to execute, as a pipeline, whenever
* the control reads value from the DOM. Each function is called, in turn, passing the value the control reads value from the DOM. Each function is called, in turn, passing the value
* through to the next. Used to sanitize / convert the value as well as validation. through to the next. Used to sanitize / convert the value as well as validation.
For validation, the parsers should update the validity state using
{@link ng.directive:ngModel.NgModelController#$setValidity $setValidity()},
and return `undefined` for invalid values.
* *
* @property {Array.<Function>} $formatters Array of functions to execute, as a pipeline, whenever * @property {Array.<Function>} $formatters Array of functions to execute, as a pipeline, whenever
* the model value changes. Each function is called, in turn, passing the value through to the * the model value changes. Each function is called, in turn, passing the value through to the
@ -1005,11 +1009,9 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', '$element', '$
* For example {@link ng.directive:input input} or * For example {@link ng.directive:input input} or
* {@link ng.directive:select select} directives call it. * {@link ng.directive:select select} directives call it.
* *
* It internally calls all `parsers` (including validators) and updates the `$modelValue` and the actual model path. * It internally calls all `$parsers` (including validators) and updates the `$modelValue` and the actual model path.
* Lastly it calls all registered change listeners. * Lastly it calls all registered change listeners.
* *
* If validators determine the value is invalid, the `$modelValue` and the model path will be set to `undefined`.
*
* @param {string} value Value from the view. * @param {string} value Value from the view.
*/ */
this.$setViewValue = function(value) { this.$setViewValue = function(value) {