AngularJS: API: ng

`ng`

ng (core module)

The ng module is loaded by default when an AngularJS application is started. The module itself contains the essential components for an AngularJS application to function. The table below lists a high level breakdown of each of the services/factories, filters, directives and testing components available within this core module.

模块组件

Function

名称	描述
angular.lowercase	转换指定的字符串到小写。
angular.uppercase	Converts the specified string to uppercase.
angular.forEach	Invokes the`iterator`function once for each item in`obj`collection, which can be either an object or an array. The`iterator`function is invoked with`iterator(value,key)`, where`value`is the value of an object property or an array element and`key`is the object property key or array element index. Specifying a`context`for the function is optional.
angular.extend	Extends the destination object`dst`by copying all of the properties from the`src`object(s) to`dst`. You can specify multiple`src`objects.
angular.noop	A function that performs no operations. 这个函数在使用函数风格写代码时很有用。 `Functionfoo(callback){varresult=calculateResult();(callback\|\|angular.noop)(result);}`
angular.identity	A function that returns its first argument. This function is useful when writing code in the functional style.
angular.isUndefined	检测引用是否未定义。
angular.isDefined	检测引用是否已定义。
angular.isObject	检测引用是否为一个`Object`. Unlike`typeof`in JavaScript,`null`s are not considered to be objects. Note that JavaScript arrays are objects.
angular.isString	检测引用是否是一个`String`.
angular.isNumber	检测引用是否是一个`Number`.
angular.isDate	检测值是否为日期。
angular.isArray	检测引用是否为一个`Array`.
angular.isFunction	检测引用是否是一个`Function`.
angular.isElement	检测引用是否为一个DOM元素（或是封装的jQuery元素）。
angular.copy	Creates a deep copy of`source`, which should be an object or an array.
angular.equals	Determines if two objects or two values are equivalent. Supports value types, regular expressions, arrays and objects.
angular.bind	Returns a function which calls function`fn`bound to`self`(`self`becomes the`this`for`fn`). You can supply optional`args`that are prebound to the function. This feature is also known aspartial application, as distinguished fromfunction currying.
angular.toJson	Serializes input into a JSON-formatted string. Properties with leading $$ characters will be stripped since angular uses this notation internally.
angular.fromJson	反序列化JSON字符串。
angular.bootstrap	Use this function to manually start up angular application.
angular.injector	Creates an injector function that can be used for retrieving services as well as for 依赖注入 (see依赖注入).
angular.element	Wraps a raw DOM element or HTML string as ajQueryelement.
angular.module	The`angular.module`is a global place for creating, registering and retrieving Angular modules. All modules (angular core or 3rd party) that should be available to an application must be registered using this mechanism.

Directive

