Angular 下的 function

angular.lowercas

将指定的字符串转换为小写的

Usage(使用方法)

angular.lowercase(string);

 

Arguments

 

Param	Type	Details
string	string	字符串转换成小写

Returns（返回）

string

小写字符串

angular.uppercase

将指定的字符串转换为大写的

Usage

angular.uppercase(string);

Arguments

Param	Type	Details
string	string	字符串转换成大写

Returns

string

大写字符串

 

angular.forEach

function in module ng(它是一个功能模块)调用迭代器函数去遍历每一个在对象集合里面的项目,它可以是一个对象或一个数组。

迭代器函数调用迭代器(值,键)，这个值是一个对象属性的值或者一个数组元素，另外

还有Key是对象属性键或索引数组元素，指定一个上下文的功能是可选的。

 

值得注意的是：.forEach不遍历继承的属性，是因为它是用的hasOwnProperyt方法来过滤的。

     var values = {name: 'misko', gender: 'male'};
     var log = [];
     angular.forEach(values, function(value, key) {
       this.push(key + ': ' + value);
     }, log);
     expect(log).toEqual(['name: misko', 'gender: male']);

使用方法

angular.forEach(obj, iterator, [context]);

Arguments

Param	Type	Details
obj	Object      Array	对象遍历
iterator	Function	对象函数
context (optional)	Object	此对象被指定为当天迭代函数的上下文

Returns

Object     Array

引用obj

 

angular.extend   （扩展）

从src对象复制所有的属性到dst，来扩展目标对象dst，您可以指定多个src对象。

Usage

angular.extend(dst, src);

Arguments

Param	Type	Details
dst	Object	目标对象
src	Object	源对象

Returns

Object

引用dst

 

angular.noop   [等待]

当一个函数执行操作的时候，当在功能类型里编写代码时这个函数非常有用。

     function foo(callback) {
       var result = calculateResult();
       (callback || angular.noop)(result);
     }

Usage

angular.noop();

 

angular.identity  【身份】

函数返回它的第一个参数，当在功能类型里编写代码时这个函数非常有用。

     function transformer(transformationFn, value) {
       return (transformationFn || angular.identity)(value);
     };

 

Usage

angular.identity();

 

 

angular.isUndefined  

确定是否引用的是  未定义

 

Usage

angular.isUndefined(value);

//

var cc = "ddd";

 // var cc;

 //这样的话就弹出 true

 //就是说angular.isUndefined(); 是判断定义了但没有初始化是用的

 console.log(angular.isUndefined(cc));

Arguments

Param	Type	Details
value	*	Reference to check.

Returns

boolean

如果值未定义返回true

 

angular.isDefined

确定是否引用的是  已定义

Usage

angular.isDefined(value);

Arguments

Param	Type	Details
value	*	Reference to check.

Returns

Boolean

如果值已定义返回true

 

angular.isNumber

确定是否引用的是  数值型

Usage

angular.isNumber(value);

/

 var cc = "ddd";

 var num = 33;

 console.log(angular.isNumber(cc)); // false

 console.log(angular.isNumber(num)); // true

Arguments

Param	Type	Details
value	*	Reference to check.

Returns

boolean

如果值是一个数字返回true

 

 

angular.isDate

确定是否引用的是  日期型对象

Usage

angular.isDate(value);

/

 var cc = "2014-12-12";

 var date = new Date();

 console.log(angular.isDate(cc)); // false

 console.log(angular.isDate(date)); // true

Arguments

Param	Type	Details
value	*	Reference to check.

Returns

boolean

是日期型的就返回true

angular.isArray

确定是否引用的是  数组对象

Usage

angular.isArray(value);

Arguments

Param	Type	Details
value	*	Reference to check.

Returns

boolean

如果是数组对象返回true

angular.isFunction

确定是否引用的是  函数

Usage

angular.isFunction(value);

Arguments

Param	Type	Details
value	*	Reference to check.

Returns

boolean

如果是一个函数就返回true

angular.isElement

确定是否引用的是  DOM元素 或者是一个JQuery 元素

Usage

angular.isElement(value);

Arguments

Param	Type	Details
value	*	Reference to check.

Returns

Boolean

如果是一个DOM元素或者是一个JQuery元素就返回true

 

angular.equals  (等于   相等)

确定是否两个对象或两个值是一样的。支持数值类型、正则表达式、数组和对象。

 

如果下面有一个是正确的，那么这两个对象或者数值就被看做是相等的

 

一：对象或者数值通过了 === 的比较

二： 两个相同类型的对象或值以及他们所有的属性都是相等的,他们都通过angular.equals来比较。

三：这两个值是 NAN（在Javascript中认为两个NAN是不相等的，但我们考虑用equal来比较是相等的）

四：两个相同的正则表达式来表示的值(In JavaScript, /abc/ == /abc/ => false.但我们考虑用equal来比较

是相等的当他们的文本进行匹配).

 

在属性比较期间，函数类型的属性和属性的名字前面的$将被忽略

Usage

angular.equals(o1, o2);

//

 var cc = "2014-12-12";

 var dd = "2014-12-12";

 var ee = "2014";

 console.log(angular.equals(cc, dd)); // true

 console.log(angular.equals(cc, ee)); // false

Arguments

Param	Type	Details
o1	*	对象或者是值进行比较
o2	*	对象或者是值进行比较

Returns

Boolean

如果比较的元素相等就返回true

angular.copy

创建一个深拷贝的源, 一个对象或数组.

• 如果没有提供目标,创建一个对象或数组的副本。
• 如果提供了目的标,所有的元素(数组)或属性(对象)被删除,然后从源复制到所有元素/属性。
• 如果源不是对象或数组(null和未定义),返回源。
• 如果来源是相同的“source”将抛出一个异常。

Usage

