Released 2008-07-15

IMPORTANT: Required Actions for Updating

1. Some methods, parameters or options have been removed in this release; please refer to Obsolete Properties and Obsolete Methods to see what has been removed and what to use instead.

2. The distribution of code across modules has been enhanced to allow for future expansion while still keeping the basic package as small as possible. Please review the contents of jquery.jqGrid.js to see what you may need to add or change. See Installation.

3. Additions have been made to the CSS files (in themes); either replace the previous versions with what comes with this release or, if you have incorporated the jqGrid CSS settings into your own CSS files, review and revise the sections noted here:
   

   /* Pager *//
   ...
   /* End Pager *//

   and
   

   /*Subgrid  text mode*//
   ...
   /* End Subgrid *//

4. Previous versions of jqModal are not compatible with jQuery 1.2.6; please replace your copy of jqModal.js with the updated version included in this release.
   

Bug Fixes

• corrected bug in delRowData and setRowData methods when using two or more grids and trying to delete/update a row with the same id
  
• corrected bug with url parameter in editGridRow (now the url can be changed dynamically)
  
• corrected bug in modal window
  
• corrected bug in formedit with class names
  
• corrected bug when the [Enter] key is pressed in editGridRow
  
• corrected bug in Safari 3 when resizing columns
  
• corrected bug with header columns and data columns position
  
• corrected misaligment between table header and table rows bug in IE (this reduces the header width by 1px and previously tight columns may now cut off the header text slightly)
  
• corrected bug in hideCol and showCol methods in IE
  
• corrected bug in IE when inline edit of element of type select
  
• corrected bug in safari when try to use pager in grid as subgrid
  
• corrected bug in navigator when try to attach buttons in grid as subgrid
  
• corrected mouseover bug when using grid as subgrid
  
• corrected bug when shrinkToFit parameter is set to false and the grid is resized
  
• corrected jquery.jqGrid.js loader bug
  
• corrected bug in delGridRow method when using modal for first time
  
• corrected bug in getRowData method to properly handle empty fields
  
• corrected bug in inline edit when restoring non-editable cells
  
• corrected bug that occured when starting to resize a column but the mouse is not moved
  
• corrected bug in subgrid when the data in a cell is wider than the width of the cell.
  

Additions & Changes

grid base

• added afterInsertRow(rowid, rowdata) event - fires after every inserted row. Rowid is the id of inserted row. Rowdata is array of the inserted values. The array is of type name:value, where the name is the name from colModel.
  
• added setLabel(colname,newlabel, sattr) method set a new label to the header. We can set attributes and classes (sattr). If sattr is a string, we add a class using the using the jQuery addClass. If sattr is array we set css properties via jQuery css
  
• added gridComplete event - fires after all the data is loaded into the grid and all other processes are complete
  
• added onSelectAll(array of the selected ids) fires (if defined) when multiselect is true and you click on the header checkbox. Parameter passed to this event is an array of selected rows. If the rows are unselected, the array is empty.
  
• added clearGridData - clear the currently loaded data from grid
  
• added loadError - fires when a error in ajax request
  
• added loadBeforeSend - fires before sending the request
  
• added method setCell. This very useful method can change the content of particular cell and can set class or style properties.
  
• added property hiddengrid. If set to true the grid initially is hidden. The data is not loaded and only the caption layer is shown. When click to show grid the data is loaded and grid is shown. From this point we have a regular grid.
• added property loadui - "disable", "enable", "block"
  
• onPaging(which button) fires when a pager button is clicked and before populating the data; accepts which button is clicked: first, last, prev, next
  
• resetSelection method now resets the header checkbox, if mutiselect is true
  
• hidden fields are no longer included in the calculation of the grid width
  
• the grid should be set only with table element and class. The cellSpacing, cellPadding and border attributes are added automatically.
  
• hideCol and showCol can accept an array of data as parameter. Example: hideCol(["name1","name2"]) will hide the name1 and name2 columns. Also the method can accept a single string as parameter - i.e. hideCol("name1").The same applies to the showCol method
  
• the appropriate sort image now appears in the column heading when the grid is initially loaded and the sortname is set.
  

formedit

• added method navButtonAdd - add a custom button to pager
  
• added method GridToForm
  
• added method FormToGrid
  
• added property editrules: {edithidden:true, required:true(false), number:true(false), minValue:val, maxValue:val}
  
• editGridRow can now accept default values in input text field, when action is add
  
• searchGrid now searches not by name but by the index name, if any
  

inlineedit

• added onerrorfunc as the 6th parameter in saveRow to handle errors returned from the server; also can be passed from editRow (where it is the new 8th parameter) when using the [Enter] key to trigger the save.
  

Miscellaneous

• improved performance in json and xml data reading when using zebra-striping
  
• improved performance (by 50%) in addRowData and setRowData methods
  
• improved performance of reading data when browser is IE or Mozilla (related to corrected misaligment bug)
  
• formedit (modal windows) are now compatible with jQuery 1.2.6
  
• formedit is now compatible with other JS libraries, like Prototype