名称	描述
ngApp	Use this directive toauto-bootstrapan AngularJS application. The`ngApp`directive designates theroot elementof the application and is typically placed near the root element of the page -例如 on theortags.
a	Modifies the default behavior of the html A tag so that the default action is prevented when the href attribute is empty.
ngHref	Using Angular markup like`{{hash}}`in an href attribute will make the link go to the wrong URL if the user clicks it before Angular has a chance to replace the`{{hash}}`markup with its value. Until Angular replaces the markup the link will be broken and will most likely return a 404 error.
ngSrc	Using Angular markup like`{{hash}}`in a`src`attribute doesn't work right: The browser will fetch from the URL with the literal text`{{hash}}`until Angular replaces the expression inside`{{hash}}`. The`ngSrc`directive solves this problem.
ngSrcset	Using Angular markup like`{{hash}}`in a`srcset`attribute doesn't work right: The browser will fetch from the URL with the literal text`{{hash}}`until Angular replaces the expression inside`{{hash}}`. The`ngSrcset`directive solves this problem.
ngDisabled	The following markup will make the button enabled on Chrome/Firefox but not on IE8 and older IEs: `ng-init="scope = { isDisabled: false }">disabled="{{scope.isDisabled}}">Disabled`
ngChecked	HTML规范不要求浏览器对布尔型属性必须给出值，例如checked(它们存在表示true，不存在表示false)。如果我们放置了一个Angular动态表达式到这样的属性上，在浏览器删除属性时绑定信息将会丢失。 The`ngChecked`directive solves this problem for the`checked`attribute. 这个指令不会被浏览器删除，并提供了一个永久的可靠的地方存放绑定信息。
ngReadonly	HTML规范不要求浏览器对布尔型属性必须给出值，例如readonly(它们存在表示true，不存在表示false)。如果我们放置了一个Angular动态表达式到这样的属性上，在浏览器删除属性时绑定信息将会丢失。 The`ngReadonly`directive solves this problem for the`readonly`attribute. 这个指令不会被浏览器删除，并提供了一个永久的可靠的地方存放绑定信息。
ngSelected	HTML规范不要求浏览器对布尔型属性必须给出值，例如selected(它们存在表示true，不存在表示false)。如果我们放置了一个Angular动态表达式到这样的属性上，在浏览器删除属性时绑定信息将会丢失。 The`ngSelected`directive solves this problem for the`selected`attribute. 这个指令不会被浏览器删除，并提供了一个永久的可靠的地方存放绑定信息。
ngOpen	HTML规范不要求浏览器对布尔型属性必须给出值，例如open(它们存在表示true，不存在表示false)。如果我们放置了一个Angular动态表达式到这样的属性上，在浏览器删除属性时绑定信息将会丢失。 The`ngOpen`directive solves this problem for the`open`attribute. 这个指令不会被浏览器删除，并提供了一个永久的可靠的地方存放绑定信息。
ngForm	可嵌套的`form`指令别名。HTML不允许form元素嵌套。 It is useful to nest forms, for example if the validity of a sub-group of controls needs to be determined.
form	Directive that instantiatesFormController.
textarea	HTML textarea element control with angular data-binding. The data-binding and validation properties of this element are exactly the same as those of theinput element.
input	HTML input element control with angular data-binding. Input control follows HTML5 input types and polyfills the HTML5 validation behavior for older browsers.
ngModel	The`ngModel`directive binds an`input`,`select`,`textarea`(or custom form control) to a property on the scope usingNgModelController, which is created and exposed by this directive.
ngChange	Evaluate the given expression when the user changes the input. The expression is evaluated immediately, unlike the JavaScript onchange event which only triggers at the end of a change (usually, when the user leaves the form element or presses the return key). The expression is not evaluated when the value change is coming from the model.
ngList	Text input that converts between a delimited string and an array of strings. The delimiter can be a fixed string (by default a comma) or a regular expression.
ngValue	Binds the given expression to the value of`input[select]`or`input[radio]`, so that when the element is selected, the`ngModel`of that element is set to the bound value.
ngModelOptions	Allows tuning how model updates are done. Using`ngModelOptions`you can specify a custom list of events that will trigger a model update and/or a debouncing delay so that the actual update only takes place when a timer expires; this timer will be reset after another change takes place.
ngBind	The`ngBind`attribute tells Angular to replace the text content of the specified HTML element with the value of a given expression, and to update the text content when the value of that expression changes.
ngBindTemplate	The`ngBindTemplate`directive specifies that the element text content should be replaced with the interpolation of the template in the`ngBindTemplate`attribute. Unlike`ngBind`, the`ngBindTemplate`can contain multiple`{{}}`expressions. This directive is needed since some HTML elements (such as TITLE and OPTION) cannot contain SPAN elements.
ngBindHtml	Creates a binding that will innerHTML the result of evaluating the`expression`into the current element in a secure way. 默认情况下， the innerHTML-ed content will be sanitized using the$sanitizeservice. To utilize this functionality, ensure that`$sanitize`is available, 例如，by including`ngSanitize`in your module's dependencies (not in core Angular.) You may also bypass sanitization for values you know are safe. To do so, bind to an explicitly trusted value via$sce.trustAsHtml. See the example underStrict Contextual Escaping (SCE).
ngClass	The`ngClass`directive allows you to dynamically set CSS classes on an HTML element by databinding an expression that represents all classes to be added.
ngClassOdd	The`ngClassOdd`and`ngClassEven`directives work exactly asngClass, except they work in conjunction with`ngRepeat`and take effect only on odd (even) rows.
ngClassEven	The`ngClassOdd`and`ngClassEven`directives work exactly asngClass, except they work in conjunction with`ngRepeat`and take effect only on odd (even) rows.
ngCloak	The`ngCloak`directive is used to prevent the Angular html template from being briefly displayed by the browser in its raw (uncompiled) form while your application is loading. Use this directive to avoid the undesirable flicker effect caused by the html template display.
ngController	The`ngController`directive attaches a controller class to the view. This is a key aspect of how angular supports the principles behind the Model-View-Controller design pattern.
ngCsp	EnablesCSP (Content Security Policy)support.
ngClick	The ngClick directive allows you to specify custom behavior when an element is clicked.
ngDblclick	The`ngDblclick`directive allows you to 指定自定义行为到a dblclick事件上。
ngMousedown	The ngMousedown directive allows you to 指定自定义行为到mousedown事件上。
ngMouseup	指定自定义行为到mouseup事件上。
ngMouseover	指定自定义行为到mouseover事件上。
ngMouseenter	指定自定义行为到mouseenter事件上。
ngMouseleave	指定自定义行为到mouseleave事件上。
ngMousemove	指定自定义行为到mousemove事件上。
ngKeydown	指定自定义行为到keydown事件上。
ngKeyup	指定自定义行为到keyup事件上。
ngKeypress	指定自定义行为到keypress事件上。
ngSubmit	Enables binding Angular表达式s to onsubmit events.
ngFocus	指定自定义行为到focus事件上。
ngBlur	指定自定义行为到blur事件上。
ngCopy	指定自定义行为到copy事件上。
ngCut	为剪切事件指定自定义行为。
ngPaste	指定自定义行为到paste事件上。
ngIf	The`ngIf`directive removes or recreates a portion of the DOM tree based on an {expression}. If the expression assigned to`ngIf`evaluates to a false value then the element is removed from the DOM, otherwise a clone of the element is reinserted into the DOM.
ngInclude	Fetches, compiles and includes an external HTML fragment.
ngInit	The`ngInit`directive allows you to evaluate an expression in the current scope.
ngNonBindable	The`ngNonBindable`directive tells Angular not to compile or bind the contents of the current DOM element. This is useful if the element contains what appears to be Angular directives and bindings but which should be ignored by Angular. This could be the case if you have a site that displays snippets of code, for instance.
ngPluralize	`ngPluralize`is a directive that displays messages according to en-US localization rules. These rules are bundled with angular.js, but can be overridden (seeAngular i18ndev guide). You configure ngPluralize directive by specifying the mappings between多元化条目and the strings to be displayed.
ngRepeat	The`ngRepeat`directive instantiates a template once per item from a collection. Each template instance gets its own scope, where the given loop variable is set to the current collection item, and`$index`is set to the item index or key.
ngShow	The`ngShow`directive shows or hides the given HTML element based on the expression provided to the ngShow attribute. The element is shown or hidden by removing or adding the`ng-hide`CSS class onto the element. The`.ng-hide`CSS class is predefined in AngularJS and sets the display style to none (using an !important flag). For CSP mode please add`angular-csp.css`to your html file (seengCsp).
ngHide	The`ngHide`directive shows or hides the given HTML element based on the expression provided to the ngHide attribute. The element is shown or hidden by removing or adding the`ng-hide`CSS class onto the element. The`.ng-hide`CSS class is predefined in AngularJS and sets the display style to none (using an !important flag). For CSP mode please add`angular-csp.css`to your html file (seengCsp).
ngStyle	The`ngStyle`directive allows you to set CSS style on an HTML element conditionally.
ngSwitch	The`ngSwitch`directive is used to conditionally swap DOM structure on your template based on a scope expression. Elements within`ngSwitch`but without`ngSwitchWhen`or`ngSwitchDefault`directives will be preserved at the location as specified in the template.
ngTransclude	Directive that marks the insertion point for the transcluded DOM of the nearest parent directive that uses transclusion.
script	Load the content of a