mirror of
https://github.com/Hopiu/angular.js.git
synced 2026-03-16 23:30:23 +00:00
docs(*): fixed typos
This commit is contained in:
parent
4ae46814ff
commit
9480136d9f
21 changed files with 34 additions and 34 deletions
|
|
@ -2,7 +2,7 @@
|
|||
@name Developer Guide: Templates: Data Binding in Angular
|
||||
@description
|
||||
|
||||
Data-binding in Angular web apps is the automatic syncronization of data between the model and view
|
||||
Data-binding in Angular web apps is the automatic synchronization of data between the model and view
|
||||
components. The way that Angular implements data-binding lets you treat the model as the
|
||||
single-source-of-truth in your application. The view is a projection of the model at all times.
|
||||
When the model changes, the view reflects the change, and vice versa.
|
||||
|
|
|
|||
|
|
@ -72,7 +72,7 @@ here:
|
|||
If an attribute with a binding is prefixed with `ngAttr` prefix (denormalized prefix: 'ng-attr-',
|
||||
'ng:attr-') then during the compilation the prefix will be removed and the binding will be applied
|
||||
to an unprefixed attribute. This allows binding to attributes that would otherwise be eagerly
|
||||
processed by browsers in their uncompilled form (e.g. `img[src]` or svg's `circle[cx]` attributes).
|
||||
processed by browsers in their uncompiled form (e.g. `img[src]` or svg's `circle[cx]` attributes).
|
||||
|
||||
For example, considering template:
|
||||
|
||||
|
|
@ -280,7 +280,7 @@ In most cases you will not need such fine control and so the above can be simpli
|
|||
different parts of this skeleton are explained in following sections. In this section we are
|
||||
interested only in some of this skeleton.
|
||||
|
||||
The first step in simplyfing the code is to rely on the default values. Therefore the above can be
|
||||
The first step in simplifying the code is to rely on the default values. Therefore the above can be
|
||||
simplified as:
|
||||
|
||||
<pre>
|
||||
|
|
|
|||
|
|
@ -64,8 +64,8 @@ testing angular apps even easier. Your unit/integration test harness should load
|
|||
to write and execute end-to-end tests for angular applications.
|
||||
|
||||
* __`angular-loader.min.js`__ — Module loader for Angular modules. If you are loading multiple script files containing
|
||||
Angular modules, you can load them asynchronosuly and in any order as long as you load this file first. Often the
|
||||
contents of this file are copy&pasted into the `index.html` to avoid even the inial request to `angular-loader.min.js`.
|
||||
Angular modules, you can load them asynchronously and in any order as long as you load this file first. Often the
|
||||
contents of this file are copy&pasted into the `index.html` to avoid even the initial request to `angular-loader.min.js`.
|
||||
See [angular-seed](https://github.com/angular/angular-seed/blob/master/app/index-async.html) for an example of usage.
|
||||
|
||||
* __`angular-resource.js`__, __`angular-cookies.js`__, etc - extra Angular modules with additional functionality.
|
||||
|
|
|
|||
|
|
@ -631,7 +631,7 @@ function shallowCopy(src, dst) {
|
|||
* * Both objects or values are of the same type and all of their properties pass `===` comparison.
|
||||
* * Both values are NaN. (In JavasScript, NaN == NaN => false. But we consider two NaN as equal)
|
||||
*
|
||||
* During a property comparision, properties of `function` type and properties with names
|
||||
* During a property comparison, properties of `function` type and properties with names
|
||||
* that begin with `$` are ignored.
|
||||
*
|
||||
* Scope and DOMWindow objects are being compared only be identify (`===`).
|
||||
|
|
@ -838,7 +838,7 @@ function toKeyValue(obj) {
|
|||
|
||||
|
||||
/**
|
||||
* We need our custom method because encodeURIComponent is too agressive and doesn't follow
|
||||
* We need our custom method because encodeURIComponent is too aggressive and doesn't follow
|
||||
* http://www.ietf.org/rfc/rfc3986.txt with regards to the character set (pchar) allowed in path
|
||||
* segments:
|
||||
* segment = *pchar
|
||||
|
|
@ -858,7 +858,7 @@ function encodeUriSegment(val) {
|
|||
|
||||
/**
|
||||
* This method is intended for encoding *key* or *value* parts of query component. We need a custom
|
||||
* method becuase encodeURIComponent is too agressive and encodes stuff that doesn't have to be
|
||||
* method because encodeURIComponent is too aggressive and encodes stuff that doesn't have to be
|
||||
* encoded per http://tools.ietf.org/html/rfc3986:
|
||||
* query = *( pchar / "/" / "?" )
|
||||
* pchar = unreserved / pct-encoded / sub-delims / ":" / "@"
|
||||
|
|
|
|||
|
|
@ -643,7 +643,7 @@ var REGEXP_PRECEDER_PATTERN = '(?:^^\\.?|[+-]|[!=]=?=?|\\#|%=?|&&?=?|\\(|\\*=?|[
|
|||
* recognized.
|
||||
*
|
||||
* Shortcut is an optional string of characters, any of which, if the first
|
||||
* character, gurantee that this pattern and only this pattern matches.
|
||||
* character, guarantee that this pattern and only this pattern matches.
|
||||
*
|
||||
* @param {Array} shortcutStylePatterns patterns that always start with
|
||||
* a known character. Must have a shortcut string.
|
||||
|
|
|
|||
|
|
@ -59,7 +59,7 @@
|
|||
* - [val()](http://api.jquery.com/val/)
|
||||
* - [wrap()](http://api.jquery.com/wrap/)
|
||||
*
|
||||
* ## In addtion to the above, Angular provides additional methods to both jQuery and jQuery lite:
|
||||
* ## In addition to the above, Angular provides additional methods 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 `ngController` directive. If `name` is provided as
|
||||
|
|
|
|||
|
|
@ -252,7 +252,7 @@ function Browser(window, document, $log, $sniffer) {
|
|||
* @methodOf ng.$browser
|
||||
*
|
||||
* @param {string=} name Cookie name
|
||||
* @param {string=} value Cokkie value
|
||||
* @param {string=} value Cookie value
|
||||
*
|
||||
* @description
|
||||
* The cookies method provides a 'private' low level access to browser cookies.
|
||||
|
|
@ -314,7 +314,7 @@ function Browser(window, document, $log, $sniffer) {
|
|||
* @returns {*} DeferId that can be used to cancel the task via `$browser.defer.cancel()`.
|
||||
*
|
||||
* @description
|
||||
* Executes a fn asynchroniously via `setTimeout(fn, delay)`.
|
||||
* Executes a fn asynchronously via `setTimeout(fn, delay)`.
|
||||
*
|
||||
* Unlike when calling `setTimeout` directly, in test this function is mocked and instead of using
|
||||
* `setTimeout` in tests, the fns are queued in an array, which can be programmatically flushed
|
||||
|
|
@ -341,7 +341,7 @@ function Browser(window, document, $log, $sniffer) {
|
|||
* Cancels a defered task identified with `deferId`.
|
||||
*
|
||||
* @param {*} deferId Token returned by the `$browser.defer` function.
|
||||
* @returns {boolean} Returns `true` if the task hasn't executed yet and was successfuly canceled.
|
||||
* @returns {boolean} Returns `true` if the task hasn't executed yet and was successfully canceled.
|
||||
*/
|
||||
self.defer.cancel = function(deferId) {
|
||||
if (pendingDeferIds[deferId]) {
|
||||
|
|
|
|||
|
|
@ -170,7 +170,7 @@ function $CompileProvider($provide) {
|
|||
*
|
||||
* @param {string} name Name of the directive in camel-case. (ie <code>ngBind</code> which will match as
|
||||
* <code>ng-bind</code>).
|
||||
* @param {function} directiveFactory An injectable directive factroy function. See {@link guide/directive} for more
|
||||
* @param {function} directiveFactory An injectable directive factory function. See {@link guide/directive} for more
|
||||
* info.
|
||||
* @returns {ng.$compileProvider} Self for chaining.
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -805,7 +805,7 @@ var VALID_CLASS = 'ng-valid',
|
|||
* @property {Array.<Function>} $formatters Whenever the model value changes, it executes all of
|
||||
* these functions to convert the value as well as validate.
|
||||
*
|
||||
* @property {Object} $error An bject hash with all errors as keys.
|
||||
* @property {Object} $error An object hash with all errors as keys.
|
||||
*
|
||||
* @property {boolean} $pristine True if user has not interacted with the control yet.
|
||||
* @property {boolean} $dirty True if user has already interacted with the control.
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@
|
|||
* 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
|
||||
* Once scenario in which the use of `ngBind` is preferred 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 the
|
||||
* bindings invisible to the user while the page is loading.
|
||||
|
|
|
|||
|
|
@ -10,7 +10,7 @@
|
|||
* 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.
|
||||
* preferred in order to benefit from progressive rendering of the browser view.
|
||||
*
|
||||
* `ngCloak` works in cooperation with a css rule that is embedded within `angular.js` and
|
||||
* `angular.min.js` files. Following is the css rule:
|
||||
|
|
|
|||
|
|
@ -19,7 +19,7 @@
|
|||
* {@link http://unicode.org/repos/cldr-tmp/trunk/diff/supplemental/language_plural_rules.html
|
||||
* plural categories} in Angular's default en-US locale: "one" and "other".
|
||||
*
|
||||
* While a pural category may match many numbers (for example, in en-US locale, "other" can match
|
||||
* While a plural category may match many numbers (for example, in en-US locale, "other" can match
|
||||
* any number that is not 1), an explicit number rule can only match one number. For example, the
|
||||
* 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.
|
||||
|
|
@ -87,7 +87,7 @@
|
|||
* plural categories "one" and "other".
|
||||
*
|
||||
* @param {string|expression} count The variable to be bounded to.
|
||||
* @param {string} when The mapping between plural category to its correspoding strings.
|
||||
* @param {string} when The mapping between plural category to its corresponding strings.
|
||||
* @param {number=} offset Offset to deduct from the total number.
|
||||
*
|
||||
* @example
|
||||
|
|
|
|||
|
|
@ -20,7 +20,7 @@
|
|||
* @scope
|
||||
* @param {*} ngSwitch|on expression to match against <tt>ng-switch-when</tt>.
|
||||
* @paramDescription
|
||||
* On child elments add:
|
||||
* On child elements add:
|
||||
*
|
||||
* * `ngSwitchWhen`: the case statement to match against. If match then this
|
||||
* case will be displayed. If the same match appears multiple times, all the
|
||||
|
|
@ -59,7 +59,7 @@
|
|||
select('selection').option('home');
|
||||
expect(element('.doc-example-live [ng-switch]').text()).toMatch(/Home Span/);
|
||||
});
|
||||
it('should select deafault', function() {
|
||||
it('should select default', function() {
|
||||
select('selection').option('other');
|
||||
expect(element('.doc-example-live [ng-switch]').text()).toMatch(/default/);
|
||||
});
|
||||
|
|
|
|||
|
|
@ -9,7 +9,7 @@
|
|||
* Orders a specified `array` by the `expression` predicate.
|
||||
*
|
||||
* Note: this function is used to augment the `Array` type in Angular expressions. See
|
||||
* {@link ng.$filter} for more informaton about Angular arrays.
|
||||
* {@link ng.$filter} for more information about Angular arrays.
|
||||
*
|
||||
* @param {Array} array The array to sort.
|
||||
* @param {function(*)|string|Array.<(function(*)|string)>} expression A predicate to be
|
||||
|
|
|
|||
|
|
@ -297,7 +297,7 @@ function $HttpProvider() {
|
|||
* `$httpProvider.defaults.headers.get['My-Header']='value'`.
|
||||
*
|
||||
* Additionally, the defaults can be set at runtime via the `$http.defaults` object in a similar
|
||||
* fassion as described above.
|
||||
* fashion as described above.
|
||||
*
|
||||
*
|
||||
* # Transforming Requests and Responses
|
||||
|
|
|
|||
|
|
@ -697,11 +697,11 @@ function setter(obj, path, setValue) {
|
|||
}
|
||||
|
||||
/**
|
||||
* Return the value accesible from the object by path. Any undefined traversals are ignored
|
||||
* Return the value accessible from the object by path. Any undefined traversals are ignored
|
||||
* @param {Object} obj starting object
|
||||
* @param {string} path path to traverse
|
||||
* @param {boolean=true} bindFnToScope
|
||||
* @returns value as accesbile by path
|
||||
* @returns value as accessible by path
|
||||
*/
|
||||
//TODO(misko): this function needs to be removed
|
||||
function getter(obj, path, bindFnToScope) {
|
||||
|
|
@ -873,7 +873,7 @@ function getterFn(path, csp) {
|
|||
* @returns {function(context, locals)} a function which represents the compiled expression:
|
||||
*
|
||||
* * `context` – `{object}` – an object against which any expressions embedded in the strings
|
||||
* are evaluated against (tipically a scope object).
|
||||
* are evaluated against (typically a scope object).
|
||||
* * `locals` – `{object=}` – local variables context object, useful for overriding values in
|
||||
* `context`.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -736,7 +736,7 @@ function $RootScopeProvider(){
|
|||
* Afterwards, the event propagates to all direct and indirect scopes of the current scope and
|
||||
* calls all registered listeners along the way. The event cannot be canceled.
|
||||
*
|
||||
* Any exception emmited from the {@link ng.$rootScope.Scope#$on listeners} will be passed
|
||||
* Any exception emitted from the {@link ng.$rootScope.Scope#$on listeners} will be passed
|
||||
* onto the {@link ng.$exceptionHandler $exceptionHandler} service.
|
||||
*
|
||||
* @param {string} name Event name to emit.
|
||||
|
|
|
|||
|
|
@ -486,7 +486,7 @@ function $RouteProvider(){
|
|||
}
|
||||
|
||||
/**
|
||||
* @returns interpolation of the redirect path with the parametrs
|
||||
* @returns interpolation of the redirect path with the parameters
|
||||
*/
|
||||
function interpolate(string, params) {
|
||||
var result = [];
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@
|
|||
* A reference to the browser's `window` object. While `window`
|
||||
* is globally available in JavaScript, it causes testability problems, because
|
||||
* it is a global variable. In angular we always refer to it through the
|
||||
* `$window` service, so it may be overriden, removed or mocked for testing.
|
||||
* `$window` service, so it may be overridden, removed or mocked for testing.
|
||||
*
|
||||
* All expressions are evaluated with respect to current scope so they don't
|
||||
* suffer from window globality.
|
||||
|
|
|
|||
|
|
@ -27,14 +27,14 @@
|
|||
*
|
||||
* and you ready to get started!
|
||||
*
|
||||
* @param {string} url A parameterized URL template with parameters prefixed by `:` as in
|
||||
* @param {string} url A parametrized URL template with parameters prefixed by `:` as in
|
||||
* `/user/:username`. If you are using a URL with a port number (e.g.
|
||||
* `http://example.com:8080/api`), you'll need to escape the colon character before the port
|
||||
* number, like this: `$resource('http://example.com\\:8080/api')`.
|
||||
*
|
||||
* @param {Object=} paramDefaults Default values for `url` parameters. These can be overridden in
|
||||
* `actions` methods. If any of the parameter value is a function, it will be executed every time
|
||||
* when a param value needs to be obtained for a request (unless the param was overriden).
|
||||
* when a param value needs to be obtained for a request (unless the param was overridden).
|
||||
*
|
||||
* Each key value in the parameter object is first bound to url template if present and then any
|
||||
* excess keys are appended to the url search query after the `?`.
|
||||
|
|
@ -61,7 +61,7 @@
|
|||
* and `JSONP`.
|
||||
* - **`params`** – {Object=} – Optional set of pre-bound parameters for this action. If any of the
|
||||
* parameter value is a function, it will be executed every time when a param value needs to be
|
||||
* obtained for a request (unless the param was overriden).
|
||||
* obtained for a request (unless the param was overridden).
|
||||
* - **`url`** – {string} – action specific `url` override. The url templating is supported just like
|
||||
* for the resource-level urls.
|
||||
* - **`isArray`** – {boolean=} – If true then the returned object for this action is an array, see
|
||||
|
|
@ -296,7 +296,7 @@ angular.module('ngResource', ['ng']).
|
|||
|
||||
/**
|
||||
* This method is intended for encoding *key* or *value* parts of query component. We need a custom
|
||||
* method becuase encodeURIComponent is too agressive and encodes stuff that doesn't have to be
|
||||
* method because encodeURIComponent is too aggressive and encodes stuff that doesn't have to be
|
||||
* encoded per http://tools.ietf.org/html/rfc3986:
|
||||
* query = *( pchar / "/" / "?" )
|
||||
* pchar = unreserved / pct-encoded / sub-delims / ":" / "@"
|
||||
|
|
|
|||
|
|
@ -145,7 +145,7 @@ angular.scenario.setUpAndRun = function(config) {
|
|||
|
||||
/**
|
||||
* Iterates through list with iterator function that must call the
|
||||
* continueFunction to continute iterating.
|
||||
* continueFunction to continue iterating.
|
||||
*
|
||||
* @param {Array} list list to iterate over
|
||||
* @param {function()} iterator Callback function(value, continueFunction)
|
||||
|
|
|
|||
Loading…
Reference in a new issue