Update ember
This commit is contained in:
parent
3aefc86961
commit
57ae258803
161
assets/javascripts/vendor/ember.js
vendored
161
assets/javascripts/vendor/ember.js
vendored
|
@ -1,5 +1,5 @@
|
||||||
// Version: v1.0.pre-157-g896f794
|
// Version: v1.0.pre-161-g4255d0a
|
||||||
// Last commit: 896f794 (2012-09-26 21:30:45 +0200)
|
// Last commit: 4255d0a (2012-09-27 14:32:08 +0200)
|
||||||
|
|
||||||
|
|
||||||
(function() {
|
(function() {
|
||||||
|
@ -140,8 +140,8 @@ window.ember_deprecateFunc = Ember.deprecateFunc("ember_deprecateFunc is deprec
|
||||||
|
|
||||||
})();
|
})();
|
||||||
|
|
||||||
// Version: v1.0.pre-157-g896f794
|
// Version: v1.0.pre-161-g4255d0a
|
||||||
// Last commit: 896f794 (2012-09-26 21:30:45 +0200)
|
// Last commit: 4255d0a (2012-09-27 14:32:08 +0200)
|
||||||
|
|
||||||
|
|
||||||
(function() {
|
(function() {
|
||||||
|
@ -3096,32 +3096,33 @@ ComputedPropertyPrototype.set = function(obj, keyName, value) {
|
||||||
hadCachedValue = false,
|
hadCachedValue = false,
|
||||||
ret;
|
ret;
|
||||||
this._suspended = obj;
|
this._suspended = obj;
|
||||||
|
try {
|
||||||
|
ret = this.func.call(obj, keyName, value);
|
||||||
|
|
||||||
if (cacheable && keyName in meta.cache) {
|
if (cacheable && keyName in meta.cache) {
|
||||||
if (meta.cache[keyName] === value) {
|
if (meta.cache[keyName] === ret) {
|
||||||
return;
|
return;
|
||||||
|
}
|
||||||
|
hadCachedValue = true;
|
||||||
}
|
}
|
||||||
hadCachedValue = true;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (watched) { Ember.propertyWillChange(obj, keyName); }
|
if (watched) { Ember.propertyWillChange(obj, keyName); }
|
||||||
|
|
||||||
if (cacheable && hadCachedValue) {
|
if (cacheable && hadCachedValue) {
|
||||||
delete meta.cache[keyName];
|
delete meta.cache[keyName];
|
||||||
}
|
|
||||||
|
|
||||||
ret = this.func.call(obj, keyName, value);
|
|
||||||
|
|
||||||
if (cacheable) {
|
|
||||||
if (!watched && !hadCachedValue) {
|
|
||||||
addDependentKeys(this, obj, keyName, meta);
|
|
||||||
}
|
}
|
||||||
meta.cache[keyName] = ret;
|
|
||||||
|
if (cacheable) {
|
||||||
|
if (!watched && !hadCachedValue) {
|
||||||
|
addDependentKeys(this, obj, keyName, meta);
|
||||||
|
}
|
||||||
|
meta.cache[keyName] = ret;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (watched) { Ember.propertyDidChange(obj, keyName); }
|
||||||
|
} finally {
|
||||||
|
this._suspended = oldSuspended;
|
||||||
}
|
}
|
||||||
|
|
||||||
if (watched) { Ember.propertyDidChange(obj, keyName); }
|
|
||||||
|
|
||||||
this._suspended = oldSuspended;
|
|
||||||
return ret;
|
return ret;
|
||||||
};
|
};
|
||||||
|
|
||||||
|
@ -3790,7 +3791,7 @@ Ember.RunLoop = RunLoop;
|
||||||
call.
|
call.
|
||||||
|
|
||||||
Ember.run(function(){
|
Ember.run(function(){
|
||||||
// code to be execute within a RunLoop
|
// code to be execute within a RunLoop
|
||||||
});
|
});
|
||||||
|
|
||||||
@class run
|
@class run
|
||||||
|
@ -3824,7 +3825,7 @@ var run = Ember.run;
|
||||||
an lower-level way to use a RunLoop instead of using Ember.run().
|
an lower-level way to use a RunLoop instead of using Ember.run().
|
||||||
|
|
||||||
Ember.run.begin();
|
Ember.run.begin();
|
||||||
// code to be execute within a RunLoop
|
// code to be execute within a RunLoop
|
||||||
Ember.run.end();
|
Ember.run.end();
|
||||||
|
|
||||||
@method begin
|
@method begin
|
||||||
|
@ -3840,7 +3841,7 @@ Ember.run.begin = function() {
|
||||||
instead of using Ember.run().
|
instead of using Ember.run().
|
||||||
|
|
||||||
Ember.run.begin();
|
Ember.run.begin();
|
||||||
// code to be execute within a RunLoop
|
// code to be execute within a RunLoop
|
||||||
Ember.run.end();
|
Ember.run.end();
|
||||||
|
|
||||||
@method end
|
@method end
|
||||||
|
@ -5645,7 +5646,7 @@ Ember.inspect = function(obj) {
|
||||||
/**
|
/**
|
||||||
Compares two objects, returning true if they are logically equal. This is
|
Compares two objects, returning true if they are logically equal. This is
|
||||||
a deeper comparison than a simple triple equal. For sets it will compare the
|
a deeper comparison than a simple triple equal. For sets it will compare the
|
||||||
internal objects. For any other object that implements `isEqual()` it will
|
internal objects. For any other object that implements `isEqual()` it will
|
||||||
respect that method.
|
respect that method.
|
||||||
|
|
||||||
Ember.isEqual('hello', 'hello'); => true
|
Ember.isEqual('hello', 'hello'); => true
|
||||||
|
@ -5841,7 +5842,7 @@ Ember.String = {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Converts a camelized string into all lower case separated by underscores.
|
Converts a camelized string into all lower case separated by underscores.
|
||||||
|
|
||||||
'innerHTML'.decamelize() => 'inner_html'
|
'innerHTML'.decamelize() => 'inner_html'
|
||||||
'action_name'.decamelize() => 'action_name'
|
'action_name'.decamelize() => 'action_name'
|
||||||
'css-class-name'.decamelize() => 'css-class-name'
|
'css-class-name'.decamelize() => 'css-class-name'
|
||||||
|
@ -5857,7 +5858,7 @@ Ember.String = {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Replaces underscores or spaces with dashes.
|
Replaces underscores or spaces with dashes.
|
||||||
|
|
||||||
'innerHTML'.dasherize() => 'inner-html'
|
'innerHTML'.dasherize() => 'inner-html'
|
||||||
'action_name'.dasherize() => 'action-name'
|
'action_name'.dasherize() => 'action-name'
|
||||||
'css-class-name'.dasherize() => 'css-class-name'
|
'css-class-name'.dasherize() => 'css-class-name'
|
||||||
|
@ -7737,7 +7738,7 @@ Ember.MutableArray = Ember.Mixin.create(Ember.Array, Ember.MutableEnumerable,
|
||||||
colors.length(); => 0
|
colors.length(); => 0
|
||||||
|
|
||||||
@method clear
|
@method clear
|
||||||
@return {Ember.Array} An empty Array.
|
@return {Ember.Array} An empty Array.
|
||||||
*/
|
*/
|
||||||
clear: function () {
|
clear: function () {
|
||||||
var len = get(this, 'length');
|
var len = get(this, 'length');
|
||||||
|
@ -9518,7 +9519,7 @@ Ember.ArrayProxy = Ember.Object.extend(Ember.MutableArray,
|
||||||
The array that the proxy pretends to be. In the default `ArrayProxy`
|
The array that the proxy pretends to be. In the default `ArrayProxy`
|
||||||
implementation, this and `content` are the same. Subclasses of `ArrayProxy`
|
implementation, this and `content` are the same. Subclasses of `ArrayProxy`
|
||||||
can override this property to provide things like sorting and filtering.
|
can override this property to provide things like sorting and filtering.
|
||||||
|
|
||||||
@property arrangedContent
|
@property arrangedContent
|
||||||
*/
|
*/
|
||||||
arrangedContent: Ember.computed('content', function() {
|
arrangedContent: Ember.computed('content', function() {
|
||||||
|
@ -12186,9 +12187,9 @@ Ember.ControllerMixin.reopen({
|
||||||
}
|
}
|
||||||
|
|
||||||
outletName = outletName || 'view';
|
outletName = outletName || 'view';
|
||||||
|
|
||||||
Ember.assert("The viewClass is either missing or the one provided did not resolve to a view", !!name || (!name && !!viewClass));
|
Ember.assert("The viewClass is either missing or the one provided did not resolve to a view", !!name || (!name && !!viewClass));
|
||||||
|
|
||||||
Ember.assert("You must supply a name or a viewClass to connectOutlet, but not both", (!!name && !viewClass && !controller) || (!name && !!viewClass));
|
Ember.assert("You must supply a name or a viewClass to connectOutlet, but not both", (!!name && !viewClass && !controller) || (!name && !!viewClass));
|
||||||
|
|
||||||
if (name) {
|
if (name) {
|
||||||
|
@ -12325,7 +12326,7 @@ var invokeForState = {
|
||||||
`Ember.View` is the class in Ember responsible for encapsulating templates of HTML
|
`Ember.View` is the class in Ember responsible for encapsulating templates of HTML
|
||||||
content, combining templates with data to render as sections of a page's DOM, and
|
content, combining templates with data to render as sections of a page's DOM, and
|
||||||
registering and responding to user-initiated events.
|
registering and responding to user-initiated events.
|
||||||
|
|
||||||
## HTML Tag
|
## HTML Tag
|
||||||
The default HTML tag name used for a view's DOM representation is `div`. This can be
|
The default HTML tag name used for a view's DOM representation is `div`. This can be
|
||||||
customized by setting the `tagName` property. The following view class:
|
customized by setting the `tagName` property. The following view class:
|
||||||
|
@ -12359,7 +12360,7 @@ var invokeForState = {
|
||||||
```
|
```
|
||||||
|
|
||||||
`class` attribute values can also be set by providing a `classNameBindings` property
|
`class` attribute values can also be set by providing a `classNameBindings` property
|
||||||
set to an array of properties names for the view. The return value of these properties
|
set to an array of properties names for the view. The return value of these properties
|
||||||
will be added as part of the value for the view's `class` attribute. These properties
|
will be added as part of the value for the view's `class` attribute. These properties
|
||||||
can be computed properties:
|
can be computed properties:
|
||||||
|
|
||||||
|
@ -12396,7 +12397,7 @@ var invokeForState = {
|
||||||
<div id="ember1" class="ember-view hovered"></div>
|
<div id="ember1" class="ember-view hovered"></div>
|
||||||
```
|
```
|
||||||
|
|
||||||
When using boolean class name bindings you can supply a string value other than the
|
When using boolean class name bindings you can supply a string value other than the
|
||||||
property name for use as the `class` HTML attribute by appending the preferred value after
|
property name for use as the `class` HTML attribute by appending the preferred value after
|
||||||
a ":" character when defining the binding:
|
a ":" character when defining the binding:
|
||||||
|
|
||||||
|
@ -12466,7 +12467,7 @@ var invokeForState = {
|
||||||
|
|
||||||
``` html
|
``` html
|
||||||
<div id="ember1" class="ember-view enabled"></div>
|
<div id="ember1" class="ember-view enabled"></div>
|
||||||
```
|
```
|
||||||
|
|
||||||
When isEnabled is `false`, the resulting HTML reprensentation looks like this:
|
When isEnabled is `false`, the resulting HTML reprensentation looks like this:
|
||||||
|
|
||||||
|
@ -12497,11 +12498,11 @@ var invokeForState = {
|
||||||
<div id="ember1" class="ember-view disabled"></div>
|
<div id="ember1" class="ember-view disabled"></div>
|
||||||
```
|
```
|
||||||
|
|
||||||
Updates to the the value of a class name binding will result in automatic update
|
Updates to the the value of a class name binding will result in automatic update
|
||||||
of the HTML `class` attribute in the view's rendered HTML representation.
|
of the HTML `class` attribute in the view's rendered HTML representation.
|
||||||
If the value becomes `false` or `undefined` the class name will be removed.
|
If the value becomes `false` or `undefined` the class name will be removed.
|
||||||
|
|
||||||
Both `classNames` and `classNameBindings` are concatenated properties.
|
Both `classNames` and `classNameBindings` are concatenated properties.
|
||||||
See `Ember.Object` documentation for more information about concatenated properties.
|
See `Ember.Object` documentation for more information about concatenated properties.
|
||||||
|
|
||||||
## HTML Attributes
|
## HTML Attributes
|
||||||
|
@ -12558,7 +12559,7 @@ var invokeForState = {
|
||||||
});
|
});
|
||||||
```
|
```
|
||||||
|
|
||||||
Updates to the the property of an attribute binding will result in automatic update
|
Updates to the the property of an attribute binding will result in automatic update
|
||||||
of the HTML attribute in the view's rendered HTML representation.
|
of the HTML attribute in the view's rendered HTML representation.
|
||||||
|
|
||||||
`attributeBindings` is a concatenated property. See `Ember.Object` documentation
|
`attributeBindings` is a concatenated property. See `Ember.Object` documentation
|
||||||
|
@ -12580,7 +12581,7 @@ var invokeForState = {
|
||||||
|
|
||||||
``` html
|
``` html
|
||||||
<div id="ember1" class="ember-view">I am the template</div>
|
<div id="ember1" class="ember-view">I am the template</div>
|
||||||
```
|
```
|
||||||
|
|
||||||
The default context of the compiled template will be the view instance itself:
|
The default context of the compiled template will be the view instance itself:
|
||||||
|
|
||||||
|
@ -12670,7 +12671,7 @@ var invokeForState = {
|
||||||
primary templates, layouts can be any function that accepts an optional context
|
primary templates, layouts can be any function that accepts an optional context
|
||||||
parameter and returns a string of HTML that will be inserted inside view's tag. Views whose HTML
|
parameter and returns a string of HTML that will be inserted inside view's tag. Views whose HTML
|
||||||
element is self closing (e.g. `<input />`) cannot have a layout and this property will be ignored.
|
element is self closing (e.g. `<input />`) cannot have a layout and this property will be ignored.
|
||||||
|
|
||||||
Most typically in Ember a layout will be a compiled Ember.Handlebars template.
|
Most typically in Ember a layout will be a compiled Ember.Handlebars template.
|
||||||
|
|
||||||
A view's layout can be set directly with the `layout` property or reference an
|
A view's layout can be set directly with the `layout` property or reference an
|
||||||
|
@ -12700,7 +12701,7 @@ var invokeForState = {
|
||||||
|
|
||||||
## Responding to Browser Events
|
## Responding to Browser Events
|
||||||
|
|
||||||
Views can respond to user-initiated events in one of three ways: method implementation,
|
Views can respond to user-initiated events in one of three ways: method implementation,
|
||||||
through an event manager, and through `{{action}}` helper use in their template or layout.
|
through an event manager, and through `{{action}}` helper use in their template or layout.
|
||||||
|
|
||||||
### Method Implementation
|
### Method Implementation
|
||||||
|
@ -12721,8 +12722,8 @@ var invokeForState = {
|
||||||
|
|
||||||
Views can define an object as their `eventManager` property. This object can then
|
Views can define an object as their `eventManager` property. This object can then
|
||||||
implement methods that match the desired event names. Matching events that occur
|
implement methods that match the desired event names. Matching events that occur
|
||||||
on the view's rendered HTML or the rendered HTML of any of its DOM descendants
|
on the view's rendered HTML or the rendered HTML of any of its DOM descendants
|
||||||
will trigger this method. A `jQuery.Event` object will be passed as the first
|
will trigger this method. A `jQuery.Event` object will be passed as the first
|
||||||
argument to the method and an `Ember.View` object as the second. The `Ember.View`
|
argument to the method and an `Ember.View` object as the second. The `Ember.View`
|
||||||
will be the view whose rendered HTML was interacted with. This may be the view with
|
will be the view whose rendered HTML was interacted with. This may be the view with
|
||||||
the `eventManager` property or one of its descendent views.
|
the `eventManager` property or one of its descendent views.
|
||||||
|
@ -12759,7 +12760,7 @@ var invokeForState = {
|
||||||
|
|
||||||
Similarly a view's event manager will take precedence for events of any views
|
Similarly a view's event manager will take precedence for events of any views
|
||||||
rendered as a descendent. A method name that matches an event name will not be called
|
rendered as a descendent. A method name that matches an event name will not be called
|
||||||
if the view instance was rendered inside the HTML representation of a view that has
|
if the view instance was rendered inside the HTML representation of a view that has
|
||||||
an `eventManager` property defined that handles events of the name. Events not handled
|
an `eventManager` property defined that handles events of the name. Events not handled
|
||||||
by the event manager will still trigger method calls on the descendent.
|
by the event manager will still trigger method calls on the descendent.
|
||||||
|
|
||||||
|
@ -12782,7 +12783,7 @@ var invokeForState = {
|
||||||
// eventManager doesn't handle click events
|
// eventManager doesn't handle click events
|
||||||
},
|
},
|
||||||
mouseEnter: function(event){
|
mouseEnter: function(event){
|
||||||
// will never be called if rendered inside
|
// will never be called if rendered inside
|
||||||
// an OuterView.
|
// an OuterView.
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
@ -12806,9 +12807,9 @@ var invokeForState = {
|
||||||
Form events: 'submit', 'change', 'focusIn', 'focusOut', 'input'
|
Form events: 'submit', 'change', 'focusIn', 'focusOut', 'input'
|
||||||
|
|
||||||
HTML5 drag and drop events: 'dragStart', 'drag', 'dragEnter', 'dragLeave', 'drop', 'dragEnd'
|
HTML5 drag and drop events: 'dragStart', 'drag', 'dragEnter', 'dragLeave', 'drop', 'dragEnd'
|
||||||
|
|
||||||
## Handlebars `{{view}}` Helper
|
## Handlebars `{{view}}` Helper
|
||||||
|
|
||||||
Other `Ember.View` instances can be included as part of a view's template by using the `{{view}}`
|
Other `Ember.View` instances can be included as part of a view's template by using the `{{view}}`
|
||||||
Handlebars helper. See `Handlebars.helpers.view` for additional information.
|
Handlebars helper. See `Handlebars.helpers.view` for additional information.
|
||||||
|
|
||||||
|
@ -14985,7 +14986,7 @@ var childViewsProperty = Ember.computed(function() {
|
||||||
});
|
});
|
||||||
|
|
||||||
aContainer.appendTo('body');
|
aContainer.appendTo('body');
|
||||||
```
|
```
|
||||||
|
|
||||||
Results in the HTML
|
Results in the HTML
|
||||||
|
|
||||||
|
@ -15398,7 +15399,7 @@ var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
`Ember.CollectionView` is an `Ember.View` descendent responsible for managing a
|
`Ember.CollectionView` is an `Ember.View` descendent responsible for managing a
|
||||||
collection (an array or array-like object) by maintaing a child view object and
|
collection (an array or array-like object) by maintaing a child view object and
|
||||||
associated DOM representation for each item in the array and ensuring that child
|
associated DOM representation for each item in the array and ensuring that child
|
||||||
views and their associated rendered HTML are updated when items in the array
|
views and their associated rendered HTML are updated when items in the array
|
||||||
are added, removed, or replaced.
|
are added, removed, or replaced.
|
||||||
|
@ -15423,7 +15424,7 @@ var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt;
|
||||||
|
|
||||||
Given an empty `<body>` and the following code:
|
Given an empty `<body>` and the following code:
|
||||||
|
|
||||||
``` javascript
|
``` javascript
|
||||||
someItemsView = Ember.CollectionView.create({
|
someItemsView = Ember.CollectionView.create({
|
||||||
classNames: ['a-collection'],
|
classNames: ['a-collection'],
|
||||||
content: ['A','B','C'],
|
content: ['A','B','C'],
|
||||||
|
@ -15447,7 +15448,7 @@ var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt;
|
||||||
|
|
||||||
## Automatic matching of parent/child tagNames
|
## Automatic matching of parent/child tagNames
|
||||||
|
|
||||||
Setting the `tagName` property of a `CollectionView` to any of
|
Setting the `tagName` property of a `CollectionView` to any of
|
||||||
"ul", "ol", "table", "thead", "tbody", "tfoot", "tr", or "select" will result
|
"ul", "ol", "table", "thead", "tbody", "tfoot", "tr", or "select" will result
|
||||||
in the item views receiving an appropriately matched `tagName` property.
|
in the item views receiving an appropriately matched `tagName` property.
|
||||||
|
|
||||||
|
@ -20170,7 +20171,7 @@ EmberHandlebars.ViewHelper = Ember.Object.create({
|
||||||
|
|
||||||
``` html
|
``` html
|
||||||
<body>
|
<body>
|
||||||
<!-- Note: the handlebars template script
|
<!-- Note: the handlebars template script
|
||||||
also results in a rendered Ember.View
|
also results in a rendered Ember.View
|
||||||
which is the outer <div> here -->
|
which is the outer <div> here -->
|
||||||
|
|
||||||
|
@ -20195,7 +20196,7 @@ EmberHandlebars.ViewHelper = Ember.Object.create({
|
||||||
|
|
||||||
aView.appendTo('body');
|
aView.appendTo('body');
|
||||||
```
|
```
|
||||||
|
|
||||||
Will result in HTML structure:
|
Will result in HTML structure:
|
||||||
|
|
||||||
``` html
|
``` html
|
||||||
|
@ -20285,7 +20286,7 @@ EmberHandlebars.ViewHelper = Ember.Object.create({
|
||||||
|
|
||||||
``` html
|
``` html
|
||||||
<div id="ember1" class="ember-view">
|
<div id="ember1" class="ember-view">
|
||||||
<div id="ember2" class="ember-view a-custom-view-class-as-property">
|
<div id="ember2" class="ember-view a-custom-view-class-as-property">
|
||||||
hi
|
hi
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
@ -20722,7 +20723,7 @@ Ember.Handlebars.EachView = Ember.CollectionView.extend(Ember._Metamorph, {
|
||||||
``` handlebars
|
``` handlebars
|
||||||
<script type="text/x-handlebars">
|
<script type="text/x-handlebars">
|
||||||
{{#view App.MyView }}
|
{{#view App.MyView }}
|
||||||
{{each view.items itemViewClass="App.AnItemView"}}
|
{{each view.items itemViewClass="App.AnItemView"}}
|
||||||
{{/view}}
|
{{/view}}
|
||||||
</script>
|
</script>
|
||||||
```
|
```
|
||||||
|
@ -20743,10 +20744,10 @@ Ember.Handlebars.EachView = Ember.CollectionView.extend(Ember._Metamorph, {
|
||||||
App.AnItemView = Ember.View.extend({
|
App.AnItemView = Ember.View.extend({
|
||||||
template: Ember.Handlebars.compile("Greetings {{name}}")
|
template: Ember.Handlebars.compile("Greetings {{name}}")
|
||||||
});
|
});
|
||||||
|
|
||||||
App.initialize();
|
App.initialize();
|
||||||
```
|
```
|
||||||
|
|
||||||
Will result in the HTML structure below
|
Will result in the HTML structure below
|
||||||
|
|
||||||
``` html
|
``` html
|
||||||
|
@ -20905,7 +20906,7 @@ ActionHelper.registerAction = function(actionName, options) {
|
||||||
The `{{action}}` helper registers an HTML element within a template for
|
The `{{action}}` helper registers an HTML element within a template for
|
||||||
DOM event handling and forwards that interaction to the Application's router,
|
DOM event handling and forwards that interaction to the Application's router,
|
||||||
the template's `Ember.View` instance, or supplied `target` option (see 'Specifying a Target').
|
the template's `Ember.View` instance, or supplied `target` option (see 'Specifying a Target').
|
||||||
|
|
||||||
User interaction with that element will invoke the supplied action name on
|
User interaction with that element will invoke the supplied action name on
|
||||||
the appropriate target.
|
the appropriate target.
|
||||||
|
|
||||||
|
@ -20956,7 +20957,7 @@ ActionHelper.registerAction = function(actionName, options) {
|
||||||
If you need the default handler to trigger you should either register your
|
If you need the default handler to trigger you should either register your
|
||||||
own event handler, or use event methods on your view class. See Ember.View
|
own event handler, or use event methods on your view class. See Ember.View
|
||||||
'Responding to Browser Events' for more information.
|
'Responding to Browser Events' for more information.
|
||||||
|
|
||||||
### Specifying DOM event type
|
### Specifying DOM event type
|
||||||
|
|
||||||
By default the `{{action}}` helper registers for DOM `click` events. You can
|
By default the `{{action}}` helper registers for DOM `click` events. You can
|
||||||
|
@ -20978,23 +20979,23 @@ ActionHelper.registerAction = function(actionName, options) {
|
||||||
`Ember.EventDispatcher` instance will be created when a new
|
`Ember.EventDispatcher` instance will be created when a new
|
||||||
`Ember.Application` is created. Having an instance of `Ember.Application`
|
`Ember.Application` is created. Having an instance of `Ember.Application`
|
||||||
will satisfy this requirement.
|
will satisfy this requirement.
|
||||||
|
|
||||||
|
|
||||||
### Specifying a Target
|
### Specifying a Target
|
||||||
There are several possible target objects for `{{action}}` helpers:
|
There are several possible target objects for `{{action}}` helpers:
|
||||||
|
|
||||||
In a typical `Ember.Router`-backed Application where views are managed
|
In a typical `Ember.Router`-backed Application where views are managed
|
||||||
through use of the `{{outlet}}` helper, actions will be forwarded to the
|
through use of the `{{outlet}}` helper, actions will be forwarded to the
|
||||||
current state of the Applications's Router. See Ember.Router 'Responding
|
current state of the Applications's Router. See Ember.Router 'Responding
|
||||||
to User-initiated Events' for more information.
|
to User-initiated Events' for more information.
|
||||||
|
|
||||||
If you manually set the `target` property on the controller of a template's
|
If you manually set the `target` property on the controller of a template's
|
||||||
`Ember.View` instance, the specifed `controller.target` will become the target
|
`Ember.View` instance, the specifed `controller.target` will become the target
|
||||||
for any actions. Likely custom values for a controller's `target` are the
|
for any actions. Likely custom values for a controller's `target` are the
|
||||||
controller itself or a StateManager other than the Application's Router.
|
controller itself or a StateManager other than the Application's Router.
|
||||||
|
|
||||||
If the templates's view lacks a controller property the view itself is the target.
|
If the templates's view lacks a controller property the view itself is the target.
|
||||||
|
|
||||||
Finally, a `target` option can be provided to the helper to change which object
|
Finally, a `target` option can be provided to the helper to change which object
|
||||||
will receive the method call. This option must be a string representing a
|
will receive the method call. This option must be a string representing a
|
||||||
path to an object:
|
path to an object:
|
||||||
|
@ -21057,7 +21058,7 @@ ActionHelper.registerAction = function(actionName, options) {
|
||||||
|
|
||||||
Will throw `Uncaught TypeError: Cannot call method 'call' of undefined` when
|
Will throw `Uncaught TypeError: Cannot call method 'call' of undefined` when
|
||||||
"click me" is clicked.
|
"click me" is clicked.
|
||||||
|
|
||||||
### Specifying a context
|
### Specifying a context
|
||||||
|
|
||||||
By default the `{{action}}` helper passes the current Handlebars context
|
By default the `{{action}}` helper passes the current Handlebars context
|
||||||
|
@ -21286,7 +21287,7 @@ Ember.Handlebars.registerHelper('outlet', function(property, options) {
|
||||||
var set = Ember.set, get = Ember.get;
|
var set = Ember.set, get = Ember.get;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
The `Ember.Checkbox` view class renders a checkbox [input](https://developer.mozilla.org/en/HTML/Element/Input)
|
The `Ember.Checkbox` view class renders a checkbox [input](https://developer.mozilla.org/en/HTML/Element/Input)
|
||||||
element. It allows for binding an Ember property (`checked`) to the status of the checkbox.
|
element. It allows for binding an Ember property (`checked`) to the status of the checkbox.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
|
@ -21298,7 +21299,7 @@ var set = Ember.set, get = Ember.get;
|
||||||
You can add a `label` tag yourself in the template where the Ember.Checkbox is being used.
|
You can add a `label` tag yourself in the template where the Ember.Checkbox is being used.
|
||||||
|
|
||||||
``` html
|
``` html
|
||||||
<label>
|
<label>
|
||||||
{{view Ember.Checkbox classNames="applicaton-specific-checkbox"}}
|
{{view Ember.Checkbox classNames="applicaton-specific-checkbox"}}
|
||||||
Some Title
|
Some Title
|
||||||
</label>
|
</label>
|
||||||
|
@ -21615,7 +21616,7 @@ var get = Ember.get, set = Ember.set;
|
||||||
|
|
||||||
## Layout and LayoutName properties
|
## Layout and LayoutName properties
|
||||||
|
|
||||||
Because HTML `textarea` elements do not contain inner HTML the `layout` and `layoutName`
|
Because HTML `textarea` elements do not contain inner HTML the `layout` and `layoutName`
|
||||||
properties will not be applied. See `Ember.View`'s layout section for more information.
|
properties will not be applied. See `Ember.View`'s layout section for more information.
|
||||||
|
|
||||||
@class TextArea
|
@class TextArea
|
||||||
|
@ -21760,7 +21761,7 @@ var indexOf = Ember.EnumerableUtils.indexOf, indexesOf = Ember.EnumerableUtils.i
|
||||||
/**
|
/**
|
||||||
The Ember.Select view class renders a
|
The Ember.Select view class renders a
|
||||||
[select](https://developer.mozilla.org/en/HTML/Element/select) HTML element,
|
[select](https://developer.mozilla.org/en/HTML/Element/select) HTML element,
|
||||||
allowing the user to choose from a list of options.
|
allowing the user to choose from a list of options.
|
||||||
|
|
||||||
The text and `value` property of each `<option>` element within the `<select>` element
|
The text and `value` property of each `<option>` element within the `<select>` element
|
||||||
are populated from the objects in the Element.Select's `content` property. The
|
are populated from the objects in the Element.Select's `content` property. The
|
||||||
|
@ -21818,7 +21819,7 @@ var indexOf = Ember.EnumerableUtils.indexOf, indexesOf = Ember.EnumerableUtils.i
|
||||||
```
|
```
|
||||||
|
|
||||||
A user interacting with the rendered `<select>` to choose "Yehuda" would update
|
A user interacting with the rendered `<select>` to choose "Yehuda" would update
|
||||||
the value of `App.controller.selected` to "Yehuda".
|
the value of `App.controller.selected` to "Yehuda".
|
||||||
|
|
||||||
### `content` as an Array of Objects
|
### `content` as an Array of Objects
|
||||||
An Ember.Select can also take an array of JavaScript or Ember objects
|
An Ember.Select can also take an array of JavaScript or Ember objects
|
||||||
|
@ -21829,8 +21830,8 @@ var indexOf = Ember.EnumerableUtils.indexOf, indexesOf = Ember.EnumerableUtils.i
|
||||||
and which property should be used to supply the element text.
|
and which property should be used to supply the element text.
|
||||||
|
|
||||||
The `optionValuePath` option is used to specify the path on each object to
|
The `optionValuePath` option is used to specify the path on each object to
|
||||||
the desired property for the `value` attribute. The `optionLabelPath`
|
the desired property for the `value` attribute. The `optionLabelPath`
|
||||||
specifies the path on each object to the desired property for the
|
specifies the path on each object to the desired property for the
|
||||||
element's text. Both paths must reference each object itself as 'content':
|
element's text. Both paths must reference each object itself as 'content':
|
||||||
|
|
||||||
``` javascript
|
``` javascript
|
||||||
|
@ -21899,7 +21900,7 @@ var indexOf = Ember.EnumerableUtils.indexOf, indexesOf = Ember.EnumerableUtils.i
|
||||||
used to render each object providing a `selectionBinding`. When the selected
|
used to render each object providing a `selectionBinding`. When the selected
|
||||||
`<option>` is changed, the property path provided to `selectionBinding`
|
`<option>` is changed, the property path provided to `selectionBinding`
|
||||||
will be updated to match the content object of the rendered `<option>`
|
will be updated to match the content object of the rendered `<option>`
|
||||||
element:
|
element:
|
||||||
|
|
||||||
``` javascript
|
``` javascript
|
||||||
App.controller = Ember.Object.create({
|
App.controller = Ember.Object.create({
|
||||||
|
@ -21933,7 +21934,7 @@ var indexOf = Ember.EnumerableUtils.indexOf, indexesOf = Ember.EnumerableUtils.i
|
||||||
Interacting with the rendered element by selecting the first option
|
Interacting with the rendered element by selecting the first option
|
||||||
('Yehuda') will update the `selectedPerson` value of `App.controller`
|
('Yehuda') will update the `selectedPerson` value of `App.controller`
|
||||||
to match the content object of the newly selected `<option>`. In this
|
to match the content object of the newly selected `<option>`. In this
|
||||||
case it is the first object in the `App.content.content`
|
case it is the first object in the `App.content.content`
|
||||||
|
|
||||||
### Supplying a Prompt
|
### Supplying a Prompt
|
||||||
|
|
||||||
|
@ -22354,8 +22355,8 @@ Ember Handlebars
|
||||||
|
|
||||||
})();
|
})();
|
||||||
|
|
||||||
// Version: v1.0.pre-157-g896f794
|
// Version: v1.0.pre-161-g4255d0a
|
||||||
// Last commit: 896f794 (2012-09-26 21:30:45 +0200)
|
// Last commit: 4255d0a (2012-09-27 14:32:08 +0200)
|
||||||
|
|
||||||
|
|
||||||
(function() {
|
(function() {
|
||||||
|
|
|
@ -1952,8 +1952,8 @@ Handlebars.VM = {
|
||||||
|
|
||||||
Handlebars.template = Handlebars.VM.template;
|
Handlebars.template = Handlebars.VM.template;
|
||||||
;
|
;
|
||||||
// Version: v1.0.pre-157-g896f794
|
// Version: v1.0.pre-161-g4255d0a
|
||||||
// Last commit: 896f794 (2012-09-26 21:30:45 +0200)
|
// Last commit: 4255d0a (2012-09-27 14:32:08 +0200)
|
||||||
|
|
||||||
|
|
||||||
(function() {
|
(function() {
|
||||||
|
@ -2094,8 +2094,8 @@ window.ember_deprecateFunc = Ember.deprecateFunc("ember_deprecateFunc is deprec
|
||||||
|
|
||||||
})();
|
})();
|
||||||
|
|
||||||
// Version: v1.0.pre-157-g896f794
|
// Version: v1.0.pre-161-g4255d0a
|
||||||
// Last commit: 896f794 (2012-09-26 21:30:45 +0200)
|
// Last commit: 4255d0a (2012-09-27 14:32:08 +0200)
|
||||||
|
|
||||||
|
|
||||||
(function() {
|
(function() {
|
||||||
|
@ -5050,32 +5050,33 @@ ComputedPropertyPrototype.set = function(obj, keyName, value) {
|
||||||
hadCachedValue = false,
|
hadCachedValue = false,
|
||||||
ret;
|
ret;
|
||||||
this._suspended = obj;
|
this._suspended = obj;
|
||||||
|
try {
|
||||||
|
ret = this.func.call(obj, keyName, value);
|
||||||
|
|
||||||
if (cacheable && keyName in meta.cache) {
|
if (cacheable && keyName in meta.cache) {
|
||||||
if (meta.cache[keyName] === value) {
|
if (meta.cache[keyName] === ret) {
|
||||||
return;
|
return;
|
||||||
|
}
|
||||||
|
hadCachedValue = true;
|
||||||
}
|
}
|
||||||
hadCachedValue = true;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (watched) { Ember.propertyWillChange(obj, keyName); }
|
if (watched) { Ember.propertyWillChange(obj, keyName); }
|
||||||
|
|
||||||
if (cacheable && hadCachedValue) {
|
if (cacheable && hadCachedValue) {
|
||||||
delete meta.cache[keyName];
|
delete meta.cache[keyName];
|
||||||
}
|
|
||||||
|
|
||||||
ret = this.func.call(obj, keyName, value);
|
|
||||||
|
|
||||||
if (cacheable) {
|
|
||||||
if (!watched && !hadCachedValue) {
|
|
||||||
addDependentKeys(this, obj, keyName, meta);
|
|
||||||
}
|
}
|
||||||
meta.cache[keyName] = ret;
|
|
||||||
|
if (cacheable) {
|
||||||
|
if (!watched && !hadCachedValue) {
|
||||||
|
addDependentKeys(this, obj, keyName, meta);
|
||||||
|
}
|
||||||
|
meta.cache[keyName] = ret;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (watched) { Ember.propertyDidChange(obj, keyName); }
|
||||||
|
} finally {
|
||||||
|
this._suspended = oldSuspended;
|
||||||
}
|
}
|
||||||
|
|
||||||
if (watched) { Ember.propertyDidChange(obj, keyName); }
|
|
||||||
|
|
||||||
this._suspended = oldSuspended;
|
|
||||||
return ret;
|
return ret;
|
||||||
};
|
};
|
||||||
|
|
||||||
|
@ -5744,7 +5745,7 @@ Ember.RunLoop = RunLoop;
|
||||||
call.
|
call.
|
||||||
|
|
||||||
Ember.run(function(){
|
Ember.run(function(){
|
||||||
// code to be execute within a RunLoop
|
// code to be execute within a RunLoop
|
||||||
});
|
});
|
||||||
|
|
||||||
@class run
|
@class run
|
||||||
|
@ -5778,7 +5779,7 @@ var run = Ember.run;
|
||||||
an lower-level way to use a RunLoop instead of using Ember.run().
|
an lower-level way to use a RunLoop instead of using Ember.run().
|
||||||
|
|
||||||
Ember.run.begin();
|
Ember.run.begin();
|
||||||
// code to be execute within a RunLoop
|
// code to be execute within a RunLoop
|
||||||
Ember.run.end();
|
Ember.run.end();
|
||||||
|
|
||||||
@method begin
|
@method begin
|
||||||
|
@ -5794,7 +5795,7 @@ Ember.run.begin = function() {
|
||||||
instead of using Ember.run().
|
instead of using Ember.run().
|
||||||
|
|
||||||
Ember.run.begin();
|
Ember.run.begin();
|
||||||
// code to be execute within a RunLoop
|
// code to be execute within a RunLoop
|
||||||
Ember.run.end();
|
Ember.run.end();
|
||||||
|
|
||||||
@method end
|
@method end
|
||||||
|
@ -7599,7 +7600,7 @@ Ember.inspect = function(obj) {
|
||||||
/**
|
/**
|
||||||
Compares two objects, returning true if they are logically equal. This is
|
Compares two objects, returning true if they are logically equal. This is
|
||||||
a deeper comparison than a simple triple equal. For sets it will compare the
|
a deeper comparison than a simple triple equal. For sets it will compare the
|
||||||
internal objects. For any other object that implements `isEqual()` it will
|
internal objects. For any other object that implements `isEqual()` it will
|
||||||
respect that method.
|
respect that method.
|
||||||
|
|
||||||
Ember.isEqual('hello', 'hello'); => true
|
Ember.isEqual('hello', 'hello'); => true
|
||||||
|
@ -7795,7 +7796,7 @@ Ember.String = {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Converts a camelized string into all lower case separated by underscores.
|
Converts a camelized string into all lower case separated by underscores.
|
||||||
|
|
||||||
'innerHTML'.decamelize() => 'inner_html'
|
'innerHTML'.decamelize() => 'inner_html'
|
||||||
'action_name'.decamelize() => 'action_name'
|
'action_name'.decamelize() => 'action_name'
|
||||||
'css-class-name'.decamelize() => 'css-class-name'
|
'css-class-name'.decamelize() => 'css-class-name'
|
||||||
|
@ -7811,7 +7812,7 @@ Ember.String = {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
Replaces underscores or spaces with dashes.
|
Replaces underscores or spaces with dashes.
|
||||||
|
|
||||||
'innerHTML'.dasherize() => 'inner-html'
|
'innerHTML'.dasherize() => 'inner-html'
|
||||||
'action_name'.dasherize() => 'action-name'
|
'action_name'.dasherize() => 'action-name'
|
||||||
'css-class-name'.dasherize() => 'css-class-name'
|
'css-class-name'.dasherize() => 'css-class-name'
|
||||||
|
@ -9691,7 +9692,7 @@ Ember.MutableArray = Ember.Mixin.create(Ember.Array, Ember.MutableEnumerable,
|
||||||
colors.length(); => 0
|
colors.length(); => 0
|
||||||
|
|
||||||
@method clear
|
@method clear
|
||||||
@return {Ember.Array} An empty Array.
|
@return {Ember.Array} An empty Array.
|
||||||
*/
|
*/
|
||||||
clear: function () {
|
clear: function () {
|
||||||
var len = get(this, 'length');
|
var len = get(this, 'length');
|
||||||
|
@ -11472,7 +11473,7 @@ Ember.ArrayProxy = Ember.Object.extend(Ember.MutableArray,
|
||||||
The array that the proxy pretends to be. In the default `ArrayProxy`
|
The array that the proxy pretends to be. In the default `ArrayProxy`
|
||||||
implementation, this and `content` are the same. Subclasses of `ArrayProxy`
|
implementation, this and `content` are the same. Subclasses of `ArrayProxy`
|
||||||
can override this property to provide things like sorting and filtering.
|
can override this property to provide things like sorting and filtering.
|
||||||
|
|
||||||
@property arrangedContent
|
@property arrangedContent
|
||||||
*/
|
*/
|
||||||
arrangedContent: Ember.computed('content', function() {
|
arrangedContent: Ember.computed('content', function() {
|
||||||
|
@ -14140,9 +14141,9 @@ Ember.ControllerMixin.reopen({
|
||||||
}
|
}
|
||||||
|
|
||||||
outletName = outletName || 'view';
|
outletName = outletName || 'view';
|
||||||
|
|
||||||
Ember.assert("The viewClass is either missing or the one provided did not resolve to a view", !!name || (!name && !!viewClass));
|
Ember.assert("The viewClass is either missing or the one provided did not resolve to a view", !!name || (!name && !!viewClass));
|
||||||
|
|
||||||
Ember.assert("You must supply a name or a viewClass to connectOutlet, but not both", (!!name && !viewClass && !controller) || (!name && !!viewClass));
|
Ember.assert("You must supply a name or a viewClass to connectOutlet, but not both", (!!name && !viewClass && !controller) || (!name && !!viewClass));
|
||||||
|
|
||||||
if (name) {
|
if (name) {
|
||||||
|
@ -14279,7 +14280,7 @@ var invokeForState = {
|
||||||
`Ember.View` is the class in Ember responsible for encapsulating templates of HTML
|
`Ember.View` is the class in Ember responsible for encapsulating templates of HTML
|
||||||
content, combining templates with data to render as sections of a page's DOM, and
|
content, combining templates with data to render as sections of a page's DOM, and
|
||||||
registering and responding to user-initiated events.
|
registering and responding to user-initiated events.
|
||||||
|
|
||||||
## HTML Tag
|
## HTML Tag
|
||||||
The default HTML tag name used for a view's DOM representation is `div`. This can be
|
The default HTML tag name used for a view's DOM representation is `div`. This can be
|
||||||
customized by setting the `tagName` property. The following view class:
|
customized by setting the `tagName` property. The following view class:
|
||||||
|
@ -14313,7 +14314,7 @@ var invokeForState = {
|
||||||
```
|
```
|
||||||
|
|
||||||
`class` attribute values can also be set by providing a `classNameBindings` property
|
`class` attribute values can also be set by providing a `classNameBindings` property
|
||||||
set to an array of properties names for the view. The return value of these properties
|
set to an array of properties names for the view. The return value of these properties
|
||||||
will be added as part of the value for the view's `class` attribute. These properties
|
will be added as part of the value for the view's `class` attribute. These properties
|
||||||
can be computed properties:
|
can be computed properties:
|
||||||
|
|
||||||
|
@ -14350,7 +14351,7 @@ var invokeForState = {
|
||||||
<div id="ember1" class="ember-view hovered"></div>
|
<div id="ember1" class="ember-view hovered"></div>
|
||||||
```
|
```
|
||||||
|
|
||||||
When using boolean class name bindings you can supply a string value other than the
|
When using boolean class name bindings you can supply a string value other than the
|
||||||
property name for use as the `class` HTML attribute by appending the preferred value after
|
property name for use as the `class` HTML attribute by appending the preferred value after
|
||||||
a ":" character when defining the binding:
|
a ":" character when defining the binding:
|
||||||
|
|
||||||
|
@ -14420,7 +14421,7 @@ var invokeForState = {
|
||||||
|
|
||||||
``` html
|
``` html
|
||||||
<div id="ember1" class="ember-view enabled"></div>
|
<div id="ember1" class="ember-view enabled"></div>
|
||||||
```
|
```
|
||||||
|
|
||||||
When isEnabled is `false`, the resulting HTML reprensentation looks like this:
|
When isEnabled is `false`, the resulting HTML reprensentation looks like this:
|
||||||
|
|
||||||
|
@ -14451,11 +14452,11 @@ var invokeForState = {
|
||||||
<div id="ember1" class="ember-view disabled"></div>
|
<div id="ember1" class="ember-view disabled"></div>
|
||||||
```
|
```
|
||||||
|
|
||||||
Updates to the the value of a class name binding will result in automatic update
|
Updates to the the value of a class name binding will result in automatic update
|
||||||
of the HTML `class` attribute in the view's rendered HTML representation.
|
of the HTML `class` attribute in the view's rendered HTML representation.
|
||||||
If the value becomes `false` or `undefined` the class name will be removed.
|
If the value becomes `false` or `undefined` the class name will be removed.
|
||||||
|
|
||||||
Both `classNames` and `classNameBindings` are concatenated properties.
|
Both `classNames` and `classNameBindings` are concatenated properties.
|
||||||
See `Ember.Object` documentation for more information about concatenated properties.
|
See `Ember.Object` documentation for more information about concatenated properties.
|
||||||
|
|
||||||
## HTML Attributes
|
## HTML Attributes
|
||||||
|
@ -14512,7 +14513,7 @@ var invokeForState = {
|
||||||
});
|
});
|
||||||
```
|
```
|
||||||
|
|
||||||
Updates to the the property of an attribute binding will result in automatic update
|
Updates to the the property of an attribute binding will result in automatic update
|
||||||
of the HTML attribute in the view's rendered HTML representation.
|
of the HTML attribute in the view's rendered HTML representation.
|
||||||
|
|
||||||
`attributeBindings` is a concatenated property. See `Ember.Object` documentation
|
`attributeBindings` is a concatenated property. See `Ember.Object` documentation
|
||||||
|
@ -14534,7 +14535,7 @@ var invokeForState = {
|
||||||
|
|
||||||
``` html
|
``` html
|
||||||
<div id="ember1" class="ember-view">I am the template</div>
|
<div id="ember1" class="ember-view">I am the template</div>
|
||||||
```
|
```
|
||||||
|
|
||||||
The default context of the compiled template will be the view instance itself:
|
The default context of the compiled template will be the view instance itself:
|
||||||
|
|
||||||
|
@ -14624,7 +14625,7 @@ var invokeForState = {
|
||||||
primary templates, layouts can be any function that accepts an optional context
|
primary templates, layouts can be any function that accepts an optional context
|
||||||
parameter and returns a string of HTML that will be inserted inside view's tag. Views whose HTML
|
parameter and returns a string of HTML that will be inserted inside view's tag. Views whose HTML
|
||||||
element is self closing (e.g. `<input />`) cannot have a layout and this property will be ignored.
|
element is self closing (e.g. `<input />`) cannot have a layout and this property will be ignored.
|
||||||
|
|
||||||
Most typically in Ember a layout will be a compiled Ember.Handlebars template.
|
Most typically in Ember a layout will be a compiled Ember.Handlebars template.
|
||||||
|
|
||||||
A view's layout can be set directly with the `layout` property or reference an
|
A view's layout can be set directly with the `layout` property or reference an
|
||||||
|
@ -14654,7 +14655,7 @@ var invokeForState = {
|
||||||
|
|
||||||
## Responding to Browser Events
|
## Responding to Browser Events
|
||||||
|
|
||||||
Views can respond to user-initiated events in one of three ways: method implementation,
|
Views can respond to user-initiated events in one of three ways: method implementation,
|
||||||
through an event manager, and through `{{action}}` helper use in their template or layout.
|
through an event manager, and through `{{action}}` helper use in their template or layout.
|
||||||
|
|
||||||
### Method Implementation
|
### Method Implementation
|
||||||
|
@ -14675,8 +14676,8 @@ var invokeForState = {
|
||||||
|
|
||||||
Views can define an object as their `eventManager` property. This object can then
|
Views can define an object as their `eventManager` property. This object can then
|
||||||
implement methods that match the desired event names. Matching events that occur
|
implement methods that match the desired event names. Matching events that occur
|
||||||
on the view's rendered HTML or the rendered HTML of any of its DOM descendants
|
on the view's rendered HTML or the rendered HTML of any of its DOM descendants
|
||||||
will trigger this method. A `jQuery.Event` object will be passed as the first
|
will trigger this method. A `jQuery.Event` object will be passed as the first
|
||||||
argument to the method and an `Ember.View` object as the second. The `Ember.View`
|
argument to the method and an `Ember.View` object as the second. The `Ember.View`
|
||||||
will be the view whose rendered HTML was interacted with. This may be the view with
|
will be the view whose rendered HTML was interacted with. This may be the view with
|
||||||
the `eventManager` property or one of its descendent views.
|
the `eventManager` property or one of its descendent views.
|
||||||
|
@ -14713,7 +14714,7 @@ var invokeForState = {
|
||||||
|
|
||||||
Similarly a view's event manager will take precedence for events of any views
|
Similarly a view's event manager will take precedence for events of any views
|
||||||
rendered as a descendent. A method name that matches an event name will not be called
|
rendered as a descendent. A method name that matches an event name will not be called
|
||||||
if the view instance was rendered inside the HTML representation of a view that has
|
if the view instance was rendered inside the HTML representation of a view that has
|
||||||
an `eventManager` property defined that handles events of the name. Events not handled
|
an `eventManager` property defined that handles events of the name. Events not handled
|
||||||
by the event manager will still trigger method calls on the descendent.
|
by the event manager will still trigger method calls on the descendent.
|
||||||
|
|
||||||
|
@ -14736,7 +14737,7 @@ var invokeForState = {
|
||||||
// eventManager doesn't handle click events
|
// eventManager doesn't handle click events
|
||||||
},
|
},
|
||||||
mouseEnter: function(event){
|
mouseEnter: function(event){
|
||||||
// will never be called if rendered inside
|
// will never be called if rendered inside
|
||||||
// an OuterView.
|
// an OuterView.
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
@ -14760,9 +14761,9 @@ var invokeForState = {
|
||||||
Form events: 'submit', 'change', 'focusIn', 'focusOut', 'input'
|
Form events: 'submit', 'change', 'focusIn', 'focusOut', 'input'
|
||||||
|
|
||||||
HTML5 drag and drop events: 'dragStart', 'drag', 'dragEnter', 'dragLeave', 'drop', 'dragEnd'
|
HTML5 drag and drop events: 'dragStart', 'drag', 'dragEnter', 'dragLeave', 'drop', 'dragEnd'
|
||||||
|
|
||||||
## Handlebars `{{view}}` Helper
|
## Handlebars `{{view}}` Helper
|
||||||
|
|
||||||
Other `Ember.View` instances can be included as part of a view's template by using the `{{view}}`
|
Other `Ember.View` instances can be included as part of a view's template by using the `{{view}}`
|
||||||
Handlebars helper. See `Handlebars.helpers.view` for additional information.
|
Handlebars helper. See `Handlebars.helpers.view` for additional information.
|
||||||
|
|
||||||
|
@ -16939,7 +16940,7 @@ var childViewsProperty = Ember.computed(function() {
|
||||||
});
|
});
|
||||||
|
|
||||||
aContainer.appendTo('body');
|
aContainer.appendTo('body');
|
||||||
```
|
```
|
||||||
|
|
||||||
Results in the HTML
|
Results in the HTML
|
||||||
|
|
||||||
|
@ -17352,7 +17353,7 @@ var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
`Ember.CollectionView` is an `Ember.View` descendent responsible for managing a
|
`Ember.CollectionView` is an `Ember.View` descendent responsible for managing a
|
||||||
collection (an array or array-like object) by maintaing a child view object and
|
collection (an array or array-like object) by maintaing a child view object and
|
||||||
associated DOM representation for each item in the array and ensuring that child
|
associated DOM representation for each item in the array and ensuring that child
|
||||||
views and their associated rendered HTML are updated when items in the array
|
views and their associated rendered HTML are updated when items in the array
|
||||||
are added, removed, or replaced.
|
are added, removed, or replaced.
|
||||||
|
@ -17377,7 +17378,7 @@ var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt;
|
||||||
|
|
||||||
Given an empty `<body>` and the following code:
|
Given an empty `<body>` and the following code:
|
||||||
|
|
||||||
``` javascript
|
``` javascript
|
||||||
someItemsView = Ember.CollectionView.create({
|
someItemsView = Ember.CollectionView.create({
|
||||||
classNames: ['a-collection'],
|
classNames: ['a-collection'],
|
||||||
content: ['A','B','C'],
|
content: ['A','B','C'],
|
||||||
|
@ -17401,7 +17402,7 @@ var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt;
|
||||||
|
|
||||||
## Automatic matching of parent/child tagNames
|
## Automatic matching of parent/child tagNames
|
||||||
|
|
||||||
Setting the `tagName` property of a `CollectionView` to any of
|
Setting the `tagName` property of a `CollectionView` to any of
|
||||||
"ul", "ol", "table", "thead", "tbody", "tfoot", "tr", or "select" will result
|
"ul", "ol", "table", "thead", "tbody", "tfoot", "tr", or "select" will result
|
||||||
in the item views receiving an appropriately matched `tagName` property.
|
in the item views receiving an appropriately matched `tagName` property.
|
||||||
|
|
||||||
|
@ -22124,7 +22125,7 @@ EmberHandlebars.ViewHelper = Ember.Object.create({
|
||||||
|
|
||||||
``` html
|
``` html
|
||||||
<body>
|
<body>
|
||||||
<!-- Note: the handlebars template script
|
<!-- Note: the handlebars template script
|
||||||
also results in a rendered Ember.View
|
also results in a rendered Ember.View
|
||||||
which is the outer <div> here -->
|
which is the outer <div> here -->
|
||||||
|
|
||||||
|
@ -22149,7 +22150,7 @@ EmberHandlebars.ViewHelper = Ember.Object.create({
|
||||||
|
|
||||||
aView.appendTo('body');
|
aView.appendTo('body');
|
||||||
```
|
```
|
||||||
|
|
||||||
Will result in HTML structure:
|
Will result in HTML structure:
|
||||||
|
|
||||||
``` html
|
``` html
|
||||||
|
@ -22239,7 +22240,7 @@ EmberHandlebars.ViewHelper = Ember.Object.create({
|
||||||
|
|
||||||
``` html
|
``` html
|
||||||
<div id="ember1" class="ember-view">
|
<div id="ember1" class="ember-view">
|
||||||
<div id="ember2" class="ember-view a-custom-view-class-as-property">
|
<div id="ember2" class="ember-view a-custom-view-class-as-property">
|
||||||
hi
|
hi
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
@ -22676,7 +22677,7 @@ Ember.Handlebars.EachView = Ember.CollectionView.extend(Ember._Metamorph, {
|
||||||
``` handlebars
|
``` handlebars
|
||||||
<script type="text/x-handlebars">
|
<script type="text/x-handlebars">
|
||||||
{{#view App.MyView }}
|
{{#view App.MyView }}
|
||||||
{{each view.items itemViewClass="App.AnItemView"}}
|
{{each view.items itemViewClass="App.AnItemView"}}
|
||||||
{{/view}}
|
{{/view}}
|
||||||
</script>
|
</script>
|
||||||
```
|
```
|
||||||
|
@ -22697,10 +22698,10 @@ Ember.Handlebars.EachView = Ember.CollectionView.extend(Ember._Metamorph, {
|
||||||
App.AnItemView = Ember.View.extend({
|
App.AnItemView = Ember.View.extend({
|
||||||
template: Ember.Handlebars.compile("Greetings {{name}}")
|
template: Ember.Handlebars.compile("Greetings {{name}}")
|
||||||
});
|
});
|
||||||
|
|
||||||
App.initialize();
|
App.initialize();
|
||||||
```
|
```
|
||||||
|
|
||||||
Will result in the HTML structure below
|
Will result in the HTML structure below
|
||||||
|
|
||||||
``` html
|
``` html
|
||||||
|
@ -22859,7 +22860,7 @@ ActionHelper.registerAction = function(actionName, options) {
|
||||||
The `{{action}}` helper registers an HTML element within a template for
|
The `{{action}}` helper registers an HTML element within a template for
|
||||||
DOM event handling and forwards that interaction to the Application's router,
|
DOM event handling and forwards that interaction to the Application's router,
|
||||||
the template's `Ember.View` instance, or supplied `target` option (see 'Specifying a Target').
|
the template's `Ember.View` instance, or supplied `target` option (see 'Specifying a Target').
|
||||||
|
|
||||||
User interaction with that element will invoke the supplied action name on
|
User interaction with that element will invoke the supplied action name on
|
||||||
the appropriate target.
|
the appropriate target.
|
||||||
|
|
||||||
|
@ -22910,7 +22911,7 @@ ActionHelper.registerAction = function(actionName, options) {
|
||||||
If you need the default handler to trigger you should either register your
|
If you need the default handler to trigger you should either register your
|
||||||
own event handler, or use event methods on your view class. See Ember.View
|
own event handler, or use event methods on your view class. See Ember.View
|
||||||
'Responding to Browser Events' for more information.
|
'Responding to Browser Events' for more information.
|
||||||
|
|
||||||
### Specifying DOM event type
|
### Specifying DOM event type
|
||||||
|
|
||||||
By default the `{{action}}` helper registers for DOM `click` events. You can
|
By default the `{{action}}` helper registers for DOM `click` events. You can
|
||||||
|
@ -22932,23 +22933,23 @@ ActionHelper.registerAction = function(actionName, options) {
|
||||||
`Ember.EventDispatcher` instance will be created when a new
|
`Ember.EventDispatcher` instance will be created when a new
|
||||||
`Ember.Application` is created. Having an instance of `Ember.Application`
|
`Ember.Application` is created. Having an instance of `Ember.Application`
|
||||||
will satisfy this requirement.
|
will satisfy this requirement.
|
||||||
|
|
||||||
|
|
||||||
### Specifying a Target
|
### Specifying a Target
|
||||||
There are several possible target objects for `{{action}}` helpers:
|
There are several possible target objects for `{{action}}` helpers:
|
||||||
|
|
||||||
In a typical `Ember.Router`-backed Application where views are managed
|
In a typical `Ember.Router`-backed Application where views are managed
|
||||||
through use of the `{{outlet}}` helper, actions will be forwarded to the
|
through use of the `{{outlet}}` helper, actions will be forwarded to the
|
||||||
current state of the Applications's Router. See Ember.Router 'Responding
|
current state of the Applications's Router. See Ember.Router 'Responding
|
||||||
to User-initiated Events' for more information.
|
to User-initiated Events' for more information.
|
||||||
|
|
||||||
If you manually set the `target` property on the controller of a template's
|
If you manually set the `target` property on the controller of a template's
|
||||||
`Ember.View` instance, the specifed `controller.target` will become the target
|
`Ember.View` instance, the specifed `controller.target` will become the target
|
||||||
for any actions. Likely custom values for a controller's `target` are the
|
for any actions. Likely custom values for a controller's `target` are the
|
||||||
controller itself or a StateManager other than the Application's Router.
|
controller itself or a StateManager other than the Application's Router.
|
||||||
|
|
||||||
If the templates's view lacks a controller property the view itself is the target.
|
If the templates's view lacks a controller property the view itself is the target.
|
||||||
|
|
||||||
Finally, a `target` option can be provided to the helper to change which object
|
Finally, a `target` option can be provided to the helper to change which object
|
||||||
will receive the method call. This option must be a string representing a
|
will receive the method call. This option must be a string representing a
|
||||||
path to an object:
|
path to an object:
|
||||||
|
@ -23011,7 +23012,7 @@ ActionHelper.registerAction = function(actionName, options) {
|
||||||
|
|
||||||
Will throw `Uncaught TypeError: Cannot call method 'call' of undefined` when
|
Will throw `Uncaught TypeError: Cannot call method 'call' of undefined` when
|
||||||
"click me" is clicked.
|
"click me" is clicked.
|
||||||
|
|
||||||
### Specifying a context
|
### Specifying a context
|
||||||
|
|
||||||
By default the `{{action}}` helper passes the current Handlebars context
|
By default the `{{action}}` helper passes the current Handlebars context
|
||||||
|
@ -23240,7 +23241,7 @@ Ember.Handlebars.registerHelper('outlet', function(property, options) {
|
||||||
var set = Ember.set, get = Ember.get;
|
var set = Ember.set, get = Ember.get;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
The `Ember.Checkbox` view class renders a checkbox [input](https://developer.mozilla.org/en/HTML/Element/Input)
|
The `Ember.Checkbox` view class renders a checkbox [input](https://developer.mozilla.org/en/HTML/Element/Input)
|
||||||
element. It allows for binding an Ember property (`checked`) to the status of the checkbox.
|
element. It allows for binding an Ember property (`checked`) to the status of the checkbox.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
|
@ -23252,7 +23253,7 @@ var set = Ember.set, get = Ember.get;
|
||||||
You can add a `label` tag yourself in the template where the Ember.Checkbox is being used.
|
You can add a `label` tag yourself in the template where the Ember.Checkbox is being used.
|
||||||
|
|
||||||
``` html
|
``` html
|
||||||
<label>
|
<label>
|
||||||
{{view Ember.Checkbox classNames="applicaton-specific-checkbox"}}
|
{{view Ember.Checkbox classNames="applicaton-specific-checkbox"}}
|
||||||
Some Title
|
Some Title
|
||||||
</label>
|
</label>
|
||||||
|
@ -23569,7 +23570,7 @@ var get = Ember.get, set = Ember.set;
|
||||||
|
|
||||||
## Layout and LayoutName properties
|
## Layout and LayoutName properties
|
||||||
|
|
||||||
Because HTML `textarea` elements do not contain inner HTML the `layout` and `layoutName`
|
Because HTML `textarea` elements do not contain inner HTML the `layout` and `layoutName`
|
||||||
properties will not be applied. See `Ember.View`'s layout section for more information.
|
properties will not be applied. See `Ember.View`'s layout section for more information.
|
||||||
|
|
||||||
@class TextArea
|
@class TextArea
|
||||||
|
@ -23714,7 +23715,7 @@ var indexOf = Ember.EnumerableUtils.indexOf, indexesOf = Ember.EnumerableUtils.i
|
||||||
/**
|
/**
|
||||||
The Ember.Select view class renders a
|
The Ember.Select view class renders a
|
||||||
[select](https://developer.mozilla.org/en/HTML/Element/select) HTML element,
|
[select](https://developer.mozilla.org/en/HTML/Element/select) HTML element,
|
||||||
allowing the user to choose from a list of options.
|
allowing the user to choose from a list of options.
|
||||||
|
|
||||||
The text and `value` property of each `<option>` element within the `<select>` element
|
The text and `value` property of each `<option>` element within the `<select>` element
|
||||||
are populated from the objects in the Element.Select's `content` property. The
|
are populated from the objects in the Element.Select's `content` property. The
|
||||||
|
@ -23772,7 +23773,7 @@ var indexOf = Ember.EnumerableUtils.indexOf, indexesOf = Ember.EnumerableUtils.i
|
||||||
```
|
```
|
||||||
|
|
||||||
A user interacting with the rendered `<select>` to choose "Yehuda" would update
|
A user interacting with the rendered `<select>` to choose "Yehuda" would update
|
||||||
the value of `App.controller.selected` to "Yehuda".
|
the value of `App.controller.selected` to "Yehuda".
|
||||||
|
|
||||||
### `content` as an Array of Objects
|
### `content` as an Array of Objects
|
||||||
An Ember.Select can also take an array of JavaScript or Ember objects
|
An Ember.Select can also take an array of JavaScript or Ember objects
|
||||||
|
@ -23783,8 +23784,8 @@ var indexOf = Ember.EnumerableUtils.indexOf, indexesOf = Ember.EnumerableUtils.i
|
||||||
and which property should be used to supply the element text.
|
and which property should be used to supply the element text.
|
||||||
|
|
||||||
The `optionValuePath` option is used to specify the path on each object to
|
The `optionValuePath` option is used to specify the path on each object to
|
||||||
the desired property for the `value` attribute. The `optionLabelPath`
|
the desired property for the `value` attribute. The `optionLabelPath`
|
||||||
specifies the path on each object to the desired property for the
|
specifies the path on each object to the desired property for the
|
||||||
element's text. Both paths must reference each object itself as 'content':
|
element's text. Both paths must reference each object itself as 'content':
|
||||||
|
|
||||||
``` javascript
|
``` javascript
|
||||||
|
@ -23853,7 +23854,7 @@ var indexOf = Ember.EnumerableUtils.indexOf, indexesOf = Ember.EnumerableUtils.i
|
||||||
used to render each object providing a `selectionBinding`. When the selected
|
used to render each object providing a `selectionBinding`. When the selected
|
||||||
`<option>` is changed, the property path provided to `selectionBinding`
|
`<option>` is changed, the property path provided to `selectionBinding`
|
||||||
will be updated to match the content object of the rendered `<option>`
|
will be updated to match the content object of the rendered `<option>`
|
||||||
element:
|
element:
|
||||||
|
|
||||||
``` javascript
|
``` javascript
|
||||||
App.controller = Ember.Object.create({
|
App.controller = Ember.Object.create({
|
||||||
|
@ -23887,7 +23888,7 @@ var indexOf = Ember.EnumerableUtils.indexOf, indexesOf = Ember.EnumerableUtils.i
|
||||||
Interacting with the rendered element by selecting the first option
|
Interacting with the rendered element by selecting the first option
|
||||||
('Yehuda') will update the `selectedPerson` value of `App.controller`
|
('Yehuda') will update the `selectedPerson` value of `App.controller`
|
||||||
to match the content object of the newly selected `<option>`. In this
|
to match the content object of the newly selected `<option>`. In this
|
||||||
case it is the first object in the `App.content.content`
|
case it is the first object in the `App.content.content`
|
||||||
|
|
||||||
### Supplying a Prompt
|
### Supplying a Prompt
|
||||||
|
|
||||||
|
@ -24308,8 +24309,8 @@ Ember Handlebars
|
||||||
|
|
||||||
})();
|
})();
|
||||||
|
|
||||||
// Version: v1.0.pre-157-g896f794
|
// Version: v1.0.pre-161-g4255d0a
|
||||||
// Last commit: 896f794 (2012-09-26 21:30:45 +0200)
|
// Last commit: 4255d0a (2012-09-27 14:32:08 +0200)
|
||||||
|
|
||||||
|
|
||||||
(function() {
|
(function() {
|
||||||
|
|
Loading…
Reference in New Issue
Block a user