DHTMLX Docs & Samples Explorer

Migration to dhtmlxGrid 1.6

dhtmlxGrid 1.6 has some serious changes that may cause problems with the previously written code.

  • Event System:
    • onMathEnd event removed as in dhtmlxGrid 1.6 math values are calculated in sync mode, so they are available without delays;
    • All direct event setting methods (setOnSome…) that were deprecated in the previous version of the grid, are removed from the main code base. Now the only possible way to attach events is to use grid.attachEvent(…

If you still need old methods, you can include the following additional file in his project: ext/dhtmlxgrid_deprecated.js.

  • Smart Rendering - the following methods are deprecated:
    • enableSmartRenderingSorting;
    • enableDOMLimit.
  • Paging - in case of dynamical paging, the grid uses the same variables and waits for the same response as in case of dynamical smart rendering (basically, the user is able to apply the same server side code to organize dynamical paging and dynamical smart rendering). The following methods were deprecated:
    • enablePagingWT();
    • setPagingWTMode();
    • setPagingBlockParent();
    • setRecordsInfoParent();
    • enableRecordsInfo();
    • getNoRecordsString();
    • setNoRecordsString();
    • getRecordsInfoTemplate();
    • setRecordsInfoTemplatedc();
    • getPagePrefix();
    • setPagePrefix();

Since v1.6 the user can apply a skin on paging. At the moment of version 1.6. release, there are two skins (in addition to the default view) available:

  • “bricks” (it has 3 color schemas. Color schema is applied automatically based on the skin the user chooses for the grid itself);
  • “toolbar” (it uses dhtmlxToolbar to place paging controls). To apply paging skin, the following command should be used:
        grid.setPagingSkin("bricks"); //need to be added after enablePaging 
 
  • Loading from CSV - Auto ID mode is enabled by default.
  • Global modes:
    • enableBuffering() method is deprecated (there is no sense in it anymore as the grid uses buffering automatically);
    • findCell() was moved to dhtmlxgrid_filter.js, it returns row ids instead of row indexes (ids are more reliable).
  • TreeGrid Extension:
    • smartXMLParsing mode is enabled by default;
    • If the user applies ”=sum” in TreeGrid, he should disable smartXMLParsing by grid.enableSmartXMLParsing(false) command.