First of all, please don't take this as a complaint about the documentation. The work I'm currently doing has required me to go through the Options documentation for igGrid (as well as some of the features) and igCombo.
I came across a number of errors and inconsistencies which are enumerated below. If I'm incorrect about any of these, please reply and let me know as it directly effects the work I'm currently doing. For now I'm going with the assumption that my corrections are correct.
igGrid - Options
adjustVirtualHeights - Type: enumeration, should be bool
caption - Default: null, should be ""
columns -> dataType - Marked as enumeration, but allowed values aren't listed.
defaultColumnWidth - Default: null (null isn't specified as one of the enumerated types)
primaryKey - Defualt: null, should be ""
virtualizationMouseWheelStep - Default: null inconsistent with Type: number
igGridFiltering - Options
advancedModeEditorsVisible - Type: enumeration, should be bool
caseSensitive - Type: enumeration, should be bool
filterSummaryAlwaysVisible - Type: enumeration, should be bool
labels - All the items under labels are marked with a type of object, but should be string
mode - Default: null (null isn't specified as one of the enumerated types)
nulls - Same issue as labels
renderFC - Type: enumeration, should be bool
renderFilterButton - Type: enumeration, should be bool
showEmptyConditions - Type: enumeration, should be bool
showNullConditions - Type: enumeration, should be bool
type - Default: null (null isn't specified as one of the enumerated types)
igGridPaging - Options
defaultDropDownWidth - Type: number - Probably not a documentation issue, but inconsistent with widths specified elsewhere which are enumerations with string and number
pageSizeList - Elements Type: object, should be number
pageSizeUrl - Default: null, should be ""
recordCountKey - Default: null, should be ""
igGridSorting - Options
applySortedColumnCss - Type: enumeration, should be bool
columnSettings - Every columnSetting (except allowSorting) is listed with a default of null, and none are objects or enumerations with null listed as a valid value.
modalDialogGHeight - Type: number Default: ""
sortUrlKey, sortUrlKeyAscValue, sortUrlKeyDescValue - Type: string, but all have a default of null
Hello Pete,
Thank you very much for this post. I have reported this to our development team, so they can verify and fix the documentation.
If you have any questions or feedback, please feel free to post here.
I only ask that you guys get back to me about any mistakes as the quality of the work I'm doing depends on my correct understanding of the API.
Thank you for your update.
There is a development issue created regarding this (ID 139420)
The majority of the issues will be fixed.
The issues that won't be fixed are "null as default value".
The API documentation is extracted from the source files and the options has null as default value for purpose.
There are checks if the value is null, so the development logic requires it.
Another option that won't be fixed is the defaultDropDownWidth in the igGridPaging.
This option is coming from igEditor's width which is number.
Let me know if you have some comments regarding this.