diff options
| author | Spencer | 2013-07-17 09:45:53 -0500 |
|---|---|---|
| committer | Pete Bacon Darwin | 2013-07-17 16:40:51 +0100 |
| commit | 1a8d83d6608f7c29116e4dc9dd565df21a4ae045 (patch) | |
| tree | 24368d994f3a5f7f6f973028f29986839e2f81a0 /src | |
| parent | c8b54ad16754a3ea7deae787ffbb8b3e447124b0 (diff) | |
| download | angular.js-1a8d83d6608f7c29116e4dc9dd565df21a4ae045.tar.bz2 | |
docs($templateCache): add examples of usage
Diffstat (limited to 'src')
| -rw-r--r-- | src/ng/cacheFactory.js | 40 |
1 files changed, 38 insertions, 2 deletions
diff --git a/src/ng/cacheFactory.js b/src/ng/cacheFactory.js index fb4c2c6b..a00c09a6 100644 --- a/src/ng/cacheFactory.js +++ b/src/ng/cacheFactory.js @@ -194,8 +194,44 @@ function $CacheFactoryProvider() { * @name ng.$templateCache * * @description - * Cache used for storing html templates. - * + * The first time a template is used, it is loaded in the tempalte cache for quick retrieval. You can + * load templates directly into the cache in a `script` tag, or by consuming the `$templateCache` + * service directly. + * + * Adding via the `script` tag: + * <pre> + * <html ng-app> + * <head> + * <script type="text/ng-template" id="templateId.html"> + * This is the content of the template + * </script> + * </head> + * ... + * </html> + * </pre> + * + * **Note:** the `script` tag containing the template does not need to be included in the `head` of the document, but + * it must be below the `ng-app` definition. + * + * Adding via the $templateCache service: + * + * <pre> + * var myApp = angular.module('myApp', []); + * myApp.run(function($templateCache) { + * $templateCache.put('templateId.html', 'This is the content of the template'); + * }); + * </pre> + * + * To retrieve the template later, simply use it in your HTML: + * <pre> + * <div ng-include=" 'templateId.html' "></div> + * </pre> + * + * or get it via Javascript: + * <pre> + * $templateCache.get('templateId.html') + * </pre> + * * See {@link ng.$cacheFactory $cacheFactory}. * */ |