News in versions: FastGrid 1.0, TreeGrid 17.0
FastGrid FastSheet ExamplesSamples DocumentationDoc Download Licensing Prices Buy Development
services
References References Contacts
TreeGrid Gantt chart SpreadSheet ExamplesSamples DocumentationDoc Download Licensing Prices Buy Contacts
FastGrid documentation
Search in documentation
FastGrid versions compatibility

Changes log (txt file) Compare FastGrid 1.0 & TreeGrid 17.1

Using in JavaScript frameworks

Angular Ember Express React Svelte Vue Other frameworks NodeJS server SalesForce LWC

Data and creating FastGrid

Simple examples of creating FastGrid Create FastGrid Display grid Access grid by API Sheets, more grids switched in one place Layout and configuration Data rows, columns, toolbars, images Changes in data rows, columns, toolbars Saving changes to server Mark changes Loading children on expand parent Short format

Layout - grid parts

Parts - ColParts and RowParts Part size Part scroll position Sets Column sets Row sets

Toolbars

Toolbar Cells Icon Height Width Toolbar position Dragging and manipulating cells Special toolbars

Rows and columns
Default rows, columns, cells, toolbars
Row and column identity

Row / column id Row / column index Row / column name

Row and column manipulation

API to get grid objects Auto added columns & rows on scroll Blocks of rows / columns Adding / copying / moving Deleting Showing and hiding Layout menu Selecting rows and columns Fill cell values by dragging Locking grid against changes Undo & redo

Row and column tree

Row and column tree Row tree Column tree Expand & collapse

Cells
Cell values and attributes

Read and write any values by API Cell value Cell attributes Cell value & attributes in UTF8 Store

Editing cells

Editing During editing Validation and errors

Cell images

Row cell side icons Icons definition Mark icons and charts Mark icons list Row cell floating images

Cell size

Row height Column width Resizing rows and columns Padding Margin Cell span

Cell style

Grid style and look Cell style permissions Cell style Cell outer border Cell inner border Alternate row & column background

Other cell features

Cell hyperlink Cell tooltip Static cells Other cell attributes Row & column attributes to speed up

Cell types and formats
Cell type and format Range - more values / ranges in cell String type Html type Auto type
Bool type

Bool type Check side icon Bool type & Check side icon

Number type

Format Localization

Date type

Format Localization Calendar

Calculations - formulas
JavaScript formulas

JavaScript formulas Aggregate functions String aggregate functions Other functions

Editable formulas

Formula rules Formula attributes Defined names for editable formulas Conditional functions Lookup functions Cell reference functions Logical functions Informational functions Mathematical functions Trigonometry functions Rounding numbers Number conversions String functions Date functions Summary functions

Dialogs and menus

Dialog Dialog Place Dialog API Menu definition in Script Cell menu List Suggest

Features
Sorting rows / columns

Sorting Sorting settings Comparing strings

Grouping rows / columns

Grouping Grouping settings Comparing strings Pivot grid

Filtering rows and columns

Filtering Filter settings Comparing strings

Search in cells Import files to grid
Export files

Export files Export and copy to clipboard CSV data

Copy & paste via system clipboard

Copy & paste Copy to clipboard Paste from clipboard

Printing

Print Print to PDF

Global grid settings
Grid size & scroll

Grid size Grid scrollbars Paging and view Media rules - responsive design

Saving settings in storage or cookies
Focus and hover cells

Focus cell and cell ranges Mouse hover cells Highlight cells, rows and columns

Events

Mouse events Key events API events

Language

Translation Languages

Messages

Message Message style

Other API

API for iterating rows and columns Paint and repaint Various API methods

Debug & files

Debugging FastGrid files

UTF8 Store - fast & short data
Introduction - License & download

Basic description Main advantages Basic usage License Download Documentation

Script language implementations

JavaScript C# JAVA PHP

Suggested ucodes

Bits - small integers or enums Integers or enums with strings Date and time Floating point numbers Special strings

Basic ucodes

Integer 1 char String 1 char Date 1 char Bits 1 char Integer 2 chars String 2 chars Date 2 chars Float 2 chars Integer 3 chars String 3 chars Date 3 chars Integer and double float 5 chars String 5 chars Date 5 chars Fixed length string Separated strings Adjacent strings Prefix for escaping string Fixed length data Unused custom codes Prefix for stored separator or length Prefix for stored base number Unused basic ucodes

Complex ucodes

chars signed decimals multiple limits varstrings escape base chars2 signed2 decimals2 multiple2 limits2

Internal coding Profiling times for ucode options Function reference

Checkbox - Bool type and Check side icon

FastGrid documentation

Bool type

Bool is boolean type contains usually two values 0 (off) and 1 (on), optionally with the third state -1 (unknown).
It can also show numbers up to 999 and cycle some of them on click.
It is shown as checkbox or radio button.
It supports radio groups - only one radio inside group can be checked.
Cell, Tool string

Type

["Auto"] Type = "Bool" GetAttr SetAttr
Bool type can be set by Type = "Bool".
Auto type never sets Bool type, but it can show the TRUE and FALSE textual constants, if set AutoBool.
Cell, Tool any

V / Value

GetValue / GetAttr SetAttr
The permitted values for Bool type are: 1 (or any positive) - on, 0 (or false/NaN/null/"") - off, -1 (or any negative) unknown state.
Cell, Tool string

BoolIcon

["Check"] GetAttr SetAttr
The icon shown, it can be "Check" for squared checkbox and "Radio" for round radio button. If set to "", it hides the Bool icon.
Cell, Tool string

Text

GetAttr SetAttr
Text displayed next to the check box, according to the Align.
Remember, the Text can be calculated by Formula in DefCells according to the actual value.

Check side icon

