The class 'zdk-synchronize' is optional and can be used for optimizing the display of a view when it contains one or several datatables.
Indeed, when this class is set for a zdkdatatable
widget, its parent view is only displayed when the datatable's rows are fully loaded from a dedicated remote controller action.
Without this class, the view is displayed just after its loading by an AJAX request, even if the datatables into the view do not have yet their rows loaded.
This class only applies to the zdkdatatable
widget when the 'office
' or 'custom
' page layout is configured for your application.
To experiment the behavior described above, add a sleep(5) PHP statement into the controller action that supplies the data rows to a datatable, in order to delay the HTTP response.
Next, remove the 'zdk-synchronize' class to the datatable and open the view from your application.
You will see that the view is displayed with an empty datatable during 5 seconds until the data rows are finally received.
Hoping it is clearer now.