Hopiu/angular.js
1
0
Fork 0
mirror of https://github.com/Hopiu/angular.js.git synced 2026-05-28 15:28:15 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs(ngInclude): clarity, formatting

Browse source 
Closes #4222
This commit is contained in:
Dave Peticolas 2013-10-01 22:00:30 -07:00 committed by Pete Bacon Darwin
parent b5214aa20a
commit a005797afa
1 changed files with 13 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

27
src/ng/directive/ngInclude.js
View file

@ -8,20 +8,19 @@
* @description * @description
* Fetches, compiles and includes an external HTML fragment. * Fetches, compiles and includes an external HTML fragment.
* *
* Keep in mind that: * By default, the template URL is restricted to the same domain and protocol as the
* * application document. This is done by calling {@link ng.$sce#getTrustedResourceUrl
* - by default, the template URL is restricted to the same domain and protocol as the * $sce.getTrustedResourceUrl} on it. To load templates from other domains or protocols
* application document. This is done by calling {@link ng.$sce#getTrustedResourceUrl * you may either {@link ng.$sceDelegateProvider#resourceUrlWhitelist whitelist them} or
* $sce.getTrustedResourceUrl} on it. To load templates from other domains and/or protocols, * {@link ng.$sce#trustAsResourceUrl wrap them} as trusted values. Refer to Angular's {@link
* you may either either {@link ng.$sceDelegateProvider#resourceUrlWhitelist whitelist them} or * ng.$sce Strict Contextual Escaping}.
* {@link ng.$sce#trustAsResourceUrl wrap it} into a trusted value. Refer Angular's {@link *
* ng.$sce Strict Contextual Escaping}. * In addition, the browser's
* - in addition, the browser's * {@link https://code.google.com/p/browsersec/wiki/Part2#Same-origin_policy_for_XMLHttpRequest
* {@link https://code.google.com/p/browsersec/wiki/Part2#Same-origin_policy_for_XMLHttpRequest * Same Origin Policy} and {@link http://www.w3.org/TR/cors/ Cross-Origin Resource Sharing
* Same Origin Policy} and {@link http://www.w3.org/TR/cors/ Cross-Origin Resource Sharing * (CORS)} policy may further restrict whether the template is successfully loaded.
* (CORS)} policy apply that may further restrict whether the template is successfully loaded. * For example, `ngInclude` won't work for cross-domain requests on all browsers and for `file://`
* (e.g. ngInclude won't work for cross-domain requests on all browsers and for `file://` * access on some browsers.
* access on some browsers)
* *
* @animations * @animations
* enter - animation is used to bring new content into the browser. * enter - animation is used to bring new content into the browser.