|Developers:||Rahul Akolkar, Ed Chatelain|
Deprecated. Provides the ability for dijits or custom view components to become data binding aware. Data binding awareness enables Dijits or other view layer components to bind to locations within a client-side data model, which is commonly an instance of the dojox.mvc.StatefulModel class. A bind is a bi-directional update mechanism which is capable of synchronizing value changes between the bound dijit or other view component and the specified location within the data model, as well as changes to other properties such as "valid", "required", "readOnly" etc
|ref||String or StatefulModel||The value of the data binding expression passed declaratively by the developer. This usually references a location within an existing datamodel and may be a relative reference based on the parent / container data binding (dot-separated string).|
Returns the validity of the data binding. This function is meant to provide an API bridge to the dijit API. Validity of data-bound Dijits is a function of multiple concerns:
In order for Dijits to function correctly in data-bound environments, it is imperative that their isValid() functions assess the model validity of the data binding via the this.inherited(arguments) hierarchy and declare any values failing the test as invalid.