AngularJS API 参考

AngularJS API 文档

欢迎访问AngularJS API文档页面. 这些页面是对1.3.0-beta.15 unbelievable-advancement版本的AngularJS参考资料。

文档按多个模块的形式进行组织，每个模块包含AngularJS应用程序所需的包含各种组件，这些组件有 directives、services、filters、providers、templates、global APIs, 和 testing mocks。

Angular 命名空间 $ and $$ 为防止和你的代码的名称产生冲突，Angular公共对象的前缀名使用$ ，私有对象名使用$$。请不要在你的代码中使用 $或$$ 前缀。

Angular 命名空间

ng (核心模块)

这个模块是默认提供的，它包含了AngularJS的核心组件。

Directives	这些核心指令集可用于你的AngularJS应用的模板代码中。例如：ngClick, ngInclude, ngRepeat…
Services / Factories	这些核心服务集可通过依赖注入(DI)来供你的应用使用。例如：$compile, $http, $location…
Filters	这些ng模块中的核心过滤器用于在指令和表达式被渲染前转换模板数据。例如：filter, date, currency, lowercase, uppercase...
Global APIs	附加在angular对象上的核心公共API函数。这些核心函数对于你应用中的低级JavaScript操作很有用。例如：angular.copy(), angular.equals(), angular.element()...

ngRoute

使用ngRoute让你的应用具有URL路由功能。ngRoute模块支持hashbang和HTML5 pushState方式的URL管理。

你的应用要使用此功能，需导入angular-route.js文件，并且将ngRoute 设为依赖。

Services / Factories	下面这些服务用于路由管理： $routeParams 用于访问在URL中querystring中的值。 $route 用于当前被访问的路由的细节。 $routeProvider用于为应用注册路由。
Directives	ngView用于在页面中根据当前路由显示模板。

ngAnimate

Use ngAnimate to enable animation features into your application. Various core ng directives will provide animation hooks into your application when ngAnimate is included. Animations are defined by using CSS transitions/animations or JavaScript callbacks.

你的应用要使用此功能，需导入 angular-animate.js文件，并且将ngAnimate设为依赖。

Services / Factories	Use $animate to trigger animation operations within your directive code.
CSS-based animations	Follow ngAnimate’s CSS naming structure to reference CSS transitions / keyframe animations in AngularJS. Once defined the animation can be triggered by referencing the CSS class within the HTML template code.
JS-based animations	Use module.animation() to register a JavaScript animation. Once registered the animation can be triggered by referencing the CSS class within the HTML template code.

ngResource

Use the ngResource module when querying and posting data to a REST API.

你的应用要使用此功能，需导入 angular-resource.js文件，并且将ngResource设为依赖。

Services / Factories

The $resource service is used to define RESTful objects which communicate with a REST API.

ngCookies

Use the ngCookies module to handle cookie management within your application.

你的应用要使用此功能，需导入 angular-cookies.js文件，并且将ngCookies设为依赖。

Services / Factories

The following services are used for cookie management:

The $cookie service is a convenient wrapper to store simple data within browser cookies.
$cookieStore is used to store more complex data using serialization.

ngTouch

Use ngTouch when developing for mobile browsers/devices.

你的应用要使用此功能，需导入 angular-touch.js文件，并且将ngTouch设为依赖。

Services / Factories	The $swipe service is used to register and manage mobile DOM events.
Directives	Various directives are available in ngTouch to emulate mobile DOM events.

ngSanitize

Use ngSanitize to securely parse and manipulate HTML data in your application.

你的应用要使用此功能，需导入 angular-sanitize.js文件，并且将ngSanitize设为依赖。

Services / Factories	The $sanitize service is used to clean up dangerous HTML code in a quick and convenient way.
Filters	The linky filter is used to turn URLs into HTML links within the provided string.

ngMock

Use ngMock to inject and mock modules, factories, services and providers within your unit tests

要使用此功能，需导入angular-mocks.js文件到你的测试用例中。

Services / Factories

ngMock will extend the behavior of various core services to become testing aware and manageable in a synchronous manner.

Some examples include: $timeout, $interval, $log, $httpBackend, etc...

Global APIs

Various helper functions are available to inject and mock modules within unit test code.

Some examples inject(), module(), dump(), etc...