WinJS.Binding.processAll function

Binds the values of an object to the values of a DOM element that has the data-win-bind attribute. If multiple DOM elements are to be bound, you must set the attribute on all of them. See the example below for details.

Syntax

WinJS.Binding.processAll(rootElement, dataContext, skipRoot, bindingCache, defaultInitializer).done( /* Your success and error handlers */ );

Parameters

rootElement

Type: DOMElement

Optional. The element at which to start traversing to find elements to bind to. If this parameter is omitted, the entire document is searched.

dataContext

Type: Object

The object that contains the values to which the DOM element should be bound. One-time binding is used when this parameter is the window object or a Windows Runtime object.

Note  It is not advisable to pass the window object as processAll'sdataContext. Instead, it is better practice to create a separate object and pass that to the dataContext.

 

skipRoot

Type: Boolean

If true, specifies that only the children of rootElement should be bound, otherwise rootElement should be bound as well.

bindingCache

Type: Object

The cached binding data.

defaultInitializer

Type: Function

The binding initializer to use in the case that one is not specified in a binding expression. If not provided, the behavior is the same as Binding.defaultBind.

Return value

Type: Promise

A Promise that completes when every item that contains the data-win-bind attribute has been processed and the update has started.

Remarks

It's best not to pass the window object as processAll's dataContext. Instead, create your own dataContext object.

When using data binding, your data context should:

• Only contain data (i.e. no functions)
• Not contain any non-extensible objects

Requirements