@@ -1110,17 +1110,18 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', '$element', '$
1110
1110
* @element input
1111
1111
*
1112
1112
* @description
1113
- * Is a directive that tells Angular to do two-way data binding. It works together with `input`,
1114
- * `select`, `textarea`. You can easily write your own directives to use `ngModel` as well.
1113
+ * The `ngModel` directive binds an `input`,`select`, `textarea` (or custom form control) to a
1114
+ * property on the scope using {@link ng.directive:ngModel.NgModelController NgModelController},
1115
+ * which is created and exposed by this directive.
1115
1116
*
1116
1117
* `ngModel` is responsible for:
1117
1118
*
1118
- * - binding the view into the model, which other directives such as `input`, `textarea` or `select`
1119
- * require,
1120
- * - providing validation behavior (i.e. required, number, email, url),
1121
- * - keeping state of the control (valid/invalid, dirty/pristine, validation errors),
1122
- * - setting related css class onto the element (`ng-valid`, `ng-invalid`, `ng-dirty`, `ng-pristine`),
1123
- * - register the control with parent {@link ng.directive:form form}.
1119
+ * - Binding the view into the model, which other directives such as `input`, `textarea` or `select`
1120
+ * require.
1121
+ * - Providing validation behavior (i.e. required, number, email, url).
1122
+ * - Keeping the state of the control (valid/invalid, dirty/pristine, validation errors).
1123
+ * - Setting related css classes on the element (`ng-valid`, `ng-invalid`, `ng-dirty`, `ng-pristine`).
1124
+ * - Registering the control with its parent {@link ng.directive:form form}.
1124
1125
*
1125
1126
* Note: `ngModel` will try to bind to the property given by evaluating the expression on the
1126
1127
* current scope. If the property doesn't already exist on this scope, it will be created
0 commit comments