angular.copy(source, [destination]);   // 来源   目标

Arguments

Param	Type	Details
source	*	源,将用于复制。可以是任何类型,包括primitives(原语),null,未定义的。
destination (optional)	Oject  Array	复制源到目的地。如果需要,必须是相同类型的来源。

Returns

*	如果目标被指定了，目标将被拷贝或者被更新.

Example ：  http://www.ngnice.com/docs/api/ng/function/angular.copy

 

angular.bind

返回一个函数,调用函数fn绑定到自身(自身成为这个fn)。绑定之前为函数提供一个args参数。

这个特性也被称为偏函数用法，作为区别于函数局部套用。

 

Usage

angular.bind(self, fn, args);

Arguments

Param	Type	Details
self	Object	函数执行的上下文将被评估
fn	function()	函数被绑定。
args	*	可选参数在fn调用之前被绑定

Returns

function()

函数封装了fn与所有指定的绑定

 

 

angular.toJson

 

序列化为json格式的字符串输入. 属性前带有$符号的将被隔离，因为angular内部会用到$这个符号。

 

Usage

angular.toJson(obj, [pretty]);

Arguments

Param	Type	Details
obj	Object  Array  Date  sring number	输入被序列化为JSON
pretty (optional)	boolean	如果设置为真,那么JSON输出将包含换行和空白

Returns

string   undefined

JSON-合格的 字符串代表 obj.

 

angular.injector  注射器

创建一个注射器函数可用于检索服务和依赖注入（）

Usage

angular.injector(modules);

Arguments

Param	Type	Details
modules	Array.<string|function>	一列功能莫款

Returns

function()

注入器的功能. See $injector.

 

 

 

angular.module

angular.module 被创建在一个公共的环境里, 注册和检索Angular模块. 

所有的模块（angular核心或者是第三方）都需要用这种机制来注册下。

 

当两个或两个以上的参数传递,创建一个新模块。

如果只有一个参数,通过现有的模块(名称作为第一个参数传递给模块)检索。

Module

模块是一个服务集合、指令、控制器、过滤器、和配置信息

angular.module 用于配置注入器的

// Create a new module
var myModule = angular.module('myModule', []);

// register a new service
myModule.value('appName', 'MyCoolApp');

// configure existing services inside initialization blocks.
myModule.config(['$locationProvider', function($locationProvider) {
  // Configure existing providers
  $locationProvider.hashPrefix('!');
}]);

Then you can create an injector and load your modules like this:

var injector = angular.injector(['ng', 'myModule'])

However it's more likely that you'll just use ngApp or angular.bootstrap to simplify this process for you.

Usage

angular.module(name, [requires], [configFn]);

Arguments

Param	Type	Details
name	string	创建或检索模块的名称。
requires (optional)	!Array.<string>=	如果指定了那么创建新模块。如果未指定的,那么进行模块检索与进一步配置。
configFn (optional)	Function	可选配置功能模块。相同模块配置

Returns

module

新的模块去 angular.Module api.

 

 

 

angular.element

包装原始DOM元素或HTML字符串作为jQuery元素。

如果jQuery可用, angular.element 就是Jquery的一个小程序. 如果jQuery不可用,

angular.element将委托angular里的内置JQuery插件，称为“jQuery lite”或“jqLite”。

 

jqLite非常小，JQuery子集允许Angular操纵DOM跨浏览器兼容。

jqLite工具实现只有最常需要的功能它是一个非常小的封装。

 

在使用JQuery，在载入之前DOMContentLoaded已经被触发了

 

注释：所有的元素引用在Angular里都是被包装在JQuery或者jqLite中，他们不会生成DOM引用

Angular's jqLite

jqLite 只提供以下jQuery方法：

• addClass()
• after()
• append()
• attr()
• bind() -不支持名称空间, 选择器或eventData
• children() -不支持选择器
• clone()
• contents()
• css()
• data()
• empty()
• eq()
• find() - 局限于查找通过标签名
• hasClass()
• html()
• next() - 不支持选择器
• on() - 不支持名称空间, 选择器或eventData
• off() - 不支持名称空间或选择器吗
• one() - 不支持名称空间或选择器吗
• parent() - 不支持选择器
• prepend()
• prop()
• ready()
• remove()
• removeAttr()
• removeClass()
• removeData()
• replaceWith()
• text()
• toggleClass()
• triggerHandler() - 通过一个虚拟的事件对象处理程序
• unbind() - 不支持名称空间
• val()
• wrap()

jQuery/jqLite Extras

Angular 还提供以下额外的jQuery和jqLite方法和事件:

Events

• $destroy - AngularJS 阻拦了所有 jqLite/jQuery's DOM接口以及触发当前事件上
• 的所有DOM节点都被删除，这可以用于清理任何第三方绑定到DOM元素之前删除。

Methods

• controller(name) -获取当前元素或其父母的控制器，默认情况下检索与ngController相关控制器指令。
• 如果name提供驼峰指令名，那么这个指令的控制器将被检索(如。“ngModel”)。
• injector() -获取当前元素或其父母的注射器。
• scope() -获取当前元素或其父母的作用范围。
• isolateScope() - 如果直接附加到当前元素，那么检索一个隔离范围。这只应该使用getter元素包含一个指令,开始一个新的隔离范围。调用范围在这个元素总是返回原始non-isolate范围。
• inheritedData() -相同的数据但爬到DOM,直到找到一个值或达到顶级父元素。

Usage

angular.element(element);

///

 <p id="sss">dddd</p>

 <script type="text/javascript">

 var pp = document.getElementById('sss');

 angular.element(pp).addClass("aaa");

 </script>

Arguments

Param	Type	Details
element	string DOMElement	HTML字符串或DOMElement包裹到jQuery。

Returns

Object

jQuery object.