Class sap.ui.model.DataStateModule: sap/ui/model/DataState

Provides and update the status data of a binding. Depending on the models state and controls state changes, the data state is used to propagated changes to a control. The control can react on these changes by implementing the refreshDataState method for the control. Here the the data state object is passed as a parameter.

Using the getChanges method the control can determine the changed properties and their old and new value.

    //sample implementation to handle message changes
    myControl.prototype.refreshDataState = function(oDataState) {
       var aMessages = oDataState.getChanges().messages;
       if (aMessages) {
           for (var i = 0; i < aMessages.length; i++) {
               console.log(aMessages.message);
           }
       }
    }

    //sample implementation to handle laundering state
    myControl.prototype.refreshDataState = function(oDataState) {
       var bLaundering = oDataState.getChanges().laundering || false;
       this.setBusy(bLaundering);
    }

    //sample implementation to handle dirty state
    myControl.prototype.refreshDataState = function(oDataState) {
       if (oDataState.isDirty()) console.log("Control " + this.getId() + " is now dirty");
    }

Using the getProperty method the control can read the properties of the data state. The properties are

• value The value formatted by the formatter of the binding
• originalValue The original value of the model formatted by the formatter of the binding
• invalidValue The control value that was tried to be applied to the model but was rejected by a type validation
• modelMessages The messages that were applied to the binding by the sap.ui.model.MessageModel
• controlMessages The messages that were applied due to type validation errors
• messages All messages of the data state
• dirty true if the value was not yet confirmed by the server