Why don't the AngularJS docs use a dot in the model directive?

Angularjs

Angularjs Problem Overview


In the video AngularJS MTV Meetup: Best Practices (2012/12/11), Miško explains "..if you use ng-model there has to be a dot somewhere. If you don't have a dot, you're doing it wrong.."

However, the very first example (The Basics) in the Angular.JS website seems to contradict it. What gives? Has Angular.JS changed since the MTV meetup that it's now more forgiving with ng-model?

Angularjs Solutions


Solution 1 - Angularjs

That little dot is very important when dealing with the complexities of scope inheritance.

The egghead.io video "The Dot" has a really good overview, as does this very popular stack overflow question: https://stackoverflow.com/questions/14049480/what-are-the-nuances-of-scope-prototypal-prototypical-inheritance-in-angularjs/14049482#14049482

I'll try to summarize it here:

Angular.js uses scope inheriting to allow a child scope (such as a child controller) to see the properties of the parent scope. So, let's say you had a setup like:

<div ng-controller="ParentCtrl">
    <input type="text" ng-model="foo"/>
    <div ng-controller="ChildCtrl">
        <input type="text" ng-model="foo"/>
    </div>
</div>

(Play along on a JSFiddle)

At first, if you started the app, and typed into the parent input, the child would update to reflect it.

However, if you edit the child scope, the connection to the parent is now broken, and the two no longer sync up. On the other hand, if you use ng-model="baz.bar", then the link will remain.

The reason this happens is because the child scope uses prototypical inheritance to look up the value, so as long as it never gets set on the child, then it will defer to the parent scope. But, once it's set, it no longer looks up the parent.

When you use an object (baz) instead, nothing ever gets set on the child scope, and the inheritance remains.

For more in-depth details, check out the StackOverflow answer

Solution 2 - Angularjs

Dot will be required when you prototypically inherit one scope from another for example in case of ng-repeat a new scope is created for every line item which prototypically inherits from parent scope. In the basic example there is no prototype inheritance since there is only one scope but if you have a number of child scopes then you will start facing the problem. The link below will make everything clear.

https://github.com/angular/angular.js/wiki/Understanding-Scopes#ng-repeat

Solution 3 - Angularjs

So to solve this, make sure in the JS you declare the parent first:

e.g.

$scope.parent

followed by:

$scope.parent.child = "Imma child";

doing just the child without the parent will break Angular.

Solution 4 - Angularjs

According to @OverZealous's answer, I thought up a dirty but comfortably simple and quick workaround for this:

$scope.$s = $scope
$scope.foo = 'hello'

Then use $s in template can safely modify model:

<input ng-model="$s.foo"/>

I wrote a service for such dirty works in my project.

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionsilvernightstarView Question on Stackoverflow
Solution 1 - AngularjsOverZealousView Answer on Stackoverflow
Solution 2 - AngularjsAjay BeniwalView Answer on Stackoverflow
Solution 3 - AngularjsShaheen KView Answer on Stackoverflow
Solution 4 - AngularjskuanyuiView Answer on Stackoverflow