From bc76e7255b7b8e9f735bb23bf6d3a9814da268fe Mon Sep 17 00:00:00 2001 From: Luc Morin Date: Tue, 4 Jun 2013 20:12:31 +0100 Subject: docs(input): provide explanation of how ngModel will affect the local scope --- src/ng/directive/input.js | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) (limited to 'src') diff --git a/src/ng/directive/input.js b/src/ng/directive/input.js index b892e8c9..fd4ba746 100644 --- a/src/ng/directive/input.js +++ b/src/ng/directive/input.js @@ -1051,7 +1051,7 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', '$element', '$ * @element input * * @description - * Is directive that tells Angular to do two-way data binding. It works together with `input`, + * Is a directive that tells Angular to do two-way data binding. It works together with `input`, * `select`, `textarea`. You can easily write your own directives to use `ngModel` as well. * * `ngModel` is responsible for: @@ -1062,6 +1062,10 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', '$element', '$ * - keeping state of the control (valid/invalid, dirty/pristine, validation errors), * - setting related css class onto the element (`ng-valid`, `ng-invalid`, `ng-dirty`, `ng-pristine`), * - register the control with parent {@link ng.directive:form form}. + * + * Note: `ngModel` will try to bind to the property given by evaluating the expression on the + * current scope. If the property doesn't already exist on this scope, it will be created + * implicitly and added to the scope. * * For basic examples, how to use `ngModel`, see: * -- cgit v1.2.3