mirror of
https://github.com/Hopiu/angular.js.git
synced 2026-03-17 07:40:22 +00:00
65 lines
2.2 KiB
Text
65 lines
2.2 KiB
Text
@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}
|