|
12 | 12 | * Typically, you don't use `ngBind` directly, but instead you use the double curly markup like
|
13 | 13 | * `{{ expression }}` which is similar but less verbose.
|
14 | 14 | *
|
15 |
| - * One scenario in which the use of `ngBind` is preferred over `{{ expression }}` binding is when |
16 |
| - * it's desirable to put bindings into template that is momentarily displayed by the browser in its |
17 |
| - * raw state before Angular compiles it. Since `ngBind` is an element attribute, it makes the |
18 |
| - * bindings invisible to the user while the page is loading. |
| 15 | + * It is preferrable to use `ngBind` instead of `{{ expression }}` when a template is momentarily |
| 16 | + * displayed by the browser in its raw state before Angular compiles it. Since `ngBind` is an |
| 17 | + * element attribute, it makes the bindings invisible to the user while the page is loading. |
19 | 18 | *
|
20 | 19 | * An alternative solution to this problem would be using the
|
21 | 20 | * {@link ng.directive:ngCloak ngCloak} directive.
|
@@ -61,10 +60,11 @@ var ngBindDirective = ngDirective(function(scope, element, attr) {
|
61 | 60 | *
|
62 | 61 | * @description
|
63 | 62 | * The `ngBindTemplate` directive specifies that the element
|
64 |
| - * text should be replaced with the template in ngBindTemplate. |
65 |
| - * Unlike ngBind the ngBindTemplate can contain multiple `{{` `}}` |
66 |
| - * expressions. (This is required since some HTML elements |
67 |
| - * can not have SPAN elements such as TITLE, or OPTION to name a few.) |
| 63 | + * text content should be replaced with the interpolation of the template |
| 64 | + * in the `ngBindTemplate` attribute. |
| 65 | + * Unlike `ngBind`, the `ngBindTemplate` can contain multiple `{{` `}}` |
| 66 | + * expressions. This directive is needed since some HTML elements |
| 67 | + * (such as TITLE and OPTION) cannot contain SPAN elements. |
68 | 68 | *
|
69 | 69 | * @element ANY
|
70 | 70 | * @param {string} ngBindTemplate template of form
|
|
0 commit comments