Side icon "Check" is shown in cell side icons as check box.
Side icon "Check can be added to cell LeftIcons, RightIcon and TextIcons, like LeftIcons: "Check"
The boolean value for the icon state is read from and written to column set by CheckCol.
The boolean value has usually one of two values 0 (off) and 1 (on), optionally with the third state -1 (unknown).
It can also show numbers up to 999 and cycle some of them on click.
Cell, Tool string

CheckCol

GetAttr SetAttr
Column id where the Check icon reads and writes its value. It is usually hidden column.
If not set, the Check icons shows / changes the value of its own cell.
The BoolMin, BoolMax, BoolCycle, BoolTree and NoEdit attributes for the Check icon are read also from the column CheckCol.
Cell, Tool string

CheckIcon

["Check"] GetAttr SetAttr
The icon shown, it can be "Check" for squared checkbox and "Radio" for round radio button.

Attributes for Bool type and Check side icon

For Check side icon these attribute are set in the column set by CheckCol, not in the cell where the Check icon is shown!
Cell, Tool int

BoolMin

[-1] GetAttr SetAttr
Minimal value permitted for the check box. The permitted range is: -1000 <= BoolMin < BoolMax <= 1000.
If the cell value is less or equal BoolMin, the [?] is shown.
If the cell value is between BoolMin and BoolMax and is not zero, the number is displayed in the check box.
Cell, Tool int

BoolMax

[1] GetAttr SetAttr
Maximal value permitted for the check box. The permitted range is: -1000 <= BoolMin < BoolMax <= 1000.
If the cell value is greater or equal BoolMax, the [x] is shown.
If the cell value is between BoolMin and BoolMax and is not zero, the number is displayed in the check box.
Cell, Tool any

BoolCycle

[0] GetAttr SetAttr
How the Bool type or CheckCol cell changes its value on check box click, if cycles two, three or more values and how.
It chooses value among BoolMin (Min), 0 (Zero), BoolMax (Max).

-1 - sets only Max (for RadioRow / RadioCol)
0 - switches between Zero / Max. For others sets Max.
1 - switches between Zero / Max. For others sets Zero.
2 - cycles Min / Zero / Max / Min / Zero / Max. Ignores Zero if it is not between Min and Max.
3 - cycles Max / Zero / Min / Max / Zero / Min. Ignores Zero if it is not between Min and Max.
4 - cycles from Zero to Max.
5 - cycles from Max to Zero.
6 - cycles from Min to Zero to Max. From Max switches to Min and repeats cycle.
7 - cycles from Max to Zero to Min. From Min switches to Max and repeats cycle.
8 - cycles from Zero to Max-1.
9 - cycles from Max-1 to Zero.
10 - cycles from Min+1 to Zero to Max+1. From Max-1 switches to Min+1 and repeats cycle.
11 - cycles from Max-1 to Zero to Min-1. From Min+1 switches to Max-1 and repeats cycle.
array - cycles among the values in the array. For last or unknown item chooses the first item.
Cell, Tool int

BoolTree

[0] GetAttr SetAttr
If set, it sets the same value (0 / 1) to all its children with BoolTree set and resets BoolCycle to 1.
0 - no, 1 - row parents and children in the same column, 2 - column parents and children in the same row.

To calculate parent rows check boxes according to their children, use sumbool or countbool function in cell F / Formula.
For example { id:"Col1", BoolTree:1, Formula:"sumbool(null,null,null,64)" }.
Optionally set BoolMin = -1000 to show sum of children in red if some child is zero.
Optionally set BoolMax = 1000 to show sum of children in blue if all the children are positive.
Cell int

FilterOff

[0] GetAttr SetAttr
For Bool type it slightly differs from standard FilterOff attribute.
After which Bool value in BoolCycle follows FilterOff value.
Cell, Tool any

RadioRow

GetAttr SetAttr
Only one check box with the same RadioRow can be on in its row.
To restrict unchecking all check boxes in row set BoolCycle = -1.
Cell any

RadioCol

GetAttr SetAttr
Only one check box with the same RadioCol can be on in its column.
To restrict unchecking all check boxes in row set BoolCycle = -1.
Cfg object

BoolTexts

[{ "-1":"?", 0:"\u2715", 1:"\u2713" }] GetCfgAttr SetCfgAttr
Strings exported instead of Bool values.
Cfg object

BoolTextsIn

[{ "?":-1, "\u2715":0, "false":0, "":0, "-1":-1, "null":0, 0:0, "\u2713":1, "true":1, 1:1 }] GetCfgAttr SetCfgAttr
Strings converted to Bool values for import.
Grid method bool

SetBool

(Row row, Col col, int value = null, int changes = 0)
Sets the Bool type or CheckCol cell value to value.
changes specify how to change will be marked, see SetValue.
Unlike SetValue it does not differ between zero values (0 == false == "" == NaN and 1 == true).
It updates also other boolean cells according to BoolTree, RadioRow, RadioCol.
Returns true if the value was changed, false if the value is the same as the cell value (no change was done) and null for error.
Grid method bool

ChangeBool

(Row row, Col col, int cycle = null, int changes = 0)
Changes the Bool type or CheckCol cell value according to the cycle or BoolCycle.
changes specify how to change will be marked, see SetValue.
Returns true if the value was changed, false if the value is the same as the cell value (no change was done) and null for error.
Actions

ChangeBool

(int target = 0, string icon = null, int cycle = null) OnClickBool, OnClickCheck
Changes the Bool type or CheckCol cell value according to the cycle or BoolCycle.
The icon is "Check" if the cell has set CheckCol otherwise it is "Bool".
The icon can be set to the specific icon name (in LeftIcons / RightIcons / TextIcons), if the cell has set more check box icons.