docs(ngView): add known issue about asynchronously loaded ngView

gkalpak · gkalpak · commit 26d1b34321e7 · 2016-04-13T18:45:40.000+03:00
Closes angular#14424
diff --git a/src/ngRoute/directive/ngView.js b/src/ngRoute/directive/ngView.js
@@ -26,6 +26,13 @@ ngRouteModule.directive('ngView', ngViewFillContentFactory);
  *
  * The enter and leave animation occur concurrently.
  *
+ * @knownIssue If `ngView` is contained in an asynchronously loaded template (e.g. in another
+ *             directive's templateUrl or in a template loaded using `ngInclude`), then you need to
+ *             make sure that `$route` is instantiated in time to capture the initial
+ *             `$locationChangeStart` event and load the appropriate view. One way to achieve this
+ *             is to have it as a dependency in a `.run` block:
+ *             `myModule.run(['$route', function() {}]);`
+ *
  * @scope
  * @priority 400
  * @param {string=} onload Expression to evaluate whenever the view updates.

Original file line number	Diff line number	Diff line change
`@@ -26,6 +26,13 @@ ngRouteModule.directive('ngView', ngViewFillContentFactory);`
`26`	`26`	`*`
`27`	`27`	`* The enter and leave animation occur concurrently.`
`28`	`28`	`*`
	`29`	+ * @knownIssue If `ngView` is contained in an asynchronously loaded template (e.g. in another
	`30`	+ * directive's templateUrl or in a template loaded using `ngInclude`), then you need to
	`31`	+ * make sure that `$route` is instantiated in time to capture the initial
	`32`	+ * `$locationChangeStart` event and load the appropriate view. One way to achieve this
	`33`	+ * is to have it as a dependency in a `.run` block:
	`34`	+ * `myModule.run(['$route', function() {}]);`
	`35`	`+ *`
`29`	`36`	`* @scope`
`30`	`37`	`* @priority 400`
`31`	`38`	`* @param {string=} onload Expression to evaluate whenever the view updates.`