AngularJS API Docs

Welcome to the AngularJS API docs page. These pages contain the AngularJS reference materials for version 1.2.6 taco-salsafication.

欢迎使用AngularJS API 文档页,这些页面含有了AngularJS (引用材料为1.2.6 taco-salsafication版本)

The documentation is organized into modules which contain various components of an AngularJS application. These components are directives, services, filters, providers, types, global APIs and testing mocks.

文档被组织化为模块(含有各种各样的组件的AngularJS 应用程序).这些模块是写指定、服务、过滤器、providers,类型、全局API和测试模块.

Angular Namespaces $ and $$To prevent accidental name collisions with your code, Angular prefixes names of public objects with $ and names of private objects with $$. Please do not use the $ or $$ prefix in your code.

Angular Namespaces $ 及$$ 用于阻止你程序中意外的命名冲突.公共的对象Angular用$前缀表示,私有的对象Angular 用$$前缀表示.请不要用这两个符号在你自己的代码对象中.

Angular Namespace Angular 命名空间

ng (core module)  ng核心模块

This module is provided by default and contains the core components of AngularJS.

该模块通默认提供,且含有核心AngularJS组件

Directives	This is the core collection of directives you would use in your template code to build an AngularJS application. 这是一个将会用于你的模板代码中的核心的指令集,你可以用这些指令集来创建一个AngularJS 程序. Some examples include: ngClick, ngInclude, ngRepeat, etc… 一些例子如:ngClick, ngInclude, ngRepeat等
Services / Factories	This is the core collection of services which are used within the DI of your application. 这是一个核心服务集合(这些核心服务集合用于你程序中的依赖注入) Some examples include: $compile, $http, $routeParams, $location, etc… 一些例子包含:$compile, $http, $routeParams, $location,等
Filters	The core filters available in the ng module are used to transform template data before it is renders within directives and expressions. 核心的过滤器集合(在ng module 可用),被用于传输模板数据(在这些模板数据渲染与指令集和表达式之前) 一些例子包含: filter, date, currency, lowercase, uppercase, etc...
Global APIs	The core global API functions are attached to the angular object. These core functions are useful for low level JavaScript operations within your application. 核心全局API函数,属于angular 对象中.这些函数很有用于你程序中的javascript操作. 一些例子包含: angular.copy(), angular.equals(), angular.element(), etc...

ngRoute

Use ngRoute to enable URL routing to your application. The ngRoute module supports URL management via both hashbang and HTML5 pushState.

使用ngRoute 可使你的程序URL拥有路由能力.该模块支持URL管理(通过hashbang 和HTML5 pushState

Include the angular-route.js file and set ngRoute as a dependency for this to work in your application.

其中包含angular-route.js 文件和在你的应用程序中将ngRoute设置为一个dependency 的功能.

Services / Factories	The following services are used for route management: 下面的服务被用于路由管理: $routeParamsis used to access the querystring values present in the URL. $routeParams 被用于访问querystring 值. $routeis used to access the details of the route that is currently being accessed. $route被用于访问当前路由的详请. $routeProvideris used to register routes for the application. 被用于给你的程序注册路由
Directives	The ngView directive will display the template of the current route within the page. The 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.

可使用ngAnimate 让你的程序用于动画特征.只要ngAnimate 被引入,各式各样的核心ng指令将给你的程序提供动画钩子.这些动画可使用css或者javascript回调来定义.

Include the angular-animate.js file and set ngAnimate as a dependency for this to work in your application.

其中包含angular-animate.js 文件和在你的应用程序中将ngRoute设置为一个dependency 的功能.

Services / Factories	Use $animate to trigger animation operations within your directive code. 可使用$animate 来触发你程序中的动画操作.
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. AngularJS中遵行ngAnimate的css命名结构来引用css transitions /keyframe 动画.因为定义的动画能够通过引用css类来触发.
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. 使用 来注册javascript动画.因为注册的动画能够通过引用css类来触发

ngResource

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

当get或post请求道rest api时,可使用ngResource 模块

Include the angular-resource.js file and set ngResource as a dependency for this to work in your application.

其中包含angular-resource.js 文件和在你的应用程序中将ngResource 设置为一个dependency 的功能.

Services / Factories

The $resource service is used to define RESTful objects which communicate with a REST API. $resource服务被用于定义restful对象(restful对象用于和rest api通信)

ngCookies

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

使用restful对象可在你的应用程序中操作cookie.

Include the angular-cookies.js file and set ngCookies as a dependency for this to work in your application.

其中包含angular-cookies.js 文件和在你的应用程序中将ngCookies 设置为一个dependency 的功能.

Services / Factories	The following services are used for cookie management: 下面的服务用于cookie管理. The $cookie service is a convenient wrapper to store simple data within browser cookies. $cookie是一个方便的封装(用来存储浏览器cookie中的简单数据) $cookieStoreis used to store more complex data using serialization. $cookieStroe被用于存储更多复杂的数据(通过序列化)

ngTouch

Use ngTouch when developing for mobile browsers/devices.

当开发手机等设备是,可使用ngTouch

Include the angular-touch.js file and set ngTouch as a dependency for this to work in your application.

其中包含angular-touch.js 文件和在你的应用程序中将ngTouch 设置为一个dependency 的功能.

Services / Factories	The $swipe service is used to register and manage mobile DOM events. $swipe 服务用于注册和管理手机dom事件
Directives	Various directives are available in ngTouch to emulate mobile DOM events. 各式各样的指定可用于ngTouch 来模仿手机dom事件.

ngSanitize

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

你的程序中可使用ngSanitize 可安全地转换和操作html数据.

Include the angular-sanitize.js file and set ngSanitize as a dependency for this to work in your application.

其中包含angular-sanitize.js 文件和在你的应用程序中将sanitize设置为一个dependency 的功能.

Services / Factories	The $sanitize service is used to clean up dangerous HTML code in a quick and convenient way. Sanitize服务被用于清理危险的html代码.
Filters	The linky filter is used to turn URLs into HTML links within the provided string. linky filter 用于将url转化为html连接.

ngMock

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

使用ngMock 可注入和mock模块、工厂、服务、providers

Include the angular-mocks.js file into your test runner for this to work.

其中包含 angular-mocks.js文件.

Services / Factories	ngMock will extend the behavior of various core services to become testing aware and manageable in a synchronous manner. ngMock将扩展各种核心服务的行为,可用于测试 例子包括: $timeout, $interval, $log, $httpBackend, etc...
Global APIs	Various helper functions are available to inject and mock modules within unit test code. 各种帮助函数可用于注入和mock模块(单元测试代码) 例子包括: inject(), module(), dump(), etc...