Spry User Guide - Support - Adobe

...
function myRegionCallback(notificationState, notifier, data)
{
if (notificationType == "onPreUpdate")
alert(regionID + " is starting an update!");
else if (notificationType == "onPostUpdate")
alert(regionID + " is done updating!");
}
...
// Call addObserver() to register your function as an observer.
Spry.Data.Region.addObserver("employeeListRegion", MyRegionCallback);
...
// You can unregister your callback function so it stops recieving notifications
// with a call to removeObserver().
Spry.Data.Region.removeObserver("employeeListRegion", MyRegionCallback);
...
...
...
A function observer is registered with the same call to addObserver().
When the function is called, the first argument passed into it is the notification type. This is a string that is the name
of the notification. The second argument is the notifier, which in this case is not the region object. The third
argument is a data object that has a regionID property that tells us what region triggered the notification.
To stop a function observer from receiving notifications, it must be removed from the list of observers with a call to
removeObserver().
The following table describes the current set of supported notifications.
Region notification type Description
onLoadingData One or more of the region's bound data sets is loading its data.
onPreUpdate All of the region's bound data sets have loaded successfully. The
region is about to regenerate its code.
onPostUpdate The region has regenerated its code and inserted it into the document.
onError An error occurred while loading data.
Data reference options
Each data set has a set of built-in data references that can be useful during the dynamic region regeneration process.
Like data set column names, these built-in data references must be prefixed with the name of the data set if the
dynamic region is bound to more than one data set.
For example, to display the row number of the current row of the data set when the region regenerates, add the
ds_RowNumber data reference to the dynamic region, as follows:
SPRY
User Guide
135