Skip to content

Latest commit

 

History

History
95 lines (78 loc) · 12.8 KB

README4.14.1.md

File metadata and controls

95 lines (78 loc) · 12.8 KB

free fork of jqGrid

npm versiondownloadstotal CDNJS jsDelivr CDN Bower NuGet Maven Central
GitHub commits GitHub watchersGitHub forksGitHub stars devDependency status GitHub license

jqGrid is a popular jQuery Plugin for displaying and editing data in tabular form. It has some other more sophisticated features, like subgrids, TreeGrids, grouping and so on.

jqGrid was developed originally by Tony Tomov and it was available under MIT/GPL-licenses till the version 4.7.0 published Dec 8, 2014 (see here). Short time after that the license agreement was changed (see here) and new 4.7.1 version was published.

The code from the GitHib repository is the fork of jqGrid 4.7.0 - the latest version available under MIT/GPL-licenses. It will be provided under MIT/GPL-licenses.

Below you can find short description of new features and the bug fixes implemented in free jqGrid 4.14.1 (compared with version 4.14.0). The version is developed by Oleg Kiriljuk, alias Oleg on the stackoverflow and OlegK on trirand forum.

Read Wiki for more detailed information about the features of free-jqGrid. The preliminary version of the documentation can be found here.

Free jqGrid can be used for free. We still ask to contribute the development by donating via PayPal, if one have the possibility for it. One can donate by clicking on the following button PayPayl donate button or by sending money via PayPal to [email protected] with the comment "free jqGrid". Bank transfer based on the invoice from OK soft GmbH is another option of donating. Just send the email with the information about the amount of donation and you will get the corresponding invoice with the full information about our bank account and our VAT number.

One can install the package with respect of npm by using "npm install free-jqgrid", with respect of bower by using "bower install free-jqgrid" or from NuGet by using "Install-Package free-jqGrid".

The package is published on WebJars too and it's deployed to Maven Central.

Free jqGrid is is available from jsDelivr CDN and cdnjs. Thus one can use it directly from Internet by including for example the URLs like

<link rel="stylesheet" href="https://cdn.jsdelivr.net/free-jqgrid/4.14.1/css/ui.jqgrid.min.css">
<script src="https://cdn.jsdelivr.net/free-jqgrid/4.14.1/js/jquery.jqgrid.min.js"></script>

or

<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/free-jqgrid/4.14.1/css/ui.jqgrid.min.css">
<script src="https://cdnjs.cloudflare.com/ajax/libs/free-jqgrid/4.14.1/jquery.jqgrid.min.js"></script>

The locale file is optional. One can, but one don't need to include grid.locale-en.min.js, because the same information is already included in the jquery.jqgrid.min.js (or jquery.jqgrid.src.js).

If somebody want to test the latest version of free jqGrid, one can load it directly from GitHib using RawGit service:

<link rel="stylesheet" href="https://rawgit.com/free-jqgrid/jqGrid/master/css/ui.jqgrid.css">
<script src="https://rawgit.com/free-jqgrid/jqGrid/master/js/jquery.jqgrid.src.js"></script>

All other language files and plugins are available from CDN too. See the wiki article for more details about the usage of free jqGrid from CDNs and RawGit.

Remark: the above URLs will be available after publishing the release of the version of 4.14.1.

New main features implemented in the version 4.14.1 compared with 4.14.0:

  • Add support of generateDatalist:true in searchoptions and new method generateDatalistFromColumnIndex. The option generateDatalist: true can be added to searchoptions of the column, which has createColumnIndex: true. It generates <datalist> with unique values of the column. As the result, one gets the feature close to Autocomplete using only built-in functionality of HTML5. The demo https://jsfiddle.net/OlegKi/su7ebs65/ shows the usage of the feature. The demo is close to the demo https://jsfiddle.net/OlegKi/yvbt6w54/ from the README to the version 4.14.0, but it uses no jQuery UI Autocomplete.
  • Performance improvement in $.jgrid.isCellClassHidden method. See the issue for more details.
  • Allow to use callback functions as the value of Boolean properties of editrules.
  • Initialize this and add the options for jsonmap/xmlmap defined as functions. Add second options parameter with two properties: cmName and iItem.
  • Add filters property of prmNames and searching.sFilter allows to change the name of postData properties used for filtering.
  • Add Event parameter to onSortCol callback and jqGridSortCol event. See the issue for more details.

Below one can see the full list of changes in the version 4.14.1 compared with 4.14.0:

  • Bug fix in sortData in case of usage reload parameter set to true. The method sortData be used for example inside of the method sortGrid.
  • Allow to use callback functions as the value of Boolean properties of editrules.
  • Add Event parameter to onSortCol callback and jqGridSortCol event. See the issue for more details.
  • Add support of generateDatalist:true in searchoptions and new method generateDatalistFromColumnIndex. The option generateDatalist: true can be added to searchoptions of the column, which has createColumnIndex: true. It generates <datalist> with unique values of the column. As the result, one gets the feature close to Autocomplete using only built-in functionality of HTML5.
  • Performance improvement in $.jgrid.isCellClassHidden method. See the issue for more details.
  • Bug fix in the name of the subgrid open icon in jQuery UI iconSet. The typing error in the class name is fixed.
  • Fill savedRow after beforeEditCell. See the issue for more details.
  • Initialize data property of events called by dataEvents.
  • Small bug fixes in the usage of of additionalProperties and iPropByName.
  • Fix processing of IN operation and multiselect in Searching Dialog. See the answer for more details.
  • Add filters property of prmNames and searching.sFilter allows to change the name of postData properties used for filtering.
  • Extension of filterToolbar: add name, cm and id properties of options parameter of dataInit.
  • Add options as the second parameter of editoptions.defaultValue callback function.
  • Bug fix: prevent possible recursion in getCell and getRowData methods if editable property is a function, which calls the methods. New editingInfo parameter of jqGrid is introduced. The method $.jgrid.detectRowEditing is simplified to mostly one line of code, which uses editingInfo. See the issue for more details.
  • Bug fix in addRowData in case of data grouping is enabled. See the issue for more details.
  • Bug fix the bug in parseDate in processing of negative time offsets relative to UTC (processing the ISO date with Z formatter).
  • Bug fix of deleting previously created pager (pager: true). See the issue for more details.
  • Changes in Croatian locale, adding Bosnian Translation. See the issue for more details.
  • Bug fix: reset of custom filtering operation after clear (click on x button) in the filter toolbar. See the question for additional information.
  • Initialize this and add the options for jsonmap/xmlmap defined as functions. Add second options parameter with two properties: cmName and iItem.
  • Bug fix: add support of u1000 format of date as newformat of parseDate.
  • Bug fix in editGridRow (form editing): set focus only on the first focusable element.

Other old readmes contain the list of the features and bug fixed implemented in previous versions of free jqGrid:

Many thanks to all, who sent bug reports and suggestions to improve free jqGrid!