diff options
Diffstat (limited to 'docs/content/guide/dev_guide.bootstrap.ngdoc')
| -rw-r--r-- | docs/content/guide/dev_guide.bootstrap.ngdoc | 86 | 
1 files changed, 86 insertions, 0 deletions
| diff --git a/docs/content/guide/dev_guide.bootstrap.ngdoc b/docs/content/guide/dev_guide.bootstrap.ngdoc new file mode 100644 index 00000000..49bb3a77 --- /dev/null +++ b/docs/content/guide/dev_guide.bootstrap.ngdoc @@ -0,0 +1,86 @@ +@workInProgress +@ngdoc overview +@name Developer Guide: Initializing Angular +@description + + +Initializing angular consists of loading the `angular.js` script in your page, and specifying how +angular should process and manage the page. To initialize angular you do the following: + + +* Specify the angular namespace in the `<html>` page +* Choose which flavor of angular script to load (debug or production) +* Specify whether or not angular should process and manage the page automatically (`ng:autobind`) + + +The simplest way to initialize angular is to load the angular script and tell angular to compile +and manage the whole page. You do this as follows: + + +<pre> +<!doctype html> +<html xmlns:ng="http://angularjs.org"> +  <head> +    ... +  </head> +  <body> +    ... +    <script src="angular.js" ng:autobind> +  </body> +</pre> + + + + +## Specifying the Angular Namespace + + +        <html xmlns:ng="http://angularjs.org"> + + +You need to declare the angular namespace declaration in the following cases: + + +* For all types of browser if you are using XHTML. +* For Internet Explorer older than version 9 (because older versions of IE do not render widgets +properly for either HTML or XHTML). + + + + +## Creating Your Own Namespaces + + +When you are ready to define your own {@link dev_guide.compiler.widgets widgets}, you must create +your own namespace in addition to specifying the angular namespace. You use your own namespace to +form the fully qualified name for widgets that you create. + + +For example, you could map the alias `my` to your domain, and create a widget called `my:widget`. +To create your own namespace, simply add another `xmlns` tag to your page, create an alias, and set +it to your unique domain: + + +        <html xmlns:ng="http://angularjs.org" xmlns:my="http://mydomain.com"> + + + + +## Loading the Angular Bootstrap Script + + +The angular bootstrap script comes in two flavors; a debug script, and a production script: + + +* angular-[version].js - This is a human-readable file, suitable for development and debugging. +* angular-[version].min.js - This is a compressed and obfuscated file, suitable for use in +production. + + + + +## Related Topics + + +* {@link dev_guide.bootstrap.auto_bootstrap Automatic Initialization} +* {@link dev_guide.bootstrap.manual_bootstrap Manual Initialization} | 
