diff options
| author | Dave Peticolas | 2013-09-20 11:55:38 -0700 |
|---|---|---|
| committer | Pete Bacon Darwin | 2013-09-20 20:45:19 +0100 |
| commit | 602e226d36e04ccd1fa69e2cb5e3f23a48a2cf40 (patch) | |
| tree | 491460ece5278f25c17805070d9d262d28d0219d | |
| parent | f12c61e984e2fa7f6b225f3567d497f4ad36436d (diff) | |
| download | angular.js-602e226d36e04ccd1fa69e2cb5e3f23a48a2cf40.tar.bz2 | |
docs(ngCloak): fix grammar, clarity
Closes #4076
| -rw-r--r-- | src/ng/directive/ngCloak.js | 21 |
1 files changed, 11 insertions, 10 deletions
diff --git a/src/ng/directive/ngCloak.js b/src/ng/directive/ngCloak.js index 5c2bc21e..6e39bdfc 100644 --- a/src/ng/directive/ngCloak.js +++ b/src/ng/directive/ngCloak.js @@ -10,11 +10,12 @@ * displayed by the browser in its raw (uncompiled) form while your application is loading. Use this * directive to avoid the undesirable flicker effect caused by the html template display. * - * The directive can be applied to the `<body>` element, but typically a fine-grained application is - * preferred in order to benefit from progressive rendering of the browser view. + * The directive can be applied to the `<body>` element, but the preferred usage is to apply + * multiple `ngCloak` directives to small portions of the page to permit progressive rendering + * of the browser view. * - * `ngCloak` works in cooperation with a css rule that is embedded within `angular.js` and - * `angular.min.js` files. Following is the css rule: + * `ngCloak` works in cooperation with the following css rule embedded within `angular.js` and + * `angular.min.js`: * * <pre> * [ng\:cloak], [ng-cloak], [data-ng-cloak], [x-ng-cloak], .ng-cloak, .x-ng-cloak { @@ -23,17 +24,17 @@ * </pre> * * When this css rule is loaded by the browser, all html elements (including their children) that - * are tagged with the `ng-cloak` directive are hidden. When Angular comes across this directive - * during the compilation of the template it deletes the `ngCloak` element attribute, which - * makes the compiled element visible. + * are tagged with the `ngCloak` directive are hidden. When Angular encounters this directive + * during the compilation of the template it deletes the `ngCloak` element attribute, making + * the compiled element visible. * - * For the best result, `angular.js` script must be loaded in the head section of the html file; - * alternatively, the css rule (above) must be included in the external stylesheet of the + * For the best result, the `angular.js` script must be loaded in the head section of the html + * document; alternatively, the css rule above must be included in the external stylesheet of the * application. * * Legacy browsers, like IE7, do not provide attribute selector support (added in CSS 2.1) so they * cannot match the `[ng\:cloak]` selector. To work around this limitation, you must add the css - * class `ngCloak` in addition to `ngCloak` directive as shown in the example below. + * class `ngCloak` in addition to the `ngCloak` directive as shown in the example below. * * @element ANY * |