diff --git a/docs/AngularJS/Troubleshooting/common-issues.md b/docs/AngularJS/Troubleshooting/common-issues.md index c2efe6d714a..ec73d7a890b 100644 --- a/docs/AngularJS/Troubleshooting/common-issues.md +++ b/docs/AngularJS/Troubleshooting/common-issues.md @@ -51,6 +51,64 @@ The proper way to handle such unevaluated templates is to use a custom AngularJS Fore more details, refer to the [article on the priorities of AngularJS directives](https://docs.angularjs.org/api/ng/service/$compile). +### Widget With 'ng-model' Directive Does Not Reflect Model Value + +Since `Angular 1.4.9` widgets initialized from `SELECT` element **does not reflect changes to the model field**. This is due to a change in the Angular implementation related to `ngModel.$render`. In the new Angular versions, that method is **overridden** in favor +to a custom Angular implementation that supports adding custom `OPTION` elements. This enhancement, however, breaks our `ngModel` support, because we also depends on `ngModel.$render` method to reflect any changes done in the model. +Basically our [ngModel.$render](https://github.com/telerik/kendo-ui-core/blob/master/src/kendo.angular.js#L388) is **directly overridden** by the Angular new function. + +#### Solution + +The available workarounds in this case are: + +- Use `k-ng-model` directive instead. Check the [corresponding documentation](http://docs.telerik.com/kendo-ui/AngularJS/introduction#scope-bindings) for more details. +- Use `k-ng-delay` mapped to the `ng-model` model field. The purpose of this code is to postpone the `ngModel.$render` set on our side, hence it will win over the Angular `ngModel.$render` custom method + +##### Example using `ng-model` directive + +``` +