$compile: "the root of the template always gets a new scope..." What is it about? #15109

Activity

1. gkalpak commented on Sep 8, 2016

   

   gkalpak

   on Sep 8, 2016

   Member

   More actions

   I think this is a relic of the past and it basically refers to the root element of the application (which gets attached to $rootScope automatically.

   It was introduced back in 4804c83 (v1.0.0-rc.2). At that time, it seems that the HTML inside index.html was referred to as "the angular template" or "DOM template" or just "template".

   A few quotes from the (then) docs:

   About compilation:

   1. At application compile time, a root scope is created and is attached to the root <HTML> DOM element.
   2. During the compilation phase, the compiler matches directives against the DOM template. The directives usually fall into one of two categories:
      • Observing directives, such as double-curly expressions {{expression}}, register listeners using the $watch() method. This type of directive needs to be notified whenever the expression changes so that it can update the view.
      • Listener directives, such as ng:click, register a listener with the DOM. When the DOM listener fires, the directive executes the associated expression and updates the view using the $apply() method.

   About templates:

   The following code snippet shows a simple angular template made up of standard HTML tags along with angular directives, markup, and expressions:

   <html ng:app>
     <!-- Body tag augmented with ng:controller directive  -->
     <body ng:controller="MyController">
       <input ng:model="foo" value="bar">
       <!-- Button tag with ng:click directive, and string expression 'buttonText'
            wrapped in "{{ }}" markup -->
       <button ng:click="changeFoo()">{{buttonText}}</button>
       <script src="angular.js">
     </body>
   </html>
   

   In a simple single-page app, the template consists of HTML, CSS, and angular directives contained in just one HTML file (usually index.html). In a more complex app, you can display multiple views within one main page using "partials", which are segments of template located in separate HTML files.

   Iff my analysis is correct, we can get rid of that sentence altogether as it is confusing (and doesn't seem related to directives anyway).

   But I am just guessing here - there is always a chance it means something else...
2. gkalpak

   added

   type: docs

   component: $compile

   needs: investigation

   severity: confusing

   on Sep 8, 2016
3. gkalpak

   added this to the BacklogThis milestone has been deleted milestone on Sep 8, 2016
4. Narretz commented on Sep 9, 2016

   

   Narretz

   on Sep 9, 2016

   Contributor

   More actions

   I think we can remove it, as it doesn't really make anything clearer.
5. thorn0

   added 2 commits that reference this issue on Sep 9, 2016

   docs($compile): remove meaningless sentence

   ...

   This issue will close once commit cc94831 is merged into the 'master' branch.

   cc94831

   docs($compile): remove meaningless sentence

   ...

   This issue will close once commit 9f90f36 is merged into the 'master' branch.

   9f90f36
6. gkalpak

   closed this as completedin d14c7f3on Sep 10, 2016
7. gkalpak

   added a commit that references this issue on Sep 10, 2016

   docs($compile): remove obsolete sentence

   ...

   This issue will close once commit cdcd11e is merged into the 'master' branch.

   cdcd11e
8. petebacondarwin

   added 7 commits that reference this issue on Nov 21, 2016

   docs($compile): remove obsolete sentence

   ...

   This issue will close once commit 6c366e6 is merged into the 'master' branch.

   6c366e6

   docs($compile): remove obsolete sentence

   ...

   This issue will close once commit 0708192 is merged into the 'master' branch.

   0708192

   docs($compile): remove obsolete sentence

   ...

   This issue will close once commit aab4399 is merged into the 'master' branch.

   aab4399

   docs($compile): remove obsolete sentence

   ...

   This issue will close once commit a932e13 is merged into the 'master' branch.

   a932e13

   docs($compile): remove obsolete sentence

   ...

   This issue will close once commit f68de1f is merged into the 'master' branch.

   f68de1f

   docs($compile): remove obsolete sentence

   ...

   This issue will close once commit 22c3727 is merged into the 'master' branch.

   22c3727

   docs($compile): remove obsolete sentence

   ...

   This issue will close once commit 00b01e0 is merged into the 'master' branch.

   00b01e0
9. JonFerrera

   added a commit that references this issue on Sep 28, 2024

   docs($compile): remove obsolete sentence

   ...

   This issue will close once commit d14c7f3 is merged into the 'master' branch.

   d14c7f3