From 82d90a409692e97a79c3bf4708ee80796c7de2d6 Mon Sep 17 00:00:00 2001 From: Igor Minar Date: Fri, 6 Apr 2012 16:35:17 -0700 Subject: fix(docs): change all directive references to use the normalized names --- src/ng/directive/a.js | 4 +- src/ng/directive/booleanAttrs.js | 44 +++++++++--------- src/ng/directive/form.js | 21 +++++---- src/ng/directive/input.js | 96 +++++++++++++++++++-------------------- src/ng/directive/ngBind.js | 40 +++++++++------- src/ng/directive/ngClass.js | 30 ++++++------ src/ng/directive/ngCloak.js | 12 ++--- src/ng/directive/ngController.js | 8 ++-- src/ng/directive/ngEventDirs.js | 56 +++++++++++------------ src/ng/directive/ngInclude.js | 17 +++---- src/ng/directive/ngInit.js | 6 +-- src/ng/directive/ngNonBindable.js | 6 +-- src/ng/directive/ngPluralize.js | 16 +++---- src/ng/directive/ngRepeat.js | 10 ++-- src/ng/directive/ngShowHide.js | 12 ++--- src/ng/directive/ngStyle.js | 6 +-- src/ng/directive/ngSwitch.js | 14 +++--- src/ng/directive/ngTransclude.js | 2 +- src/ng/directive/ngView.js | 12 ++--- src/ng/directive/script.js | 2 +- src/ng/directive/select.js | 26 +++++------ 21 files changed, 224 insertions(+), 216 deletions(-) (limited to 'src/ng/directive') diff --git a/src/ng/directive/a.js b/src/ng/directive/a.js index d96af784..04a77129 100644 --- a/src/ng/directive/a.js +++ b/src/ng/directive/a.js @@ -4,8 +4,8 @@ * Modifies the default behavior of html A tag, so that the default action is prevented when href * attribute is empty. * - * The reasoning for this change is to allow easy creation of action links with ng-click without - * changing the location or causing page reloads, e.g.: + * The reasoning for this change is to allow easy creation of action links with `ngClick` directive + * without changing the location or causing page reloads, e.g.: * Save */ var htmlAnchorDirective = valueFn({ diff --git a/src/ng/directive/booleanAttrs.js b/src/ng/directive/booleanAttrs.js index fee10ed8..c9f286fb 100644 --- a/src/ng/directive/booleanAttrs.js +++ b/src/ng/directive/booleanAttrs.js @@ -2,7 +2,7 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-href + * @name angular.module.ng.$compileProvider.directive.ngHref * @restrict A * * @description @@ -10,8 +10,7 @@ * the page open to a wrong URL, if the user clicks that link before * angular has a chance to replace the {{hash}} with actual URL, the * link will be broken and will most likely return a 404 error. - * The `ng-href` solves this problem by placing the `href` in the - * `ng-` namespace. + * The `ngHref` directive solves this problem. * * The buggy way to write it: *
@@ -24,7 +23,7 @@
  * 
* * @element A - * @param {template} ng-href any string which can contain `{{}}` markup. + * @param {template} ngHref any string which can contain `{{}}` markup. * * @example * This example uses `link` variable inside `href` attribute: @@ -83,15 +82,14 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-src + * @name angular.module.ng.$compileProvider.directive.ngSrc * @restrict A * * @description - * Using markup like `{{hash}}` in a `src` attribute doesn't + * 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 replaces the expression inside - * `{{hash}}`. The `ng-src` attribute solves this problem by placing - * the `src` attribute in the `ng-` namespace. + * text `{{hash}}` until Angular replaces the expression inside + * `{{hash}}`. The `ngSrc` directive solves this problem. * * The buggy way to write it: *
@@ -104,12 +102,12 @@
  * 
* * @element IMG - * @param {template} ng-src any string which can contain `{{}}` markup. + * @param {template} ngSrc any string which can contain `{{}}` markup. */ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-disabled + * @name angular.module.ng.$compileProvider.directive.ngDisabled * @restrict A * * @description @@ -124,7 +122,7 @@ * The HTML specs do not require browsers to preserve the special attributes such as disabled. * (The presence of them means true and absence means false) * This prevents the angular compiler from correctly retrieving the binding expression. - * To solve this problem, we introduce ng-disabled. + * To solve this problem, we introduce the `ngDisabled` directive. * * @example @@ -142,20 +140,20 @@ * * @element INPUT - * @param {string} expression Angular expression that will be evaluated. + * @param {expression} ngDisabled Angular expression that will be evaluated. */ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-checked + * @name angular.module.ng.$compileProvider.directive.ngChecked * @restrict A * * @description * The HTML specs do not require browsers to preserve the special attributes such as checked. * (The presence of them means true and absence means false) * This prevents the angular compiler from correctly retrieving the binding expression. - * To solve this problem, we introduce ng-checked. + * To solve this problem, we introduce the `ngChecked` directive. * @example @@ -172,20 +170,20 @@ * * @element INPUT - * @param {string} expression Angular expression that will be evaluated. + * @param {expression} ngChecked Angular expression that will be evaluated. */ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-multiple + * @name angular.module.ng.$compileProvider.directive.ngMultiple * @restrict A * * @description * The HTML specs do not require browsers to preserve the special attributes such as multiple. * (The presence of them means true and absence means false) * This prevents the angular compiler from correctly retrieving the binding expression. - * To solve this problem, we introduce ng-multiple. + * To solve this problem, we introduce the `ngMultiple` directive. * * @example @@ -208,20 +206,20 @@ * * @element SELECT - * @param {string} expression Angular expression that will be evaluated. + * @param {expression} ngMultiple Angular expression that will be evaluated. */ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-readonly + * @name angular.module.ng.$compileProvider.directive.ngReadonly * @restrict A * * @description * The HTML specs do not require browsers to preserve the special attributes such as readonly. * (The presence of them means true and absence means false) * This prevents the angular compiler from correctly retrieving the binding expression. - * To solve this problem, we introduce ng-readonly. + * To solve this problem, we introduce the `ngReadonly` directive. * @example @@ -244,14 +242,14 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-selected + * @name angular.module.ng.$compileProvider.directive.ngSelected * @restrict A * * @description * The HTML specs do not require browsers to preserve the special attributes such as selected. * (The presence of them means true and absence means false) * This prevents the angular compiler from correctly retrieving the binding expression. - * To solve this problem, we introduce ng-selected. + * To solve this problem, we introduced the `ngSelected` directive. * @example diff --git a/src/ng/directive/form.js b/src/ng/directive/form.js index f688b542..ecb47ebe 100644 --- a/src/ng/directive/form.js +++ b/src/ng/directive/form.js @@ -124,7 +124,7 @@ function FormController(element, attrs) { /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-form + * @name angular.module.ng.$compileProvider.directive.ngForm * @restrict EAC * * @description @@ -132,7 +132,7 @@ function FormController(element, attrs) { * does not allow nesting of form elements. It is useful to nest forms, for example if the validity of a * sub-group of controls needs to be determined. * - * @param {string=} ng-form|name Name of the form. If specified, the form controller will be published into + * @param {string=} ngForm|name Name of the form. If specified, the form controller will be published into * related scope, under this name. * */ @@ -149,11 +149,11 @@ function FormController(element, attrs) { * If `name` attribute is specified, the form controller is published onto the current scope under * this name. * - * # Alias: {@link angular.module.ng.$compileProvider.directive.ng-form `ng-form`} + * # Alias: {@link angular.module.ng.$compileProvider.directive.ngForm `ngForm`} * * In angular forms can be nested. This means that the outer form is valid when all of the child * forms are valid as well. However browsers do not allow nesting of `
` elements, for this - * reason angular provides {@link angular.module.ng.$compileProvider.directive.ng-form `ng-form`} alias + * reason angular provides {@link angular.module.ng.$compileProvider.directive.ngForm `ngForm`} alias * which behaves identical to `` but allows form nesting. * * @@ -177,19 +177,20 @@ function FormController(element, attrs) { * You can use one of the following two ways to specify what javascript method should be called when * a form is submitted: * - * - ng-submit on the form element (add link to ng-submit) - * - ng-click on the first button or input field of type submit (input[type=submit]) + * - {@link angular.module.ng.$compileProvider.directive.ngSubmit ngSubmit} directive on the form element + * - {@link angular.module.ng.$compileProvider.directive.ngClick ngClick} directive on the first + * button or input field of type submit (input[type=submit]) * - * To prevent double execution of the handler, use only one of ng-submit or ng-click. This is - * because of the following form submission rules coming from the html spec: + * To prevent double execution of the handler, use only one of ngSubmit or ngClick directives. This + * is because of the following form submission rules coming from the html spec: * * - If a form has only one input field then hitting enter in this field triggers form submit - * (`ng-submit`) + * (`ngSubmit`) * - if a form has has 2+ input fields and no buttons or input[type=submit] then hitting enter * doesn't trigger submit * - if a form has one or more input fields and one or more buttons or input[type=submit] then * hitting enter in any of the input fields will trigger the click handler on the *first* button or - * input[type=submit] (`ng-click`) *and* a submit handler on the enclosing form (`ng-submit`) + * input[type=submit] (`ngClick`) *and* a submit handler on the enclosing form (`ngSubmit`) * * @param {string=} name Name of the form. If specified, the form controller will be published into * related scope, under this name. diff --git a/src/ng/directive/input.js b/src/ng/directive/input.js index aab12e34..6366f901 100644 --- a/src/ng/directive/input.js +++ b/src/ng/directive/input.js @@ -13,17 +13,17 @@ var inputType = { * @description * Standard HTML text input with angular data binding. * - * @param {string} ng-model Assignable angular expression to data-bind to. + * @param {string} ngModel Assignable angular expression to data-bind to. * @param {string=} name Property name of the form under which the control is published. * @param {string=} required Sets `required` validation error key if the value is not entered. - * @param {number=} ng-minlength Sets `minlength` validation error key if the value is shorter than + * @param {number=} ngMinlength Sets `minlength` validation error key if the value is shorter than * minlength. - * @param {number=} ng-maxlength Sets `maxlength` validation error key if the value is longer than + * @param {number=} ngMaxlength Sets `maxlength` validation error key if the value is longer than * maxlength. - * @param {string=} ng-pattern Sets `pattern` validation error key if the value does not match the + * @param {string=} ngPattern Sets `pattern` validation error key if the value does not match the * RegExp pattern expression. Expected value is `/regexp/` for inline patterns or `regexp` for * patterns defined as scope expressions. - * @param {string=} ng-change Angular expression to be executed when input changes due to user + * @param {string=} ngChange Angular expression to be executed when input changes due to user * interaction with the input element. * * @example @@ -80,19 +80,19 @@ var inputType = { * Text input with number validation and transformation. Sets the `number` validation * error if not a valid number. * - * @param {string} ng-model Assignable angular expression to data-bind to. + * @param {string} ngModel Assignable angular expression to data-bind to. * @param {string=} name Property name of the form under which the control is published. * @param {string=} min Sets the `min` validation error key if the value entered is less then `min`. * @param {string=} max Sets the `max` validation error key if the value entered is greater then `min`. * @param {string=} required Sets `required` validation error key if the value is not entered. - * @param {number=} ng-minlength Sets `minlength` validation error key if the value is shorter than + * @param {number=} ngMinlength Sets `minlength` validation error key if the value is shorter than * minlength. - * @param {number=} ng-maxlength Sets `maxlength` validation error key if the value is longer than + * @param {number=} ngMaxlength Sets `maxlength` validation error key if the value is longer than * maxlength. - * @param {string=} ng-pattern Sets `pattern` validation error key if the value does not match the + * @param {string=} ngPattern Sets `pattern` validation error key if the value does not match the * RegExp pattern expression. Expected value is `/regexp/` for inline patterns or `regexp` for * patterns defined as scope expressions. - * @param {string=} ng-change Angular expression to be executed when input changes due to user + * @param {string=} ngChange Angular expression to be executed when input changes due to user * interaction with the input element. * * @example @@ -148,17 +148,17 @@ var inputType = { * Text input with URL validation. Sets the `url` validation error key if the content is not a * valid URL. * - * @param {string} ng-model Assignable angular expression to data-bind to. + * @param {string} ngModel Assignable angular expression to data-bind to. * @param {string=} name Property name of the form under which the control is published. * @param {string=} required Sets `required` validation error key if the value is not entered. - * @param {number=} ng-minlength Sets `minlength` validation error key if the value is shorter than + * @param {number=} ngMinlength Sets `minlength` validation error key if the value is shorter than * minlength. - * @param {number=} ng-maxlength Sets `maxlength` validation error key if the value is longer than + * @param {number=} ngMaxlength Sets `maxlength` validation error key if the value is longer than * maxlength. - * @param {string=} ng-pattern Sets `pattern` validation error key if the value does not match the + * @param {string=} ngPattern Sets `pattern` validation error key if the value does not match the * RegExp pattern expression. Expected value is `/regexp/` for inline patterns or `regexp` for * patterns defined as scope expressions. - * @param {string=} ng-change Angular expression to be executed when input changes due to user + * @param {string=} ngChange Angular expression to be executed when input changes due to user * interaction with the input element. * * @example @@ -213,14 +213,14 @@ var inputType = { * Text input with email validation. Sets the `email` validation error key if not a valid email * address. * - * @param {string} ng-model Assignable angular expression to data-bind to. + * @param {string} ngModel Assignable angular expression to data-bind to. * @param {string=} name Property name of the form under which the control is published. * @param {string=} required Sets `required` validation error key if the value is not entered. - * @param {number=} ng-minlength Sets `minlength` validation error key if the value is shorter than + * @param {number=} ngMinlength Sets `minlength` validation error key if the value is shorter than * minlength. - * @param {number=} ng-maxlength Sets `maxlength` validation error key if the value is longer than + * @param {number=} ngMaxlength Sets `maxlength` validation error key if the value is longer than * maxlength. - * @param {string=} ng-pattern Sets `pattern` validation error key if the value does not match the + * @param {string=} ngPattern Sets `pattern` validation error key if the value does not match the * RegExp pattern expression. Expected value is `/regexp/` for inline patterns or `regexp` for * patterns defined as scope expressions. * @@ -275,10 +275,10 @@ var inputType = { * @description * HTML radio button. * - * @param {string} ng-model Assignable angular expression to data-bind to. + * @param {string} ngModel Assignable angular expression to data-bind to. * @param {string} value The value to which the expression should be set when selected. * @param {string=} name Property name of the form under which the control is published. - * @param {string=} ng-change Angular expression to be executed when input changes due to user + * @param {string=} ngChange Angular expression to be executed when input changes due to user * interaction with the input element. * * @example @@ -316,11 +316,11 @@ var inputType = { * @description * HTML checkbox. * - * @param {string} ng-model Assignable angular expression to data-bind to. + * @param {string} ngModel Assignable angular expression to data-bind to. * @param {string=} name Property name of the form under which the control is published. - * @param {string=} ng-true-value The value to which the expression should be set when selected. - * @param {string=} ng-false-value The value to which the expression should be set when not selected. - * @param {string=} ng-change Angular expression to be executed when input changes due to user + * @param {string=} ngTrueValue The value to which the expression should be set when selected. + * @param {string=} ngFalseValue The value to which the expression should be set when not selected. + * @param {string=} ngChange Angular expression to be executed when input changes due to user * interaction with the input element. * * @example @@ -631,17 +631,17 @@ function checkboxInputType(scope, element, attr, ctrl) { * properties of this element are exactly the same as those of the * {@link angular.module.ng.$compileProvider.directive.input input element}. * - * @param {string} ng-model Assignable angular expression to data-bind to. + * @param {string} ngModel Assignable angular expression to data-bind to. * @param {string=} name Property name of the form under which the control is published. * @param {string=} required Sets `required` validation error key if the value is not entered. - * @param {number=} ng-minlength Sets `minlength` validation error key if the value is shorter than + * @param {number=} ngMinlength Sets `minlength` validation error key if the value is shorter than * minlength. - * @param {number=} ng-maxlength Sets `maxlength` validation error key if the value is longer than + * @param {number=} ngMaxlength Sets `maxlength` validation error key if the value is longer than * maxlength. - * @param {string=} ng-pattern Sets `pattern` validation error key if the value does not match the + * @param {string=} ngPattern Sets `pattern` validation error key if the value does not match the * RegExp pattern expression. Expected value is `/regexp/` for inline patterns or `regexp` for * patterns defined as scope expressions. - * @param {string=} ng-change Angular expression to be executed when input changes due to user + * @param {string=} ngChange Angular expression to be executed when input changes due to user * interaction with the input element. */ @@ -655,17 +655,17 @@ function checkboxInputType(scope, element, attr, ctrl) { * HTML input element control with angular data-binding. Input control follows HTML5 input types * and polyfills the HTML5 validation behavior for older browsers. * - * @param {string} ng-model Assignable angular expression to data-bind to. + * @param {string} ngModel Assignable angular expression to data-bind to. * @param {string=} name Property name of the form under which the control is published. * @param {string=} required Sets `required` validation error key if the value is not entered. - * @param {number=} ng-minlength Sets `minlength` validation error key if the value is shorter than + * @param {number=} ngMinlength Sets `minlength` validation error key if the value is shorter than * minlength. - * @param {number=} ng-maxlength Sets `maxlength` validation error key if the value is longer than + * @param {number=} ngMaxlength Sets `maxlength` validation error key if the value is longer than * maxlength. - * @param {string=} ng-pattern Sets `pattern` validation error key if the value does not match the + * @param {string=} ngPattern Sets `pattern` validation error key if the value does not match the * RegExp pattern expression. Expected value is `/regexp/` for inline patterns or `regexp` for * patterns defined as scope expressions. - * @param {string=} ng-change Angular expression to be executed when input changes due to user + * @param {string=} ngChange Angular expression to be executed when input changes due to user * interaction with the input element. * * @example @@ -760,7 +760,7 @@ var VALID_CLASS = 'ng-valid', /** * @ngdoc object - * @name angular.module.ng.$compileProvider.directive.ng-model.NgModelController + * @name angular.module.ng.$compileProvider.directive.ngModel.NgModelController * * @property {string} $viewValue Actual string value in the view. * @property {*} $modelValue The value in the model, that the control is bound to. @@ -813,8 +813,8 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', 'ngModel', '$e /** * @ngdoc function - * @name angular.module.ng.$compileProvider.directive.ng-model.NgModelController#$setValidity - * @methodOf angular.module.ng.$compileProvider.directive.ng-model.NgModelController + * @name angular.module.ng.$compileProvider.directive.ngModel.NgModelController#$setValidity + * @methodOf angular.module.ng.$compileProvider.directive.ngModel.NgModelController * * @description * Change the validity state, and notifies the form when the control changes validity. (i.e. it @@ -855,8 +855,8 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', 'ngModel', '$e /** * @ngdoc function - * @name angular.module.ng.$compileProvider.directive.ng-model.NgModelController#$setViewValue - * @methodOf angular.module.ng.$compileProvider.directive.ng-model.NgModelController + * @name angular.module.ng.$compileProvider.directive.ngModel.NgModelController#$setViewValue + * @methodOf angular.module.ng.$compileProvider.directive.ngModel.NgModelController * * @description * Read a value from view. @@ -925,15 +925,15 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', 'ngModel', '$e /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-model + * @name angular.module.ng.$compileProvider.directive.ngModel * * @element input * * @description * Is directive that tells Angular to do two-way data binding. It works together with `input`, - * `select`, `textarea`. You can easily write your own directives to use `ng-model` as well. + * `select`, `textarea`. You can easily write your own directives to use `ngModel` as well. * - * `ng-model` is responsible for: + * `ngModel` is responsible for: * * - binding the view into the model, which other directives such as `input`, `textarea` or `select` * require, @@ -942,7 +942,7 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', 'ngModel', '$e * - setting related css class onto the element (`ng-valid`, `ng-invalid`, `ng-dirty`, `ng-pristine`), * - register the control with parent {@link angular.module.ng.$compileProvider.directive.form form}. * - * For basic examples, how to use `ng-model`, see: + * For basic examples, how to use `ngModel`, see: * * - {@link angular.module.ng.$compileProvider.directive.input input} * - {@link angular.module.ng.$compileProvider.directive.input.text text} @@ -980,14 +980,14 @@ var ngModelDirective = [function() { /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-change + * @name angular.module.ng.$compileProvider.directive.ngChange * @restrict E * * @description * Evaluate given expression when user changes the input. * The expression is not evaluated when the value change is coming from the model. * - * Note, this directive requires `ng-model` to be present. + * Note, this directive requires `ngModel` to be present. * * @element input * @@ -1065,13 +1065,13 @@ var requiredDirective = [function() { /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-list + * @name angular.module.ng.$compileProvider.directive.ngList * * @description * Text input that converts between comma-seperated string into an array of strings. * * @element input - * @param {string=} ng-list optional delimiter that should be used to split the value. If + * @param {string=} ngList optional delimiter that should be used to split the value. If * specified in form `/something/` then the value will be converted into a regular expression. * * @example diff --git a/src/ng/directive/ngBind.js b/src/ng/directive/ngBind.js index 81541347..3c4a7d43 100644 --- a/src/ng/directive/ngBind.js +++ b/src/ng/directive/ngBind.js @@ -2,19 +2,27 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-bind + * @name angular.module.ng.$compileProvider.directive.ngBind * * @description - * The `ng-bind` attribute tells Angular to replace the text content of the specified HTML element + * 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. * - * Typically, you don't use `ng-bind` directly, but instead you use the double curly markup like - * `{{ expression }}` and let the Angular compiler transform it to - * `` when the template is compiled. + * Typically, you don't use `ngBind` directly, but instead you use the double curly markup like + * `{{ expression }}` which is similar but less verbose. + * + * Once scenario in which the use of `ngBind` is prefered over `{{ expression }}` binding is when + * it's desirable to put bindings into template that is momentarily displayed by the browser in its + * raw state before Angular compiles it. Since `ngBind` is an element attribute, it makes make the + * bindings invisible to the user while the page is loading. + * + * An alternative solution to this problem would be using the + * {@link angular.module.ng.$compileProvider.directive.ngCloak ngCloak} directive. + * * * @element ANY - * @param {expression} ng-bind {@link guide/dev_guide.expressions Expression} to evaluate. + * @param {expression} ngBind {@link guide/dev_guide.expressions Expression} to evaluate. * * @example * Enter a name in the Live Preview text box; the greeting below the text box changes instantly. @@ -49,18 +57,18 @@ var ngBindDirective = ngDirective(function(scope, element, attr) { /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-bind-html-unsafe + * @name angular.module.ng.$compileProvider.directive.ngBindHtmlUnsafe * * @description * Creates a binding that will innerHTML the result of evaluating the `expression` into the current * element. *The innerHTML-ed content will not be sanitized!* You should use this directive only if - * {@link angular.module.ng.$compileProvider.directive.ng-bind-html ng-bind-html} directive is too + * {@link angular.module.ng.$compileProvider.directive.ngBindHtml ngBindHtml} directive is too * restrictive and when you absolutely trust the source of the content you are binding to. * * See {@link angular.module.ng.$sanitize $sanitize} docs for examples. * * @element ANY - * @param {expression} ng-bind-html-unsafe {@link guide/dev_guide.expressions Expression} to evaluate. + * @param {expression} ngBindHtmlUnsafe {@link guide/dev_guide.expressions Expression} to evaluate. */ var ngBindHtmlUnsafeDirective = ngDirective(function(scope, element, attr) { element.addClass('ng-binding').data('$binding', attr.ngBindHtmlUnsafe); @@ -72,7 +80,7 @@ var ngBindHtmlUnsafeDirective = ngDirective(function(scope, element, attr) { /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-bind-html + * @name angular.module.ng.$compileProvider.directive.ngBindHtml * * @description * Creates a binding that will sanitize the result of evaluating the `expression` with the @@ -82,7 +90,7 @@ var ngBindHtmlUnsafeDirective = ngDirective(function(scope, element, attr) { * See {@link angular.module.ng.$sanitize $sanitize} docs for examples. * * @element ANY - * @param {expression} ng-bind-html {@link guide/dev_guide.expressions Expression} to evaluate. + * @param {expression} ngBindHtml {@link guide/dev_guide.expressions Expression} to evaluate. */ var ngBindHtmlDirective = ['$sanitize', function($sanitize) { return function(scope, element, attr) { @@ -98,17 +106,17 @@ var ngBindHtmlDirective = ['$sanitize', function($sanitize) { /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-bind-template + * @name angular.module.ng.$compileProvider.directive.ngBindTemplate * * @description - * The `ng-bind-template` attribute specifies that the element - * text should be replaced with the template in ng-bind-template. - * Unlike ng-bind the ng-bind-template can contain multiple `{{` `}}` + * The `ngBindTemplate` directive specifies that the element + * text should be replaced with the template in ngBindTemplate. + * Unlike ngBind the ngBindTemplate can contain multiple `{{` `}}` * expressions. (This is required since some HTML elements * can not have SPAN elements such as TITLE, or OPTION to name a few.) * * @element ANY - * @param {string} ng-bind-template template of form + * @param {string} ngBindTemplate template of form * {{ expression }} to eval. * * @example diff --git a/src/ng/directive/ngClass.js b/src/ng/directive/ngClass.js index 21b75dd0..1e9a260b 100644 --- a/src/ng/directive/ngClass.js +++ b/src/ng/directive/ngClass.js @@ -19,10 +19,10 @@ function classDirective(name, selector) { /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-class + * @name angular.module.ng.$compileProvider.directive.ngClass * * @description - * The `ng-class` allows you to set CSS class on HTML element dynamically by databinding an + * The `ngClass` allows you to set CSS class on HTML element dynamically by databinding an * expression that represents all classes to be added. * * The directive won't add duplicate classes if a particular class was already set. @@ -31,7 +31,7 @@ function classDirective(name, selector) { * new classes are added. * * @element ANY - * @param {expression} ng-class {@link guide/dev_guide.expressions Expression} to eval. The result + * @param {expression} ngClass {@link guide/dev_guide.expressions Expression} to eval. The result * of the evaluation can be a string representing space delimited class * names, an array, or a map of class names to boolean values. * @@ -65,18 +65,18 @@ var ngClassDirective = classDirective('', true); /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-class-odd + * @name angular.module.ng.$compileProvider.directive.ngClassOdd * * @description - * The `ng-class-odd` and `ng-class-even` works exactly as - * {@link angular.module.ng.$compileProvider.directive.ng-class ng-class}, except it works in conjunction with `ng-repeat` and - * takes affect only on odd (even) rows. + * The `ngClassOdd` and `ngClassEven` directives work exactly as + * {@link angular.module.ng.$compileProvider.directive.ngClass ngClass}, except it works in + * conjunction with `ngRepeat` and takes affect only on odd (even) rows. * * This directive can be applied only within a scope of an - * {@link angular.module.ng.$compileProvider.directive.ng-repeat ng-repeat}. + * {@link angular.module.ng.$compileProvider.directive.ngRepeat ngRepeat}. * * @element ANY - * @param {expression} ng-class-odd {@link guide/dev_guide.expressions Expression} to eval. The result + * @param {expression} ngClassOdd {@link guide/dev_guide.expressions Expression} to eval. The result * of the evaluation can be a string representing space delimited class names or an array. * * @example @@ -105,18 +105,18 @@ var ngClassOddDirective = classDirective('Odd', 0); /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-class-even + * @name angular.module.ng.$compileProvider.directive.ngClassEven * * @description - * The `ng-class-odd` and `ng-class-even` works exactly as - * {@link angular.module.ng.$compileProvider.directive.ng-class ng-class}, except it works in - * conjunction with `ng-repeat` and takes affect only on odd (even) rows. + * The `ngClassOdd` and `ngClassEven` works exactly as + * {@link angular.module.ng.$compileProvider.directive.ngClass ngClass}, except it works in + * conjunction with `ngRepeat` and takes affect only on odd (even) rows. * * This directive can be applied only within a scope of an - * {@link angular.module.ng.$compileProvider.directive.ng-repeat ng-repeat}. + * {@link angular.module.ng.$compileProvider.directive.ngRepeat ngRepeat}. * * @element ANY - * @param {expression} ng-class-even {@link guide/dev_guide.expressions Expression} to eval. The + * @param {expression} ngClassEven {@link guide/dev_guide.expressions Expression} to eval. The * result of the evaluation can be a string representing space delimited class names or an array. * * @example diff --git a/src/ng/directive/ngCloak.js b/src/ng/directive/ngCloak.js index 7422e15a..b548193b 100644 --- a/src/ng/directive/ngCloak.js +++ b/src/ng/directive/ngCloak.js @@ -2,28 +2,28 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-cloak + * @name angular.module.ng.$compileProvider.directive.ngCloak * * @description - * The `ng-cloak` directive is used to prevent the Angular html template from being briefly + * 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. * * The directive can be applied to the `` element, but typically a fine-grained application is * prefered in order to benefit from progressive rendering of the browser view. * - * `ng-cloak` works in cooperation with a css rule that is embedded within `angular.js` and + * `ngCloak` works in cooperation with a css rule that is embedded within `angular.js` and * `angular.min.js` files. Following is the css rule: * *
- * [ng\:cloak], .ng-cloak {
+ * [ng\:cloak], [ng-cloak], .ng-cloak {
  *   display: none;
  * }
  * 
* * When this css rule is loaded by the browser, all html elements (including their children) that * are tagged with the `ng-cloak` directive are hidden. When Angular comes across this directive - * during the compilation of the template it deletes the `ng-cloak` element attribute, which + * during the compilation of the template it deletes the `ngCloak` element attribute, which * makes the compiled element visible. * * For the best result, `angular.js` script must be loaded in the head section of the html file; @@ -32,7 +32,7 @@ * * Legacy browsers, like IE7, do not provide attribute selector support (added in CSS 2.1) so they * cannot match the `[ng\:cloak]` selector. To work around this limitation, you must add the css - * class `ng-cloak` in addition to `ng-cloak` directive as shown in the example below. + * class `ngCloak` in addition to `ngCloak` directive as shown in the example below. * * @element ANY * diff --git a/src/ng/directive/ngController.js b/src/ng/directive/ngController.js index 8e2c6f3b..55da78cd 100644 --- a/src/ng/directive/ngController.js +++ b/src/ng/directive/ngController.js @@ -2,17 +2,17 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-controller + * @name angular.module.ng.$compileProvider.directive.ngController * * @description - * The `ng-controller` directive assigns behavior to a scope. This is a key aspect of how angular + * The `ngController` directive assigns behavior to a scope. This is a key aspect of how angular * supports the principles behind the Model-View-Controller design pattern. * * MVC components in angular: * * * Model — The Model is data in scope properties; scopes are attached to the DOM. * * View — The template (HTML with data bindings) is rendered into the View. - * * Controller — The `ng-controller` directive specifies a Controller class; the class has + * * Controller — The `ngController` directive specifies a Controller class; the class has * methods that typically express the business logic behind the application. * * Note that an alternative way to define controllers is via the `{@link angular.module.ng.$route}` @@ -20,7 +20,7 @@ * * @element ANY * @scope - * @param {expression} ng-controller Name of a globally accessible constructor function or an + * @param {expression} ngController Name of a globally accessible constructor function or an * {@link guide/dev_guide.expressions expression} that on the current scope evaluates to a * constructor function. * diff --git a/src/ng/directive/ngEventDirs.js b/src/ng/directive/ngEventDirs.js index 74028fee..52375920 100644 --- a/src/ng/directive/ngEventDirs.js +++ b/src/ng/directive/ngEventDirs.js @@ -2,14 +2,14 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-click + * @name angular.module.ng.$compileProvider.directive.ngClick * * @description - * The ng-click allows you to specify custom behavior when + * The ngClick allows you to specify custom behavior when * element is clicked. * * @element ANY - * @param {expression} ng-click {@link guide/dev_guide.expressions Expression} to evaluate upon + * @param {expression} ngClick {@link guide/dev_guide.expressions Expression} to evaluate upon * click. (Event object is available as `$event`) * * @example @@ -55,118 +55,118 @@ forEach( /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-dblclick + * @name angular.module.ng.$compileProvider.directive.ngDblclick * * @description - * The ng-dblclick allows you to specify custom behavior on dblclick event. + * The `ngDblclick` directive allows you to specify custom behavior on dblclick event. * * @element ANY - * @param {expression} ng-dblclick {@link guide/dev_guide.expressions Expression} to evaluate upon + * @param {expression} ngDblclick {@link guide/dev_guide.expressions Expression} to evaluate upon * dblclick. (Event object is available as `$event`) * * @example - * See {@link angular.module.ng.$compileProvider.directive.ng-click ng-click} + * See {@link angular.module.ng.$compileProvider.directive.ngClick ngClick} */ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-mousedown + * @name angular.module.ng.$compileProvider.directive.ngMousedown * * @description - * The ng-mousedown allows you to specify custom behavior on mousedown event. + * The ngMousedown directive allows you to specify custom behavior on mousedown event. * * @element ANY - * @param {expression} ng-mousedown {@link guide/dev_guide.expressions Expression} to evaluate upon + * @param {expression} ngMousedown {@link guide/dev_guide.expressions Expression} to evaluate upon * mousedown. (Event object is available as `$event`) * * @example - * See {@link angular.module.ng.$compileProvider.directive.ng-click ng-click} + * See {@link angular.module.ng.$compileProvider.directive.ngClick ngClick} */ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-mouseup + * @name angular.module.ng.$compileProvider.directive.ngMouseup * * @description * Specify custom behavior on mouseup event. * * @element ANY - * @param {expression} ng-mouseup {@link guide/dev_guide.expressions Expression} to evaluate upon + * @param {expression} ngMouseup {@link guide/dev_guide.expressions Expression} to evaluate upon * mouseup. (Event object is available as `$event`) * * @example - * See {@link angular.module.ng.$compileProvider.directive.ng-click ng-click} + * See {@link angular.module.ng.$compileProvider.directive.ngClick ngClick} */ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-mouseover + * @name angular.module.ng.$compileProvider.directive.ngMouseover * * @description * Specify custom behavior on mouseover event. * * @element ANY - * @param {expression} ng-mouseover {@link guide/dev_guide.expressions Expression} to evaluate upon + * @param {expression} ngMouseover {@link guide/dev_guide.expressions Expression} to evaluate upon * mouseover. (Event object is available as `$event`) * * @example - * See {@link angular.module.ng.$compileProvider.directive.ng-click ng-click} + * See {@link angular.module.ng.$compileProvider.directive.ngClick ngClick} */ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-mouseenter + * @name angular.module.ng.$compileProvider.directive.ngMouseenter * * @description * Specify custom behavior on mouseenter event. * * @element ANY - * @param {expression} ng-mouseenter {@link guide/dev_guide.expressions Expression} to evaluate upon + * @param {expression} ngMouseenter {@link guide/dev_guide.expressions Expression} to evaluate upon * mouseenter. (Event object is available as `$event`) * * @example - * See {@link angular.module.ng.$compileProvider.directive.ng-click ng-click} + * See {@link angular.module.ng.$compileProvider.directive.ngClick ngClick} */ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-mouseleave + * @name angular.module.ng.$compileProvider.directive.ngMouseleave * * @description * Specify custom behavior on mouseleave event. * * @element ANY - * @param {expression} ng-mouseleave {@link guide/dev_guide.expressions Expression} to evaluate upon + * @param {expression} ngMouseleave {@link guide/dev_guide.expressions Expression} to evaluate upon * mouseleave. (Event object is available as `$event`) * * @example - * See {@link angular.module.ng.$compileProvider.directive.ng-click ng-click} + * See {@link angular.module.ng.$compileProvider.directive.ngClick ngClick} */ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-mousemove + * @name angular.module.ng.$compileProvider.directive.ngMousemove * * @description * Specify custom behavior on mousemove event. * * @element ANY - * @param {expression} ng-mousemove {@link guide/dev_guide.expressions Expression} to evaluate upon + * @param {expression} ngMousemove {@link guide/dev_guide.expressions Expression} to evaluate upon * mousemove. (Event object is available as `$event`) * * @example - * See {@link angular.module.ng.$compileProvider.directive.ng-click ng-click} + * See {@link angular.module.ng.$compileProvider.directive.ngClick ngClick} */ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-submit + * @name angular.module.ng.$compileProvider.directive.ngSubmit * * @description * Enables binding angular expressions to onsubmit events. @@ -175,7 +175,7 @@ forEach( * server and reloading the current page). * * @element form - * @param {expression} ng-submit {@link guide/dev_guide.expressions Expression} to eval. + * @param {expression} ngSubmit {@link guide/dev_guide.expressions Expression} to eval. * * @example diff --git a/src/ng/directive/ngInclude.js b/src/ng/directive/ngInclude.js index 6a656cb6..13a090a4 100644 --- a/src/ng/directive/ngInclude.js +++ b/src/ng/directive/ngInclude.js @@ -2,22 +2,23 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-include + * @name angular.module.ng.$compileProvider.directive.ngInclude * @restrict ECA * * @description * Fetches, compiles and includes an external HTML fragment. * * Keep in mind that Same Origin Policy applies to included resources - * (e.g. ng-include won't work for file:// access). + * (e.g. ngInclude won't work for cross-domain requests on all browsers and for + * file:// access on some browsers). * * @scope * - * @param {string} ng-include|src angular expression evaluating to URL. If the source is a string constant, + * @param {string} ngInclude|src angular expression evaluating to URL. If the source is a string constant, * make sure you wrap it in quotes, e.g. `src="'myPartialTemplate.html'"`. * @param {string=} onload Expression to evaluate when a new partial is loaded. * - * @param {string=} autoscroll Whether `ng-include` should call {@link angular.module.ng.$anchorScroll + * @param {string=} autoscroll Whether `ngInclude` should call {@link angular.module.ng.$anchorScroll * $anchorScroll} to scroll the viewport after the content is loaded. * * - If the attribute is not set, disable scrolling. @@ -65,11 +66,11 @@ /** * @ngdoc event - * @name angular.module.ng.$compileProvider.directive.ng-include#$includeContentLoaded - * @eventOf angular.module.ng.$compileProvider.directive.ng-include - * @eventType emit on the current ng-include scope + * @name angular.module.ng.$compileProvider.directive.ngInclude#$includeContentLoaded + * @eventOf angular.module.ng.$compileProvider.directive.ngInclude + * @eventType emit on the current ngInclude scope * @description - * Emitted every time the ng-include content is reloaded. + * Emitted every time the ngInclude content is reloaded. */ var ngIncludeDirective = ['$http', '$templateCache', '$anchorScroll', '$compile', function($http, $templateCache, $anchorScroll, $compile) { diff --git a/src/ng/directive/ngInit.js b/src/ng/directive/ngInit.js index cbd1b3ed..1fc1c96a 100644 --- a/src/ng/directive/ngInit.js +++ b/src/ng/directive/ngInit.js @@ -2,14 +2,14 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-init + * @name angular.module.ng.$compileProvider.directive.ngInit * * @description - * The `ng-init` attribute specifies initialization tasks to be executed + * The `ngInit` directive specifies initialization tasks to be executed * before the template enters execution mode during bootstrap. * * @element ANY - * @param {expression} ng-init {@link guide/dev_guide.expressions Expression} to eval. + * @param {expression} ngInit {@link guide/dev_guide.expressions Expression} to eval. * * @example diff --git a/src/ng/directive/ngNonBindable.js b/src/ng/directive/ngNonBindable.js index 2e9faa5a..6165c6f6 100644 --- a/src/ng/directive/ngNonBindable.js +++ b/src/ng/directive/ngNonBindable.js @@ -2,18 +2,18 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-non-bindable + * @name angular.module.ng.$compileProvider.directive.ngNonBindable * @priority 1000 * * @description * Sometimes it is necessary to write code which looks like bindings but which should be left alone - * by angular. Use `ng-non-bindable` to make angular ignore a chunk of HTML. + * by angular. Use `ngNonBindable` to make angular ignore a chunk of HTML. * * @element ANY * * @example * In this example there are two location where a simple binding (`{{}}`) is present, but the one - * wrapped in `ng-non-bindable` is left alone. + * wrapped in `ngNonBindable` is left alone. * * @example diff --git a/src/ng/directive/ngPluralize.js b/src/ng/directive/ngPluralize.js index a8cc40a6..ec5b24f4 100644 --- a/src/ng/directive/ngPluralize.js +++ b/src/ng/directive/ngPluralize.js @@ -2,15 +2,15 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-pluralize + * @name angular.module.ng.$compileProvider.directive.ngPluralize * @restrict EA * * @description * # Overview - * ng-pluralize is a directive that displays messages according to en-US localization rules. + * `ngPluralize` is a directive that displays messages according to en-US localization rules. * These rules are bundled with angular.js and the rules can be overridden - * (see {@link guide/dev_guide.i18n Angular i18n} dev guide). You configure ng-pluralize by - * specifying the mappings between + * (see {@link guide/dev_guide.i18n Angular i18n} dev guide). You configure ngPluralize directive + * by specifying the mappings between * {@link http://unicode.org/repos/cldr-tmp/trunk/diff/supplemental/language_plural_rules.html * plural categories} and the strings to be displayed. * @@ -24,8 +24,8 @@ * explicit number rule for "3" matches the number 3. You will see the use of plural categories * and explicit number rules throughout later parts of this documentation. * - * # Configuring ng-pluralize - * You configure ng-pluralize by providing 2 attributes: `count` and `when`. + * # Configuring ngPluralize + * You configure ngPluralize by providing 2 attributes: `count` and `when`. * You can also provide an optional attribute, `offset`. * * The value of the `count` attribute can be either a string or an {@link guide/dev_guide.expressions @@ -35,7 +35,7 @@ * string to be displayed. The value of the attribute should be a JSON object so that Angular * can interpret it correctly. * - * The following example shows how to configure ng-pluralize: + * The following example shows how to configure ngPluralize: * *
  * `{{personCount}}`. The closed braces `{}` is a placeholder
  * for {{numberExpression}}.
  *
- * # Configuring ng-pluralize with offset
+ * # Configuring ngPluralize with offset
  * The `offset` attribute allows further customization of pluralized text, which can result in
  * a better user experience. For example, instead of the message "4 people are viewing this document",
  * you might display "John, Kate and 2 others are viewing this document".
diff --git a/src/ng/directive/ngRepeat.js b/src/ng/directive/ngRepeat.js
index 82f8b9c7..66464c1b 100644
--- a/src/ng/directive/ngRepeat.js
+++ b/src/ng/directive/ngRepeat.js
@@ -2,10 +2,10 @@
 
 /**
  * @ngdoc directive
- * @name angular.module.ng.$compileProvider.directive.ng-repeat
+ * @name angular.module.ng.$compileProvider.directive.ngRepeat
  *
  * @description
- * The `ng-repeat` directive instantiates a template once per item from a collection. Each template
+ * 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.
  *
@@ -21,7 +21,7 @@
  * @element ANY
  * @scope
  * @priority 1000
- * @param {repeat_expression} ng-repeat The expression indicating how to enumerate a collection. Two
+ * @param {repeat_expression} ngRepeat The expression indicating how to enumerate a collection. Two
  *   formats are currently supported:
  *
  *   * `variable in expression` – where variable is the user defined loop variable and `expression`
@@ -36,7 +36,7 @@
  *
  * @example
  * This example initializes the scope to a list of names and
- * then uses `ng-repeat` to display every person:
+ * then uses `ngRepeat` to display every person:
     
       
         
@@ -68,7 +68,7 @@ var ngRepeatDirective = ngDirective({ var match = expression.match(/^\s*(.+)\s+in\s+(.*)\s*$/), lhs, rhs, valueIdent, keyIdent; if (! match) { - throw Error("Expected ng-repeat in form of '_item_ in _collection_' but got '" + + throw Error("Expected ngRepeat in form of '_item_ in _collection_' but got '" + expression + "'."); } lhs = match[1]; diff --git a/src/ng/directive/ngShowHide.js b/src/ng/directive/ngShowHide.js index 40a8a68e..df6bc243 100644 --- a/src/ng/directive/ngShowHide.js +++ b/src/ng/directive/ngShowHide.js @@ -2,14 +2,14 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-show + * @name angular.module.ng.$compileProvider.directive.ngShow * * @description - * The `ng-show` and `ng-hide` directives show or hide a portion of the DOM tree (HTML) + * The `ngShow` and `ngHide` directives show or hide a portion of the DOM tree (HTML) * conditionally. * * @element ANY - * @param {expression} ng-show If the {@link guide/dev_guide.expressions expression} is truthy + * @param {expression} ngShow If the {@link guide/dev_guide.expressions expression} is truthy * then the element is shown or hidden respectively. * * @example @@ -42,14 +42,14 @@ var ngShowDirective = ngDirective(function(scope, element, attr){ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-hide + * @name angular.module.ng.$compileProvider.directive.ngHide * * @description - * The `ng-hide` and `ng-show` directives hide or show a portion + * The `ngHide` and `ngShow` directives hide or show a portion * of the HTML conditionally. * * @element ANY - * @param {expression} ng-hide If the {@link guide/dev_guide.expressions expression} truthy then + * @param {expression} ngHide If the {@link guide/dev_guide.expressions expression} truthy then * the element is shown or hidden respectively. * * @example diff --git a/src/ng/directive/ngStyle.js b/src/ng/directive/ngStyle.js index 8a4e7458..c24c1b6d 100644 --- a/src/ng/directive/ngStyle.js +++ b/src/ng/directive/ngStyle.js @@ -2,13 +2,13 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-style + * @name angular.module.ng.$compileProvider.directive.ngStyle * * @description - * The ng-style allows you to set CSS style on an HTML element conditionally. + * The `ngStyle` directive allows you to set CSS style on an HTML element conditionally. * * @element ANY - * @param {expression} ng-style {@link guide/dev_guide.expressions Expression} which evals to an + * @param {expression} ngStyle {@link guide/dev_guide.expressions Expression} which evals to an * object whose keys are CSS style names and values are corresponding values for those CSS * keys. * diff --git a/src/ng/directive/ngSwitch.js b/src/ng/directive/ngSwitch.js index 16b0c4d4..52b501a6 100644 --- a/src/ng/directive/ngSwitch.js +++ b/src/ng/directive/ngSwitch.js @@ -2,26 +2,26 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-switch + * @name angular.module.ng.$compileProvider.directive.ngSwitch * @restrict EA * * @description * Conditionally change the DOM structure. * * @usageContent - * ... - * ... + * ... + * ... * ... - * ... + * ... * * @scope - * @param {*} ng-switch|on expression to match against ng-switch-when. + * @param {*} ngSwitch|on expression to match against ng-switch-when. * @paramDescription * On child elments add: * - * * `ng-switch-when`: the case statement to match against. If match then this + * * `ngSwitchWhen`: the case statement to match against. If match then this * case will be displayed. - * * `ng-switch-default`: the default case when no other casses match. + * * `ngSwitchDefault`: the default case when no other casses match. * * @example diff --git a/src/ng/directive/ngTransclude.js b/src/ng/directive/ngTransclude.js index ab4011f0..aab61640 100644 --- a/src/ng/directive/ngTransclude.js +++ b/src/ng/directive/ngTransclude.js @@ -2,7 +2,7 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-transclude + * @name angular.module.ng.$compileProvider.directive.ngTransclude * * @description * Insert the transcluded DOM here. diff --git a/src/ng/directive/ngView.js b/src/ng/directive/ngView.js index b305af0b..4f6a70ba 100644 --- a/src/ng/directive/ngView.js +++ b/src/ng/directive/ngView.js @@ -2,12 +2,12 @@ /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-view + * @name angular.module.ng.$compileProvider.directive.ngView * @restrict ECA * * @description * # Overview - * `ng-view` is a directive that complements the {@link angular.module.ng.$route $route} service by + * `ngView` is a directive that complements the {@link angular.module.ng.$route $route} service by * including the rendered template of the current route into the main layout (`index.html`) file. * Every time the current route changes, the included view changes with it according to the * configuration of the `$route` service. @@ -97,11 +97,11 @@ /** * @ngdoc event - * @name angular.module.ng.$compileProvider.directive.ng-view#$viewContentLoaded - * @eventOf angular.module.ng.$compileProvider.directive.ng-view - * @eventType emit on the current ng-view scope + * @name angular.module.ng.$compileProvider.directive.ngView#$viewContentLoaded + * @eventOf angular.module.ng.$compileProvider.directive.ngView + * @eventType emit on the current ngView scope * @description - * Emitted every time the ng-view content is reloaded. + * Emitted every time the ngView content is reloaded. */ var ngViewDirective = ['$http', '$templateCache', '$route', '$anchorScroll', '$compile', '$controller', diff --git a/src/ng/directive/script.js b/src/ng/directive/script.js index 4090ae24..dcbd97b1 100644 --- a/src/ng/directive/script.js +++ b/src/ng/directive/script.js @@ -6,7 +6,7 @@ * * @description * Load content of a script tag, with type `text/ng-template`, into `$templateCache`, so that the - * template can be used by `ng-include`, `ng-view` or directive templates. + * template can be used by `ngInclude`, `ngView` or directive templates. * * @restrict E * @param {'text/ng-template'} type must be set to `'text/ng-template'` diff --git a/src/ng/directive/select.js b/src/ng/directive/select.js index b70339fc..384b312e 100644 --- a/src/ng/directive/select.js +++ b/src/ng/directive/select.js @@ -8,34 +8,34 @@ * @description * HTML `SELECT` element with angular data-binding. * - * # `ng-options` + * # `ngOptions` * - * Optionally `ng-options` attribute can be used to dynamically generate a list of `