diff options
| author | Igor Minar | 2012-04-06 16:35:17 -0700 |
|---|---|---|
| committer | Igor Minar | 2012-04-09 09:52:27 -0700 |
| commit | 82d90a409692e97a79c3bf4708ee80796c7de2d6 (patch) | |
| tree | b682f2d3042381e2456383f9c9333d30105febf8 /src | |
| parent | 7468bcb80b997e323bb0808d19ee215cc5f7ae84 (diff) | |
| download | angular.js-82d90a409692e97a79c3bf4708ee80796c7de2d6.tar.bz2 | |
fix(docs): change all directive references to use the normalized names
Diffstat (limited to 'src')
28 files changed, 239 insertions, 232 deletions
diff --git a/src/Angular.js b/src/Angular.js index c0da2174..c5b70e3c 100644 --- a/src/Angular.js +++ b/src/Angular.js @@ -435,7 +435,7 @@ function makeMap(str){ /** - * HTML class which is the only class which can be used in ng-bind to inline HTML for security + * HTML class which is the only class which can be used in ngBind to inline HTML for security * reasons. * * @constructor @@ -873,10 +873,10 @@ function encodeUriQuery(val, pctEncodeSpaces) { /** * @ngdoc directive - * @name angular.module.ng.$compileProvider.directive.ng-app + * @name angular.module.ng.$compileProvider.directive.ngApp * * @element ANY - * @param {angular.Module} ng-app on optional application + * @param {angular.Module} ngApp on optional application * {@link angular.module module} name to load. * * @description @@ -886,11 +886,11 @@ function encodeUriQuery(val, pctEncodeSpaces) { * designates the root of the application and is typically placed * ot the root of the page. * - * In the example below if the `ng-app` directive would not be placed + * In the example below if the `ngApp` directive would not be placed * on the `html` element then the document would not be compiled * and the `{{ 1+2 }}` would not be resolved to `3`. * - * `ng-app` is the easiest way to bootstrap an application. + * `ngApp` is the easiest way to bootstrap an application. * <doc:example> <doc:source> diff --git a/src/jqLite.js b/src/jqLite.js index 007deaa8..cb533a5e 100644 --- a/src/jqLite.js +++ b/src/jqLite.js @@ -61,7 +61,7 @@ * ## In addtion to the above, Angular privides an additional method to both jQuery and jQuery lite: * * - `controller(name)` - retrieves the controller of the current element or its parent. By default - * retrieves controller associated with the `ng-controller` directive. If `name` is provided as + * retrieves controller associated with the `ngController` directive. If `name` is provided as * camelCase directive name, then the controller for this directive will be retrieved (e.g. * `'ngModel'`). * - `injector()` - retrieves the injector of the current element or its parent. diff --git a/src/loader.js b/src/loader.js index b25fc40e..e0dd8d7f 100644 --- a/src/loader.js +++ b/src/loader.js @@ -54,7 +54,7 @@ function setupModuleLoader(window) { * </pre> * * However it's more likely that you'll just use - * {@link angular.module.ng.$compileProvider.directive.ng-app ng-app} or + * {@link angular.module.ng.$compileProvider.directive.ngApp ngApp} or * {@link angular.bootstrap} to simplify this process for you. * * @param {!string} name The name of the module to create or retrieve. diff --git a/src/ng/compiler.js b/src/ng/compiler.js index bbbcedb7..912b068a 100644 --- a/src/ng/compiler.js +++ b/src/ng/compiler.js @@ -15,7 +15,7 @@ * instance functions into a single template function which is then returned. * * The template function can then be used once to produce the view or as it is the case with - * {@link angular.module.ng.$compileProvider.directive.ng-repeat repeater} many-times, in which + * {@link angular.module.ng.$compileProvider.directive.ngRepeat repeater} many-times, in which * case each call results in a view that is a DOM clone of the original template. * <doc:example module="compile"> 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.: * <a href="" ng-click="model.$save()">Save</a> */ 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: * <pre> @@ -24,7 +23,7 @@ * </pre> * * @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 <angular/> 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 <angular/> 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: * <pre> @@ -104,12 +102,12 @@ * </pre> * * @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 <doc:example> @@ -142,20 +140,20 @@ </doc:example> * * @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 <doc:example> <doc:source> @@ -172,20 +170,20 @@ </doc:example> * * @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 <doc:example> @@ -208,20 +206,20 @@ </doc:example> * * @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 <doc:example> <doc:source> @@ -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 <doc:example> <doc:source> 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 `<form>` 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 `<form>` 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 - * `<span ng-bind="expression"></span>` 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 * <tt>{{</tt> <tt>expression</tt> <tt>}}</tt> 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 `<body>` 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: * * <pre> - * [ng\:cloak], .ng-cloak { + * [ng\:cloak], [ng-cloak], .ng-cloak { * display: none; * } * </pre> * * 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 <doc: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 <doc: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 <doc: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: * * <pre> * <ng-pluralize count="personCount" @@ -56,7 +56,7 @@ * <span ng-non-bindable>`{{personCount}}`</span>. The closed braces `{}` is a placeholder * for <span ng-non-bindable>{{numberExpression}}</span>. * - * # 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: <doc:example> <doc:source> <div ng-init="friends = [{name:'John', age:25}, {name:'Mary', age:28}]"> @@ -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 - * <any ng-switch-when="matchValue1">...</any> - * <any ng-switch-when="matchValue2">...</any> + * <ANY ng-switch-when="matchValue1">...</ANY> + * <ANY ng-switch-when="matchValue2">...</ANY> * ... - * <any ng-switch-default>...</any> + * <ANY ng-switch-default>...</ANY> * * @scope - * @param {*} ng-switch|on expression to match against <tt>ng-switch-when</tt>. + * @param {*} ngSwitch|on expression to match against <tt>ng-switch-when</tt>. * @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 <doc: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 `<option>` + * Optionally `ngOptions` attribute can be used to dynamically generate a list of `<option>` * elements for a `<select>` element using an array or an object obtained by evaluating the - * `ng-options` expression. + * `ngOptions` expression. *˝˝ * When an item in the select menu is select, the value of array element or object property - * represented by the selected option will be bound to the model identified by the `ng-model` attribute - * of the parent select element. + * represented by the selected option will be bound to the model identified by the `ngModel` + * directive of the parent select element. * * Optionally, a single hard-coded `<option>` element, with the value set to an empty string, can * be nested into the `<select>` element. This element will then represent `null` or "not selected" * option. See example below for demonstration. * - * Note: `ng-options` provides iterator facility for `<option>` element which must be used instead - * of {@link angular.module.ng.$compileProvider.directive.ng-repeat ng-repeat}. `ng-repeat` is not suitable for use with - * `<option>` element because of the following reasons: + * Note: `ngOptions` provides iterator facility for `<option>` element which must be used instead + * of {@link angular.module.ng.$compileProvider.directive.ngRepeat ngRepeat}. `ngRepeat` is not + * suitable for use with `<option>` element because of the following reasons: * * * value attribute of the option element that we need to bind to requires a string, but the * source of data for the iteration might be in a form of array containing objects instead of * strings - * * {@link angular.module.ng.$compileProvider.directive.ng-repeat ng-repeat} unrolls after the select binds causing - * incorect rendering on most browsers. + * * {@link angular.module.ng.$compileProvider.directive.ngRepeat ngRepeat} unrolls after the + * select binds causing incorect rendering on most browsers. * * binding to a value not in list confuses most browsers. * * @param {string} name assignable expression to data-bind to. * @param {string=} required The control is considered valid only if value is entered. - * @param {comprehension_expression=} ng-options in one of the following forms: + * @param {comprehension_expression=} ngOptions in one of the following forms: * * * for array data sources: * * `label` **`for`** `value` **`in`** `array` @@ -182,7 +182,7 @@ var selectDirective = ['$compile', '$parse', function($compile, $parse) { }); }; - // we have to do it on each watch since ng-model watches reference, but + // we have to do it on each watch since ngModel watches reference, but // we need to work of an array, so we need to see if anything was inserted/removed scope.$watch(function() { if (!equals(lastView, ctrl.$viewValue)) { @@ -209,7 +209,7 @@ var selectDirective = ['$compile', '$parse', function($compile, $parse) { if (! (match = optionsExp.match(NG_OPTIONS_REGEXP))) { throw Error( - "Expected ng-options in form of '_select_ (as _label_)? for (_key_,)?_value_ in _collection_'" + + "Expected ngOptions in form of '_select_ (as _label_)? for (_key_,)?_value_ in _collection_'" + " but got '" + optionsExp + "'."); } diff --git a/src/ng/filter/filters.js b/src/ng/filter/filters.js index d6efc418..f5e96bbf 100644 --- a/src/ng/filter/filters.js +++ b/src/ng/filter/filters.js @@ -398,7 +398,6 @@ function dateFilter($locale) { * @param {*} object Any JavaScript object (including arrays and primitive types) to filter. * @returns {string} JSON string. * - * @css ng-monospace Always applied to the encapsulating element. * * @example: <doc:example> diff --git a/src/ng/rootScope.js b/src/ng/rootScope.js index 4cf6a3e0..08f8a428 100644 --- a/src/ng/rootScope.js +++ b/src/ng/rootScope.js @@ -328,7 +328,7 @@ function $RootScopeProvider(){ * `'Maximum iteration limit exceeded.'` if the number of iterations exceeds 100. * * Usually you don't call `$digest()` directly in - * {@link angular.module.ng.$compileProvider.directive.ng-controller controllers} or in + * {@link angular.module.ng.$compileProvider.directive.ngController controllers} or in * {@link angular.module.ng.$compileProvider.directive directives}. * Instead a call to {@link angular.module.ng.$rootScope.Scope#$apply $apply()} (typically from within a * {@link angular.module.ng.$compileProvider.directive directives}) will force a `$digest()`. @@ -461,7 +461,7 @@ function $RootScopeProvider(){ * scope is eligible for garbage collection. * * The `$destroy()` is usually used by directives such as - * {@link angular.module.ng.$compileProvider.directive.ng-repeat ng-repeat} for managing the + * {@link angular.module.ng.$compileProvider.directive.ngRepeat ngRepeat} for managing the * unrolling of the loop. * * Just before a scope is destroyed a `$destroy` event is broadcasted on this scope. diff --git a/src/ng/route.js b/src/ng/route.js index 864cb0ee..fe726b88 100644 --- a/src/ng/route.js +++ b/src/ng/route.js @@ -30,8 +30,8 @@ function $RouteProvider(){ * - `controller` – `{function()=}` – Controller fn that should be associated with newly * created scope. * - `template` – `{string=}` – path to an html template that should be used by - * {@link angular.module.ng.$compileProvider.directive.ng-view ng-view} or - * {@link angular.module.ng.$compileProvider.directive.ng-include ng-include} directives. + * {@link angular.module.ng.$compileProvider.directive.ngView ngView} or + * {@link angular.module.ng.$compileProvider.directive.ngInclude ngInclude} directives. * - `redirectTo` – {(string|function())=} – value to update * {@link angular.module.ng.$location $location} path with and trigger route redirection. * @@ -107,12 +107,12 @@ function $RouteProvider(){ * * You can define routes through {@link angular.module.ng.$routeProvider $routeProvider}'s API. * - * The `$route` service is typically used in conjunction with {@link angular.module.ng.$compileProvider.directive.ng-view ng-view} + * The `$route` service is typically used in conjunction with {@link angular.module.ng.$compileProvider.directive.ngView ngView} * directive and the {@link angular.module.ng.$routeParams $routeParams} service. * * @example This example shows how changing the URL hash causes the `$route` to match a route against the - URL, and the `ng-view` pulls in the partial. + URL, and the `ngView` pulls in the partial. Note that this example is using {@link angular.module.ng.$compileProvider.directive.script inlined templates} to get it working on jsfiddle as well. @@ -241,7 +241,7 @@ function $RouteProvider(){ * Causes `$route` service to reload the current route even if * {@link angular.module.ng.$location $location} hasn't changed. * - * As a result of that, {@link angular.module.ng.$compileProvider.directive.ng-view ng-view} + * As a result of that, {@link angular.module.ng.$compileProvider.directive.ngView ngView} * creates new scope, reinstantiates the controller. */ reload: function() { |