GitHub
Twitterkey:to
One-way bind a value from the StacheElement, can-component ViewModel, or element to the parent scope.
childProp:to="key"
Exports childProp in the StacheElement or can-component ViewModel to key in the parent scope. It also updates
key with the value of childProp when childProp changes.
<my-element someProp:to="value" />
Note: If key is an object, changes to the object’s properties will still be visible to the component. Objects are passed by reference. See One Way Binding With Objects.
Parameters
- childProp
{String}:The name of the property to export from the child StacheElement or component’s ViewModel. Use
this:toor.:toto export the entire viewModel. - key
{Literal Expression|KeyLookup Expression|Call Expression|Helper Expression}:An expression that will be used to set in the parent scope.
child-prop:to="key"
Exports the element’s child-prop property or attribute to key in the parent scope. It also updates
key with the value of child-prop when child-prop changes.
<input value:to="name" />
Parameters
- child-prop
{String}:The name of the element’s property or attribute to export.
- key
{Literal Expression|KeyLookup Expression|Call Expression|Helper Expression}:An expression whose resulting value with be used to set in the parent scope.
vm:childProp:to="key"
Exports childProp in the StacheElement or can-component ViewModel to key in the parent scope. It also updates
key with the value of childProp when childProp changes.
<my-element vm:someProp:to="value" />
Note: If key is an object, changes to the object’s properties will still be visible to the component. Objects are passed by reference. See One Way Binding With Objects.
Parameters are the same as childProp:to="key"
el:child-prop:to="key"
Exports the element’s child-prop property or attribute to key in the parent scope. It also updates
key with the value of child-prop when child-prop changes.
<input el:value:to="name" />
Parameters are the same as child-prop:to="key"
on:VIEW_MODEL_OR_DOM_EVENT:KEY:to='SCOPE_VALUE'
If the element is a can-stache-element, listens to an event on the element and binds the element’s value to the SCOPE_VALUE when that event occurs.
If the element is a can-component, listens to an event on the ViewModel and binds the element’s value to the SCOPE_VALUE when that event occurs.
For all other elements, listens to an event on the element and binds binds the element’s value to the SCOPE_VALUE when that event occurs.
<my-element on:show:value:to="myScopeProp" />
Parameters
- VIEW_MODEL_OR_DOM_EVENT
{String}:A viewModel or DOM event.
- SCOPE_VALUE
{String}:A value in the current scope.
Use
The can-stache-bindings page has many examples of key:to. Specifically: