Skip to content

Extras

DataGrid

Bit.BlazorUI.ExtrasDataTableTreeGridTreeList

BitDataGrid displays an information-rich data table and gives people the tools to work through it: sorting, quick search and per-column filters, paging, grouping with aggregates, selection, inline editing, resizable/reorderable/frozen columns, master-detail and tree rows, keyboard cell navigation, row and column virtualization, and CSV/Excel export. Bind a list, an IQueryable executed at the source, or a callback for server-side paging or infinite scrolling. Use a data grid when information density is critical.

Notes

To use this component, you need to install the Bit.BlazorUI.Extras(opens in a new tab) NuGet package, as described in the Optional steps of the Getting started page.

Usage

Every example is live. Open its code to see exactly what produced the component running underneath.

Basic & sorting

Bind Items and declare the columns; Property binds a column with a typed selector. A header click sorts ascending, descending, then unsorted (AllowUnsorted="false" drops the last step), and Ctrl/⌘ or Shift+click adds a column to the sort. AriaLabel names the grid for screen readers - or AriaLabelledBy, pointing at a visible heading.

1
Vintage Gadget 212
Home
$171.75
131
3.9
2
Eco Notebook 554
Clothing
$382.16
130
3.1
3
Classic Gadget 181
Toys
$813.02
269
1.2
4
Vintage Blender 267
Electronics
$310.12
291
4.3
5
Vintage Jacket 234
Electronics
$55.50
390
3.5
6
Smart Drone 229
Electronics
$603.51
257
1.2
7
Eco Widget 428
Books
$72.97
359
1.3
8
Pro Blender 549
Electronics
$825.55
6
1.0
9
Deluxe Mug 514
Clothing
$615.44
22
2.5
10
Mini Jacket 367
Grocery
$585.87
367
1.1
11
Vintage Gadget 192
Home
$334.92
388
1.6
12
Mini Mug 788
Toys
$712.80
144
3.2
13
Classic Mug 124
Books
$267.79
19
1.9
14
Compact Gadget 195
Clothing
$325.60
375
4.3
15
Deluxe Speaker 932
Sports
$281.65
272
3.5
16
Eco Widget 307
Grocery
$982.55
390
1.5
17
Mini Blender 740
Electronics
$597.20
195
4.5
18
Pro Blender 952
Sports
$132.04
53
1.0
19
Classic Drone 459
Electronics
$906.58
481
4.6
20
Mega Mug 839
Sports
$282.70
169
3.1
21
Mega Speaker 349
Books
$830.28
320
1.3
22
Modern Mug 947
Home
$886.86
484
1.6
23
Mini Backpack 199
Sports
$349.39
260
3.9
24
Mini Speaker 940
Electronics
$60.13
107
2.3
25
Deluxe Lamp 430
Home
$760.77
331
5.0
26
Eco Mug 633
Toys
$388.23
478
1.3
27
Compact Camera 900
Electronics
$300.37
290
1.1
28
Mega Mug 366
Grocery
$749.69
15
2.4
29
Mini Jacket 409
Books
$604.08
321
3.4
30
Premium Camera 361
Grocery
$352.80
0
3.3
31
Mega Gadget 949
Books
$654.24
99
3.6
32
Mega Lamp 485
Books
$787.62
277
3.2
33
Compact Backpack 302
Clothing
$540.00
406
3.8
34
Pro Mug 551
Grocery
$45.94
206
2.7
35
Ultra Mug 514
Clothing
$484.40
357
2.7
36
Pro Camera 944
Home
$211.34
473
4.5
37
Mini Notebook 156
Electronics
$900.67
312
4.7
38
Premium Jacket 198
Electronics
$651.34
10
1.9
39
Classic Drone 215
Sports
$290.56
272
1.2
40
Mini Sneaker 570
Sports
$897.23
338
4.6
41
Modern Camera 946
Sports
$661.07
44
4.2
42
Vintage Mug 824
Sports
$444.42
453
1.8
43
Mini Mug 925
Electronics
$843.33
173
4.4
44
Premium Camera 560
Grocery
$35.33
277
3.6
45
Vintage Gadget 237
Home
$383.48
282
4.9
46
Pro Drone 577
Electronics
$285.56
438
4.7
47
Eco Jacket 846
Grocery
$59.26
414
2.8
48
Smart Camera 226
Toys
$612.62
229
4.1
49
Classic Gadget 202
Electronics
$494.25
256
2.4
50
Mega Sneaker 417
Sports
$955.45
169
2.1

Filtering & paging

Filterable adds a filter row whose editor follows each column's type and filters as you type (FilterDebounce). FilterOperators adds an operator picker (including Is blank, and Is any of taking a comma-separated list), which a column can opt out of. A column's FilterTemplate replaces its editor - here a multi-select applying In. Pageable pages the rows, and ShowToolbar shows Clear filters while a filter is on. These columns bind by Field name.

1
Vintage Gadget 212
Home
Wayne Enterprises
$171.75
2023-01-19
2
Eco Notebook 554
Clothing
Soylent
$382.16
2019-07-18
3
Classic Gadget 181
Toys
Wonka Inc
$813.02
2023-03-12
4
Vintage Blender 267
Electronics
Wayne Enterprises
$310.12
2021-01-25
5
Vintage Jacket 234
Electronics
Wayne Enterprises
$55.50
2022-08-20
6
Smart Drone 229
Electronics
Stark Industries
$603.51
2020-02-18
7
Eco Widget 428
Books
Wayne Enterprises
$72.97
2023-12-08
8
Pro Blender 549
Electronics
Acme Corp
$825.55
2020-06-02
9
Deluxe Mug 514
Clothing
Wayne Enterprises
$615.44
2021-08-11
10
Mini Jacket 367
Grocery
Initech
$585.87
2018-10-04
1–10 of 200
Page 1 of 20

Quick search

ShowSearchBox searches every column at once, matching the text each cell shows; Searchable="false" leaves a column out. SearchText is two-way bindable, and SearchDebounce (300 ms) turns a burst of typing into one search.

1
Vintage Gadget 212
Home
Wayne Enterprises
$171.75
131
2
Eco Notebook 554
Clothing
Soylent
$382.16
130
3
Classic Gadget 181
Toys
Wonka Inc
$813.02
269
4
Vintage Blender 267
Electronics
Wayne Enterprises
$310.12
291
5
Vintage Jacket 234
Electronics
Wayne Enterprises
$55.50
390
6
Smart Drone 229
Electronics
Stark Industries
$603.51
257
7
Eco Widget 428
Books
Wayne Enterprises
$72.97
359
8
Pro Blender 549
Electronics
Acme Corp
$825.55
6
9
Deluxe Mug 514
Clothing
Wayne Enterprises
$615.44
22
10
Mini Jacket 367
Grocery
Initech
$585.87
367
1–10 of 200
Page 1 of 20

No search term.

Selection

SelectionMode picks a row click (Single, which makes the cells navigable so Space selects too) or checkboxes with a select-all box (Multiple); Shift+click selects a range. SelectedItems is two-way bindable and tracked by KeyField, and IsRowSelectionDisabled locks rows out - discontinued products here. RowHeader makes Name the header of its row: screen readers announce it from row to row, and it names each checkbox.

0 selected

1
Vintage Gadget 212
Home
$171.75
False
2
Eco Notebook 554
Clothing
$382.16
True
3
Classic Gadget 181
Toys
$813.02
False
4
Vintage Blender 267
Electronics
$310.12
True
5
Vintage Jacket 234
Electronics
$55.50
True
6
Smart Drone 229
Electronics
$603.51
False
7
Eco Widget 428
Books
$72.97
False
8
Pro Blender 549
Electronics
$825.55
True
9
Deluxe Mug 514
Clothing
$615.44
True
10
Mini Jacket 367
Grocery
$585.87
False
1–10 of 60
Page 1 of 6

Keyboard & clipboard

CellNavigation makes the cells a single tab stop (the APG grid pattern): the arrows, Home/End, Ctrl+Home/End and Page Up/Down move between them, Space toggles the row, Shift+Space extends the range and Ctrl+A selects every row - so the row checkboxes leave the tab order. With ClipboardCopy, Ctrl/⌘+C copies the selected rows as tab-separated text that pastes into Excel as columns.

Select rows, then copy them.

1
Vintage Gadget 212
Home
$171.75
131
2
Eco Notebook 554
Clothing
$382.16
130
3
Classic Gadget 181
Toys
$813.02
269
4
Vintage Blender 267
Electronics
$310.12
291
5
Vintage Jacket 234
Electronics
$55.50
390
6
Smart Drone 229
Electronics
$603.51
257
7
Eco Widget 428
Books
$72.97
359
8
Pro Blender 549
Electronics
$825.55
6
9
Deluxe Mug 514
Clothing
$615.44
22
10
Mini Jacket 367
Grocery
$585.87
367
11
Vintage Gadget 192
Home
$334.92
388
12
Mini Mug 788
Toys
$712.80
144
13
Classic Mug 124
Books
$267.79
19
14
Compact Gadget 195
Clothing
$325.60
375
15
Deluxe Speaker 932
Sports
$281.65
272
16
Eco Widget 307
Grocery
$982.55
390
17
Mini Blender 740
Electronics
$597.20
195
18
Pro Blender 952
Sports
$132.04
53
19
Classic Drone 459
Electronics
$906.58
481
20
Mega Mug 839
Sports
$282.70
169
21
Mega Speaker 349
Books
$830.28
320
22
Modern Mug 947
Home
$886.86
484
23
Mini Backpack 199
Sports
$349.39
260
24
Mini Speaker 940
Electronics
$60.13
107
25
Deluxe Lamp 430
Home
$760.77
331
26
Eco Mug 633
Toys
$388.23
478
27
Compact Camera 900
Electronics
$300.37
290
28
Mega Mug 366
Grocery
$749.69
15
29
Mini Jacket 409
Books
$604.08
321
30
Premium Camera 361
Grocery
$352.80
0
31
Mega Gadget 949
Books
$654.24
99
32
Mega Lamp 485
Books
$787.62
277
33
Compact Backpack 302
Clothing
$540.00
406
34
Pro Mug 551
Grocery
$45.94
206
35
Ultra Mug 514
Clothing
$484.40
357
36
Pro Camera 944
Home
$211.34
473
37
Mini Notebook 156
Electronics
$900.67
312
38
Premium Jacket 198
Electronics
$651.34
10
39
Classic Drone 215
Sports
$290.56
272
40
Mini Sneaker 570
Sports
$897.23
338

Inline editing

Editable adds a command column and NewItemFactory an Add button. Editors follow each column's type, edits are buffered until saved, and Validate blocks an invalid value (clear a name, or enter a negative price). EditMode edits the whole row (Save/Cancel) or one cell at a time: Enter, F2 or a double-click opens it, and typing into a text or number cell opens it with what you type; Enter, Tab or leaving it saves; Esc cancels; Delete removes the focused row. A row double-click here calls BeginEdit via OnRowDoubleClick.


Actions
1
Vintage Gadget 212
Home
$171.75
131
2023-01-19
False
2
Eco Notebook 554
Clothing
$382.16
130
2019-07-18
True
3
Classic Gadget 181
Toys
$813.02
269
2023-03-12
False
4
Vintage Blender 267
Electronics
$310.12
291
2021-01-25
True
5
Vintage Jacket 234
Electronics
$55.50
390
2022-08-20
True
6
Smart Drone 229
Electronics
$603.51
257
2020-02-18
False
7
Eco Widget 428
Books
$72.97
359
2023-12-08
False
8
Pro Blender 549
Electronics
$825.55
6
2020-06-02
True
9
Deluxe Mug 514
Clothing
$615.44
22
2021-08-11
True
10
Mini Jacket 367
Grocery
$585.87
367
2018-10-04
False
1–10 of 25
Page 1 of 3

Double-click a row, or use its Edit button.

Grouping & aggregates

Groupable adds a ⊞ toggle to the headers; group by Category, then Supplier, for nested groups. Each group shows its columns' Aggregate, ShowFooter shows the grand totals, and AggregateBy computes a custom one. GroupsInitiallyCollapsed opens the groups closed; ExpandAllGroupsAsync / CollapseAllGroupsAsync flip them all.


1
Vintage Gadget 212
Home
Wayne Enterprises
$171.75
131
3.9
2
Eco Notebook 554
Clothing
Soylent
$382.16
130
3.1
3
Classic Gadget 181
Toys
Wonka Inc
$813.02
269
1.2
4
Vintage Blender 267
Electronics
Wayne Enterprises
$310.12
291
4.3
5
Vintage Jacket 234
Electronics
Wayne Enterprises
$55.50
390
3.5
6
Smart Drone 229
Electronics
Stark Industries
$603.51
257
1.2
7
Eco Widget 428
Books
Wayne Enterprises
$72.97
359
1.3
8
Pro Blender 549
Electronics
Acme Corp
$825.55
6
1.0
9
Deluxe Mug 514
Clothing
Wayne Enterprises
$615.44
22
2.5
10
Mini Jacket 367
Grocery
Initech
$585.87
367
1.1
11
Vintage Gadget 192
Home
Soylent
$334.92
388
1.6
12
Mini Mug 788
Toys
Acme Corp
$712.80
144
3.2
13
Classic Mug 124
Books
Acme Corp
$267.79
19
1.9
14
Compact Gadget 195
Clothing
Wayne Enterprises
$325.60
375
4.3
15
Deluxe Speaker 932
Sports
Initech
$281.65
272
3.5
16
Eco Widget 307
Grocery
Initech
$982.55
390
1.5
17
Mini Blender 740
Electronics
Wonka Inc
$597.20
195
4.5
18
Pro Blender 952
Sports
Stark Industries
$132.04
53
1.0
19
Classic Drone 459
Electronics
Soylent
$906.58
481
4.6
20
Mega Mug 839
Sports
Wonka Inc
$282.70
169
3.1
21
Mega Speaker 349
Books
Wonka Inc
$830.28
320
1.3
22
Modern Mug 947
Home
Stark Industries
$886.86
484
1.6
23
Mini Backpack 199
Sports
Wayne Enterprises
$349.39
260
3.9
24
Mini Speaker 940
Electronics
Initech
$60.13
107
2.3
25
Deluxe Lamp 430
Home
Initech
$760.77
331
5.0
26
Eco Mug 633
Toys
Initech
$388.23
478
1.3
27
Compact Camera 900
Electronics
Stark Industries
$300.37
290
1.1
28
Mega Mug 366
Grocery
Stark Industries
$749.69
15
2.4
29
Mini Jacket 409
Books
Acme Corp
$604.08
321
3.4
30
Premium Camera 361
Grocery
Globex
$352.80
0
3.3
31
Mega Gadget 949
Books
Initech
$654.24
99
3.6
32
Mega Lamp 485
Books
Stark Industries
$787.62
277
3.2
33
Compact Backpack 302
Clothing
Wayne Enterprises
$540.00
406
3.8
34
Pro Mug 551
Grocery
Umbrella
$45.94
206
2.7
35
Ultra Mug 514
Clothing
Wayne Enterprises
$484.40
357
2.7
36
Pro Camera 944
Home
Wayne Enterprises
$211.34
473
4.5
37
Mini Notebook 156
Electronics
Umbrella
$900.67
312
4.7
38
Premium Jacket 198
Electronics
Wayne Enterprises
$651.34
10
1.9
39
Classic Drone 215
Sports
Acme Corp
$290.56
272
1.2
40
Mini Sneaker 570
Sports
Wayne Enterprises
$897.23
338
4.6
41
Modern Camera 946
Sports
Globex
$661.07
44
4.2
42
Vintage Mug 824
Sports
Initech
$444.42
453
1.8
43
Mini Mug 925
Electronics
Wonka Inc
$843.33
173
4.4
44
Premium Camera 560
Grocery
Globex
$35.33
277
3.6
45
Vintage Gadget 237
Home
Wonka Inc
$383.48
282
4.9
46
Pro Drone 577
Electronics
Initech
$285.56
438
4.7
47
Eco Jacket 846
Grocery
Wonka Inc
$59.26
414
2.8
48
Smart Camera 226
Toys
Initech
$612.62
229
4.1
49
Classic Gadget 202
Electronics
Globex
$494.25
256
2.4
50
Mega Sneaker 417
Sports
Soylent
$955.45
169
2.1
51
Premium Gadget 932
Clothing
Wayne Enterprises
$741.93
301
2.9
52
Premium Lamp 283
Toys
Soylent
$943.60
49
2.2
53
Pro Mug 237
Toys
Initech
$264.98
237
3.1
54
Eco Lamp 139
Electronics
Wonka Inc
$175.86
112
1.9
55
Ultra Lamp 134
Grocery
Wayne Enterprises
$47.06
77
3.3
56
Ultra Blender 911
Grocery
Initech
$80.83
62
5.0
57
Ultra Gadget 323
Books
Stark Industries
$647.39
313
2.7
58
Deluxe Blender 420
Home
Acme Corp
$506.54
17
4.8
59
Deluxe Camera 513
Sports
Acme Corp
$234.18
305
3.3
60
Eco Mug 642
Electronics
Umbrella
$809.15
442
1.8
61
Vintage Lamp 246
Books
Acme Corp
$971.43
238
1.8
62
Eco Backpack 738
Electronics
Acme Corp
$366.59
112
3.8
63
Ultra Notebook 129
Home
Soylent
$488.57
483
4.9
64
Deluxe Widget 171
Books
Wayne Enterprises
$384.18
206
3.8
65
Classic Gadget 833
Electronics
Soylent
$866.59
268
1.8
66
Eco Backpack 963
Books
Acme Corp
$371.05
236
2.8
67
Mini Mug 765
Sports
Wonka Inc
$200.57
57
3.5
68
Mini Jacket 661
Books
Wonka Inc
$632.20
439
2.7
69
Modern Jacket 576
Electronics
Wonka Inc
$429.20
49
1.4
70
Compact Mug 696
Sports
Wayne Enterprises
$244.82
228
2.7
71
Compact Backpack 959
Sports
Umbrella
$57.23
410
1.5
72
Ultra Lamp 199
Toys
Acme Corp
$249.92
68
2.7
73
Ultra Backpack 762
Sports
Globex
$991.34
272
3.8
74
Pro Jacket 295
Sports
Soylent
$37.91
45
2.7
75
Compact Notebook 426
Clothing
Acme Corp
$869.12
262
4.5
76
Ultra Sneaker 789
Toys
Soylent
$743.04
101
4.7
77
Premium Notebook 878
Clothing
Globex
$39.85
338
1.9
78
Vintage Drone 655
Toys
Umbrella
$121.29
349
2.4
79
Mega Backpack 316
Sports
Wayne Enterprises
$138.33
341
3.4
80
Premium Speaker 971
Home
Globex
$496.89
335
2.8

Templates

Template, HeaderTemplate and FooterTemplate render any markup. A template-only column sorts by its SortBy key, and Comparer replaces the ordering itself - Stock sorts in-stock rows first.

Vintage Gadget 212
Home
★★★★★
$171.75
131 in stock
$22,499
Eco Notebook 554
Clothing
★★★★★
$382.16
130 in stock
$49,681
Classic Gadget 181
Toys
★★★★★
$813.02
269 in stock
$218,702
Vintage Blender 267
Electronics
★★★★★
$310.12
291 in stock
$90,245
Vintage Jacket 234
Electronics
★★★★★
$55.50
390 in stock
$21,645
Smart Drone 229
Electronics
★★★★★
$603.51
257 in stock
$155,102
Eco Widget 428
Books
★★★★★
$72.97
359 in stock
$26,196
Pro Blender 549
Electronics
★★★★★
$825.55
6 in stock
$4,953
Deluxe Mug 514
Clothing
★★★★★
$615.44
22 in stock
$13,540
Mini Jacket 367
Grocery
★★★★★
$585.87
367 in stock
$215,014
Vintage Gadget 192
Home
★★★★★
$334.92
388 in stock
$129,949
Mini Mug 788
Toys
★★★★★
$712.80
144 in stock
$102,643
Classic Mug 124
Books
★★★★★
$267.79
19 in stock
$5,088
Compact Gadget 195
Clothing
★★★★★
$325.60
375 in stock
$122,100
Deluxe Speaker 932
Sports
★★★★★
$281.65
272 in stock
$76,609
Eco Widget 307
Grocery
★★★★★
$982.55
390 in stock
$383,195
Mini Blender 740
Electronics
★★★★★
$597.20
195 in stock
$116,454
Pro Blender 952
Sports
★★★★★
$132.04
53 in stock
$6,998
Classic Drone 459
Electronics
★★★★★
$906.58
481 in stock
$436,065
Mega Mug 839
Sports
★★★★★
$282.70
169 in stock
$47,776
Mega Speaker 349
Books
★★★★★
$830.28
320 in stock
$265,690
Modern Mug 947
Home
★★★★★
$886.86
484 in stock
$429,240
Mini Backpack 199
Sports
★★★★★
$349.39
260 in stock
$90,841
Mini Speaker 940
Electronics
★★★★★
$60.13
107 in stock
$6,434
Deluxe Lamp 430
Home
★★★★★
$760.77
331 in stock
$251,815
Eco Mug 633
Toys
★★★★★
$388.23
478 in stock
$185,574
Compact Camera 900
Electronics
★★★★★
$300.37
290 in stock
$87,107
Mega Mug 366
Grocery
★★★★★
$749.69
15 in stock
$11,245
Mini Jacket 409
Books
★★★★★
$604.08
321 in stock
$193,910
Premium Camera 361
Grocery
★★★★★
$352.80
Out of stock
$0

Detail rows

DetailTemplate renders anything under a row - here a nested grid. A row opens from its ▸ toggle, from a click on the row (ExpandDetailOnRowClick) or from code; ShowDetailToggle="false" hides the toggle column, ExpandedDetailItems is bindable and OnDetailToggle reports each change.

Click a row, or its ▸ toggle, to open it.

Details

Column layout

Resizable: drag a header's edge, double-click it to fit the content, or focus it and use the arrow keys (Home/End go to MinWidth/MaxWidth, Enter fits). Reorderable: drag a header, press Ctrl+←/→ on it, or use the arrows in the ShowColumnChooser panel, which also hides columns. Dragging works with touch and pen too. Frozen and FrozenEnd pin columns to an edge, and Group banners adjacent columns under one header.

Identity
Commercials
1
Vintage Gadget 212
Home
Wayne Enterprises
$171.75
131
2023-01-19
3.9
2
Eco Notebook 554
Clothing
Soylent
$382.16
130
2019-07-18
3.1
3
Classic Gadget 181
Toys
Wonka Inc
$813.02
269
2023-03-12
1.2
4
Vintage Blender 267
Electronics
Wayne Enterprises
$310.12
291
2021-01-25
4.3
5
Vintage Jacket 234
Electronics
Wayne Enterprises
$55.50
390
2022-08-20
3.5
6
Smart Drone 229
Electronics
Stark Industries
$603.51
257
2020-02-18
1.2
7
Eco Widget 428
Books
Wayne Enterprises
$72.97
359
2023-12-08
1.3
8
Pro Blender 549
Electronics
Acme Corp
$825.55
6
2020-06-02
1.0
9
Deluxe Mug 514
Clothing
Wayne Enterprises
$615.44
22
2021-08-11
2.5
10
Mini Jacket 367
Grocery
Initech
$585.87
367
2018-10-04
1.1
11
Vintage Gadget 192
Home
Soylent
$334.92
388
2022-10-27
1.6
12
Mini Mug 788
Toys
Acme Corp
$712.80
144
2020-06-09
3.2
13
Classic Mug 124
Books
Acme Corp
$267.79
19
2021-09-09
1.9
14
Compact Gadget 195
Clothing
Wayne Enterprises
$325.60
375
2023-10-09
4.3
15
Deluxe Speaker 932
Sports
Initech
$281.65
272
2022-12-13
3.5
16
Eco Widget 307
Grocery
Initech
$982.55
390
2022-12-24
1.5
17
Mini Blender 740
Electronics
Wonka Inc
$597.20
195
2022-02-04
4.5
18
Pro Blender 952
Sports
Stark Industries
$132.04
53
2018-11-08
1.0
19
Classic Drone 459
Electronics
Soylent
$906.58
481
2022-03-05
4.6
20
Mega Mug 839
Sports
Wonka Inc
$282.70
169
2022-08-25
3.1
21
Mega Speaker 349
Books
Wonka Inc
$830.28
320
2019-08-05
1.3
22
Modern Mug 947
Home
Stark Industries
$886.86
484
2022-11-05
1.6
23
Mini Backpack 199
Sports
Wayne Enterprises
$349.39
260
2021-02-06
3.9
24
Mini Speaker 940
Electronics
Initech
$60.13
107
2022-05-29
2.3
25
Deluxe Lamp 430
Home
Initech
$760.77
331
2019-04-24
5.0
26
Eco Mug 633
Toys
Initech
$388.23
478
2019-03-07
1.3
27
Compact Camera 900
Electronics
Stark Industries
$300.37
290
2021-10-02
1.1
28
Mega Mug 366
Grocery
Stark Industries
$749.69
15
2023-10-08
2.4
29
Mini Jacket 409
Books
Acme Corp
$604.08
321
2020-05-11
3.4
30
Premium Camera 361
Grocery
Globex
$352.80
0
2023-02-25
3.3
31
Mega Gadget 949
Books
Initech
$654.24
99
2019-04-16
3.6
32
Mega Lamp 485
Books
Stark Industries
$787.62
277
2021-10-01
3.2
33
Compact Backpack 302
Clothing
Wayne Enterprises
$540.00
406
2020-10-10
3.8
34
Pro Mug 551
Grocery
Umbrella
$45.94
206
2020-12-02
2.7
35
Ultra Mug 514
Clothing
Wayne Enterprises
$484.40
357
2022-12-21
2.7
36
Pro Camera 944
Home
Wayne Enterprises
$211.34
473
2020-07-01
4.5
37
Mini Notebook 156
Electronics
Umbrella
$900.67
312
2023-02-28
4.7
38
Premium Jacket 198
Electronics
Wayne Enterprises
$651.34
10
2019-06-22
1.9
39
Classic Drone 215
Sports
Acme Corp
$290.56
272
2020-06-08
1.2
40
Mini Sneaker 570
Sports
Wayne Enterprises
$897.23
338
2021-10-15
4.6

Column spanning

ColSpan lets a cell cover the next columns of its row: a discontinued product's name spans Category, and a premium price spans Stock. Assistive technologies get the span through aria-colspan.

1
Vintage Gadget 212
Home
$171.75
131
2
⚠ Eco Notebook 554 - discontinued
$382.16
130
3
Classic Gadget 181
Toys
★ Premium: $813.02 · 269 in stock
4
⚠ Vintage Blender 267 - discontinued
$310.12
291
5
⚠ Vintage Jacket 234 - discontinued
$55.50
390
6
Smart Drone 229
Electronics
$603.51
257
7
Eco Widget 428
Books
$72.97
359
8
⚠ Pro Blender 549 - discontinued
★ Premium: $825.55 · 6 in stock
9
⚠ Deluxe Mug 514 - discontinued
$615.44
22
10
Mini Jacket 367
Grocery
$585.87
367
11
⚠ Vintage Gadget 192 - discontinued
$334.92
388
12
Mini Mug 788
Toys
$712.80
144
13
Classic Mug 124
Books
$267.79
19
14
⚠ Compact Gadget 195 - discontinued
$325.60
375
15
Deluxe Speaker 932
Sports
$281.65
272
16
Eco Widget 307
Grocery
★ Premium: $982.55 · 390 in stock
17
Mini Blender 740
Electronics
$597.20
195
18
⚠ Pro Blender 952 - discontinued
$132.04
53
19
⚠ Classic Drone 459 - discontinued
★ Premium: $906.58 · 481 in stock
20
Mega Mug 839
Sports
$282.70
169
21
Mega Speaker 349
Books
★ Premium: $830.28 · 320 in stock
22
Modern Mug 947
Home
★ Premium: $886.86 · 484 in stock
23
Mini Backpack 199
Sports
$349.39
260
24
⚠ Mini Speaker 940 - discontinued
$60.13
107
25
Deluxe Lamp 430
Home
$760.77
331
26
Eco Mug 633
Toys
$388.23
478
27
Compact Camera 900
Electronics
$300.37
290
28
Mega Mug 366
Grocery
$749.69
15
29
Mini Jacket 409
Books
$604.08
321
30
Premium Camera 361
Grocery
$352.80
0
31
Mega Gadget 949
Books
$654.24
99
32
Mega Lamp 485
Books
$787.62
277
33
Compact Backpack 302
Clothing
$540.00
406
34
⚠ Pro Mug 551 - discontinued
$45.94
206
35
⚠ Ultra Mug 514 - discontinued
$484.40
357
36
Pro Camera 944
Home
$211.34
473
37
Mini Notebook 156
Electronics
★ Premium: $900.67 · 312 in stock
38
Premium Jacket 198
Electronics
$651.34
10
39
⚠ Classic Drone 215 - discontinued
$290.56
272
40
Mini Sneaker 570
Sports
★ Premium: $897.23 · 338 in stock

Borders, striping & row numbers

Bordered, Striped and Hoverable are on by default. ShowRowNumbers numbers the rows by their place in the whole data set - page 2 starts at 9 - and is never exported.


1
1
Vintage Gadget 212
Home
$171.75
131
2
2
Eco Notebook 554
Clothing
$382.16
130
3
3
Classic Gadget 181
Toys
$813.02
269
4
4
Vintage Blender 267
Electronics
$310.12
291
5
5
Vintage Jacket 234
Electronics
$55.50
390
6
6
Smart Drone 229
Electronics
$603.51
257
7
7
Eco Widget 428
Books
$72.97
359
8
8
Pro Blender 549
Electronics
$825.55
6
1–8 of 60
Page 1 of 8

Row & cell styling

RowClass and RowStyle style a row from its data - out-of-stock rows turn red, premium ones bold; a column's CellClassSelector and CellStyleSelector do the same for its own cells - low stock in amber. ShowCellTooltips gives every cell its full text as a tooltip (a column opts out with ShowTooltip="false"): narrow the Name column and hover a name.

1
Vintage Gadget 212
Wayne Enterprises
Home
$171.75
131
2
Eco Notebook 554
Soylent
Clothing
$382.16
130
3
Classic Gadget 181
Wonka Inc
Toys
$813.02
269
4
Vintage Blender 267
Wayne Enterprises
Electronics
$310.12
291
5
Vintage Jacket 234
Wayne Enterprises
Electronics
$55.50
390
6
Smart Drone 229
Stark Industries
Electronics
$603.51
257
7
Eco Widget 428
Wayne Enterprises
Books
$72.97
359
8
Pro Blender 549
Acme Corp
Electronics
$825.55
6
9
Deluxe Mug 514
Wayne Enterprises
Clothing
$615.44
22
10
Mini Jacket 367
Initech
Grocery
$585.87
367
11
Vintage Gadget 192
Soylent
Home
$334.92
388
12
Mini Mug 788
Acme Corp
Toys
$712.80
144
13
Classic Mug 124
Acme Corp
Books
$267.79
19
14
Compact Gadget 195
Wayne Enterprises
Clothing
$325.60
375
15
Deluxe Speaker 932
Initech
Sports
$281.65
272
16
Eco Widget 307
Initech
Grocery
$982.55
390
17
Mini Blender 740
Wonka Inc
Electronics
$597.20
195
18
Pro Blender 952
Stark Industries
Sports
$132.04
53
19
Classic Drone 459
Soylent
Electronics
$906.58
481
20
Mega Mug 839
Wonka Inc
Sports
$282.70
169
21
Mega Speaker 349
Wonka Inc
Books
$830.28
320
22
Modern Mug 947
Stark Industries
Home
$886.86
484
23
Mini Backpack 199
Wayne Enterprises
Sports
$349.39
260
24
Mini Speaker 940
Initech
Electronics
$60.13
107
25
Deluxe Lamp 430
Initech
Home
$760.77
331
26
Eco Mug 633
Initech
Toys
$388.23
478
27
Compact Camera 900
Stark Industries
Electronics
$300.37
290
28
Mega Mug 366
Stark Industries
Grocery
$749.69
15
29
Mini Jacket 409
Acme Corp
Books
$604.08
321
30
Premium Camera 361
Globex
Grocery
$352.80
0
31
Mega Gadget 949
Initech
Books
$654.24
99
32
Mega Lamp 485
Stark Industries
Books
$787.62
277
33
Compact Backpack 302
Wayne Enterprises
Clothing
$540.00
406
34
Pro Mug 551
Umbrella
Grocery
$45.94
206
35
Ultra Mug 514
Wayne Enterprises
Clothing
$484.40
357
36
Pro Camera 944
Wayne Enterprises
Home
$211.34
473
37
Mini Notebook 156
Umbrella
Electronics
$900.67
312
38
Premium Jacket 198
Wayne Enterprises
Electronics
$651.34
10
39
Classic Drone 215
Acme Corp
Sports
$290.56
272
40
Mini Sneaker 570
Wayne Enterprises
Sports
$897.23
338
41
Modern Camera 946
Globex
Sports
$661.07
44
42
Vintage Mug 824
Initech
Sports
$444.42
453
43
Mini Mug 925
Wonka Inc
Electronics
$843.33
173
44
Premium Camera 560
Globex
Grocery
$35.33
277
45
Vintage Gadget 237
Wonka Inc
Home
$383.48
282
46
Pro Drone 577
Initech
Electronics
$285.56
438
47
Eco Jacket 846
Wonka Inc
Grocery
$59.26
414
48
Smart Camera 226
Initech
Toys
$612.62
229
49
Classic Gadget 202
Globex
Electronics
$494.25
256
50
Mega Sneaker 417
Soylent
Sports
$955.45
169
51
Premium Gadget 932
Wayne Enterprises
Clothing
$741.93
301
52
Premium Lamp 283
Soylent
Toys
$943.60
49
53
Pro Mug 237
Initech
Toys
$264.98
237
54
Eco Lamp 139
Wonka Inc
Electronics
$175.86
112
55
Ultra Lamp 134
Wayne Enterprises
Grocery
$47.06
77
56
Ultra Blender 911
Initech
Grocery
$80.83
62
57
Ultra Gadget 323
Stark Industries
Books
$647.39
313
58
Deluxe Blender 420
Acme Corp
Home
$506.54
17
59
Deluxe Camera 513
Acme Corp
Sports
$234.18
305
60
Eco Mug 642
Umbrella
Electronics
$809.15
442

Text wrapping & row height

WrapCellText wraps long values (and headers) instead of cutting them off, and the row grows to fit; a column overrides it with WrapText. RowHeight (36) is every row's minimum height, and RowHeightSelector sets it per row - premium products here. Wrapping is off while Virtualize is on, which needs every row at exactly RowHeight.



Description
1
Vintage Gadget 212
Vintage Gadget 212 is a home product supplied by Wayne Enterprises, released on 1/19/2023 and currently rated 3.9 out of 5 by our customers.
$171.75
131
2
Eco Notebook 554
Eco Notebook 554 is a clothing product supplied by Soylent, released on 7/18/2019 and currently rated 3.1 out of 5 by our customers.
$382.16
130
3
Classic Gadget 181
Classic Gadget 181 is a toys product supplied by Wonka Inc, released on 3/12/2023 and currently rated 1.2 out of 5 by our customers.
$813.02
269
4
Vintage Blender 267
Vintage Blender 267 is a electronics product supplied by Wayne Enterprises, released on 1/25/2021 and currently rated 4.3 out of 5 by our customers.
$310.12
291
5
Vintage Jacket 234
Vintage Jacket 234 is a electronics product supplied by Wayne Enterprises, released on 8/20/2022 and currently rated 3.5 out of 5 by our customers.
$55.50
390
6
Smart Drone 229
Smart Drone 229 is a electronics product supplied by Stark Industries, released on 2/18/2020 and currently rated 1.2 out of 5 by our customers.
$603.51
257
7
Eco Widget 428
Eco Widget 428 is a books product supplied by Wayne Enterprises, released on 12/8/2023 and currently rated 1.3 out of 5 by our customers.
$72.97
359
8
Pro Blender 549
Pro Blender 549 is a electronics product supplied by Acme Corp, released on 6/2/2020 and currently rated 1.0 out of 5 by our customers.
$825.55
6
9
Deluxe Mug 514
Deluxe Mug 514 is a clothing product supplied by Wayne Enterprises, released on 8/11/2021 and currently rated 2.5 out of 5 by our customers.
$615.44
22
10
Mini Jacket 367
Mini Jacket 367 is a grocery product supplied by Initech, released on 10/4/2018 and currently rated 1.1 out of 5 by our customers.
$585.87
367
11
Vintage Gadget 192
Vintage Gadget 192 is a home product supplied by Soylent, released on 10/27/2022 and currently rated 1.6 out of 5 by our customers.
$334.92
388
12
Mini Mug 788
Mini Mug 788 is a toys product supplied by Acme Corp, released on 6/9/2020 and currently rated 3.2 out of 5 by our customers.
$712.80
144
13
Classic Mug 124
Classic Mug 124 is a books product supplied by Acme Corp, released on 9/9/2021 and currently rated 1.9 out of 5 by our customers.
$267.79
19
14
Compact Gadget 195
Compact Gadget 195 is a clothing product supplied by Wayne Enterprises, released on 10/9/2023 and currently rated 4.3 out of 5 by our customers.
$325.60
375
15
Deluxe Speaker 932
Deluxe Speaker 932 is a sports product supplied by Initech, released on 12/13/2022 and currently rated 3.5 out of 5 by our customers.
$281.65
272
16
Eco Widget 307
Eco Widget 307 is a grocery product supplied by Initech, released on 12/24/2022 and currently rated 1.5 out of 5 by our customers.
$982.55
390
17
Mini Blender 740
Mini Blender 740 is a electronics product supplied by Wonka Inc, released on 2/4/2022 and currently rated 4.5 out of 5 by our customers.
$597.20
195
18
Pro Blender 952
Pro Blender 952 is a sports product supplied by Stark Industries, released on 11/8/2018 and currently rated 1.0 out of 5 by our customers.
$132.04
53
19
Classic Drone 459
Classic Drone 459 is a electronics product supplied by Soylent, released on 3/5/2022 and currently rated 4.6 out of 5 by our customers.
$906.58
481
20
Mega Mug 839
Mega Mug 839 is a sports product supplied by Wonka Inc, released on 8/25/2022 and currently rated 3.1 out of 5 by our customers.
$282.70
169
21
Mega Speaker 349
Mega Speaker 349 is a books product supplied by Wonka Inc, released on 8/5/2019 and currently rated 1.3 out of 5 by our customers.
$830.28
320
22
Modern Mug 947
Modern Mug 947 is a home product supplied by Stark Industries, released on 11/5/2022 and currently rated 1.6 out of 5 by our customers.
$886.86
484
23
Mini Backpack 199
Mini Backpack 199 is a sports product supplied by Wayne Enterprises, released on 2/6/2021 and currently rated 3.9 out of 5 by our customers.
$349.39
260
24
Mini Speaker 940
Mini Speaker 940 is a electronics product supplied by Initech, released on 5/29/2022 and currently rated 2.3 out of 5 by our customers.
$60.13
107
25
Deluxe Lamp 430
Deluxe Lamp 430 is a home product supplied by Initech, released on 4/24/2019 and currently rated 5.0 out of 5 by our customers.
$760.77
331
26
Eco Mug 633
Eco Mug 633 is a toys product supplied by Initech, released on 3/7/2019 and currently rated 1.3 out of 5 by our customers.
$388.23
478
27
Compact Camera 900
Compact Camera 900 is a electronics product supplied by Stark Industries, released on 10/2/2021 and currently rated 1.1 out of 5 by our customers.
$300.37
290
28
Mega Mug 366
Mega Mug 366 is a grocery product supplied by Stark Industries, released on 10/8/2023 and currently rated 2.4 out of 5 by our customers.
$749.69
15
29
Mini Jacket 409
Mini Jacket 409 is a books product supplied by Acme Corp, released on 5/11/2020 and currently rated 3.4 out of 5 by our customers.
$604.08
321
30
Premium Camera 361
Premium Camera 361 is a grocery product supplied by Globex, released on 2/25/2023 and currently rated 3.3 out of 5 by our customers.
$352.80
0
31
Mega Gadget 949
Mega Gadget 949 is a books product supplied by Initech, released on 4/16/2019 and currently rated 3.6 out of 5 by our customers.
$654.24
99
32
Mega Lamp 485
Mega Lamp 485 is a books product supplied by Stark Industries, released on 10/1/2021 and currently rated 3.2 out of 5 by our customers.
$787.62
277
33
Compact Backpack 302
Compact Backpack 302 is a clothing product supplied by Wayne Enterprises, released on 10/10/2020 and currently rated 3.8 out of 5 by our customers.
$540.00
406
34
Pro Mug 551
Pro Mug 551 is a grocery product supplied by Umbrella, released on 12/2/2020 and currently rated 2.7 out of 5 by our customers.
$45.94
206
35
Ultra Mug 514
Ultra Mug 514 is a clothing product supplied by Wayne Enterprises, released on 12/21/2022 and currently rated 2.7 out of 5 by our customers.
$484.40
357
36
Pro Camera 944
Pro Camera 944 is a home product supplied by Wayne Enterprises, released on 7/1/2020 and currently rated 4.5 out of 5 by our customers.
$211.34
473
37
Mini Notebook 156
Mini Notebook 156 is a electronics product supplied by Umbrella, released on 2/28/2023 and currently rated 4.7 out of 5 by our customers.
$900.67
312
38
Premium Jacket 198
Premium Jacket 198 is a electronics product supplied by Wayne Enterprises, released on 6/22/2019 and currently rated 1.9 out of 5 by our customers.
$651.34
10
39
Classic Drone 215
Classic Drone 215 is a sports product supplied by Acme Corp, released on 6/8/2020 and currently rated 1.2 out of 5 by our customers.
$290.56
272
40
Mini Sneaker 570
Mini Sneaker 570 is a sports product supplied by Wayne Enterprises, released on 10/15/2021 and currently rated 4.6 out of 5 by our customers.
$897.23
338

Empty & loading states

With no rows the grid shows a message, or your EmptyTemplate. Loading shows a spinner - or your LoadingTemplate - in place of the rows and marks the grid aria-busy.


Nothing here yet

Tree data

ChildrenSelector turns Items into the roots of a tree (a treegrid whose rows carry their level and expanded state). Sorting keeps the hierarchy, and a search or filter prunes it to the matching branches. TreeInitiallyExpanded sets how it opens; ExpandAllAsync / CollapseAllAsync drive it from code. With CellNavigation, → and ← open and close a node from its first cell, and ← on a child goes to its parent.


src
Folder
81,710
2025-01-17
BitDataGrid
Folder
79,470
2025-01-11
BitDataGrid.razor
File
24,500
2025-01-02
BitDataGrid.razor.cs
File
41,200
2025-01-03
Models
Folder
1,470
2025-01-07
BitTextAlign.cs
File
320
2025-01-04
BitDataGridSortDescriptor.cs
File
540
2025-01-05
BitDataGridFilterOperator.cs
File
610
2025-01-06
Infrastructure
Folder
12,300
2025-01-10
BitDataGridDataProcessor.cs
File
8,900
2025-01-08
BitDataGridPropertyAccessor.cs
File
3,400
2025-01-09
BitDataGrid.Demo
Folder
2,240
2025-01-16
Program.cs
File
1,200
2025-01-12
Components
Folder
1,040
2025-01-15
App.razor
File
760
2025-01-13
Routes.razor
File
280
2025-01-14
docs
Folder
8,500
2025-01-20
README.md
File
6,400
2025-01-18
CHANGELOG.md
File
2,100
2025-01-19
assets
Folder
18,250
2025-01-24
logo.svg
File
4,800
2025-01-21
styles.css
File
12,300
2025-01-22
favicon.ico
File
1,150
2025-01-23
LICENSE
File
1,070
2025-01-25
.gitignore
File
410
2025-01-26


OnLoadChildren loads a node's children on its first expand (cached afterwards), with a token the grid cancels once it no longer needs them (new Items, or the grid is gone); ChildrenProvider does the same without the token. HasChildrenSelector tells an unloaded node whether to offer a toggle. Each folder below takes 600 ms to load.

LICENSE
File
1,070
2025-01-02

Virtualization

Virtualize renders only the rows in view (it needs a Height), and VirtualizeColumns does the same for columns, which then need pixel widths. This grid has 42 columns; try 100,000 rows. A grouped view is virtualized the same way, its group rows RowHeight tall like the rest.

10,000 rows

M01
M02
M03
M04
M05
M06
M07
M08
M09
M10
M11
M12
M13
M14
M15
M16
M17
M18
M19
M20
M21
M22
M23
M24
M25
M26
M27
M28
M29
M30
M31
M32
M33
M34
M35
M36
M37
M38
M39
M40
1
Vintage Gadget 212
50
63
76
89
102
115
128
141
154
167
180
193
206
219
232
245
258
271
284
297
310
323
336
349
362
375
388
401
414
427
440
453
466
479
492
505
518
531
544
557
2
Eco Notebook 554
87
100
113
126
139
152
165
178
191
204
217
230
243
256
269
282
295
308
321
334
347
360
373
386
399
412
425
438
451
464
477
490
503
516
529
542
555
568
581
594
3
Classic Gadget 181
124
137
150
163
176
189
202
215
228
241
254
267
280
293
306
319
332
345
358
371
384
397
410
423
436
449
462
475
488
501
514
527
540
553
566
579
592
605
618
631
4
Vintage Blender 267
161
174
187
200
213
226
239
252
265
278
291
304
317
330
343
356
369
382
395
408
421
434
447
460
473
486
499
512
525
538
551
564
577
590
603
616
629
642
655
668
5
Vintage Jacket 234
198
211
224
237
250
263
276
289
302
315
328
341
354
367
380
393
406
419
432
445
458
471
484
497
510
523
536
549
562
575
588
601
614
627
640
653
666
679
692
705
6
Smart Drone 229
235
248
261
274
287
300
313
326
339
352
365
378
391
404
417
430
443
456
469
482
495
508
521
534
547
560
573
586
599
612
625
638
651
664
677
690
703
716
729
742
7
Eco Widget 428
272
285
298
311
324
337
350
363
376
389
402
415
428
441
454
467
480
493
506
519
532
545
558
571
584
597
610
623
636
649
662
675
688
701
714
727
740
753
766
779
8
Pro Blender 549
309
322
335
348
361
374
387
400
413
426
439
452
465
478
491
504
517
530
543
556
569
582
595
608
621
634
647
660
673
686
699
712
725
738
751
764
777
790
803
816
9
Deluxe Mug 514
346
359
372
385
398
411
424
437
450
463
476
489
502
515
528
541
554
567
580
593
606
619
632
645
658
671
684
697
710
723
736
749
762
775
788
801
814
827
840
853
10
Mini Jacket 367
383
396
409
422
435
448
461
474
487
500
513
526
539
552
565
578
591
604
617
630
643
656
669
682
695
708
721
734
747
760
773
786
799
812
825
838
851
864
877
890
11
Vintage Gadget 192
420
433
446
459
472
485
498
511
524
537
550
563
576
589
602
615
628
641
654
667
680
693
706
719
732
745
758
771
784
797
810
823
836
849
862
875
888
901
914
927
12
Mini Mug 788
457
470
483
496
509
522
535
548
561
574
587
600
613
626
639
652
665
678
691
704
717
730
743
756
769
782
795
808
821
834
847
860
873
886
899
912
925
938
951
964
13
Classic Mug 124
494
507
520
533
546
559
572
585
598
611
624
637
650
663
676
689
702
715
728
741
754
767
780
793
806
819
832
845
858
871
884
897
910
923
936
949
962
975
988
1
14
Compact Gadget 195
531
544
557
570
583
596
609
622
635
648
661
674
687
700
713
726
739
752
765
778
791
804
817
830
843
856
869
882
895
908
921
934
947
960
973
986
999
12
25
38
15
Deluxe Speaker 932
568
581
594
607
620
633
646
659
672
685
698
711
724
737
750
763
776
789
802
815
828
841
854
867
880
893
906
919
932
945
958
971
984
997
10
23
36
49
62
75
16
Eco Widget 307
605
618
631
644
657
670
683
696
709
722
735
748
761
774
787
800
813
826
839
852
865
878
891
904
917
930
943
956
969
982
995
8
21
34
47
60
73
86
99
112
17
Mini Blender 740
642
655
668
681
694
707
720
733
746
759
772
785
798
811
824
837
850
863
876
889
902
915
928
941
954
967
980
993
6
19
32
45
58
71
84
97
110
123
136
149
18
Pro Blender 952
679
692
705
718
731
744
757
770
783
796
809
822
835
848
861
874
887
900
913
926
939
952
965
978
991
4
17
30
43
56
69
82
95
108
121
134
147
160
173
186
19
Classic Drone 459
716
729
742
755
768
781
794
807
820
833
846
859
872
885
898
911
924
937
950
963
976
989
2
15
28
41
54
67
80
93
106
119
132
145
158
171
184
197
210
223
20
Mega Mug 839
753
766
779
792
805
818
831
844
857
870
883
896
909
922
935
948
961
974
987
0
13
26
39
52
65
78
91
104
117
130
143
156
169
182
195
208
221
234
247
260
21
Mega Speaker 349
790
803
816
829
842
855
868
881
894
907
920
933
946
959
972
985
998
11
24
37
50
63
76
89
102
115
128
141
154
167
180
193
206
219
232
245
258
271
284
297
22
Modern Mug 947
827
840
853
866
879
892
905
918
931
944
957
970
983
996
9
22
35
48
61
74
87
100
113
126
139
152
165
178
191
204
217
230
243
256
269
282
295
308
321
334
23
Mini Backpack 199
864
877
890
903
916
929
942
955
968
981
994
7
20
33
46
59
72
85
98
111
124
137
150
163
176
189
202
215
228
241
254
267
280
293
306
319
332
345
358
371
24
Mini Speaker 940
901
914
927
940
953
966
979
992
5
18
31
44
57
70
83
96
109
122
135
148
161
174
187
200
213
226
239
252
265
278
291
304
317
330
343
356
369
382
395
408

Server-side data

OnRead hands sorting, filtering, searching and paging to your code: each request carries the page window, the descriptors, the search term and a CancellationToken the grid cancels when a newer request replaces it. Return the rows and the TotalCount.

1
Vintage Gadget 212
Home
Wayne Enterprises
$171.75
131
2
Eco Notebook 554
Clothing
Soylent
$382.16
130
3
Classic Gadget 181
Toys
Wonka Inc
$813.02
269
4
Vintage Blender 267
Electronics
Wayne Enterprises
$310.12
291
5
Vintage Jacket 234
Electronics
Wayne Enterprises
$55.50
390
6
Smart Drone 229
Electronics
Stark Industries
$603.51
257
7
Eco Widget 428
Books
Wayne Enterprises
$72.97
359
8
Pro Blender 549
Electronics
Acme Corp
$825.55
6
9
Deluxe Mug 514
Clothing
Wayne Enterprises
$615.44
22
10
Mini Jacket 367
Grocery
Initech
$585.87
367
1–10 of 523
Page 1 of 53

Last request → skip 0, take 10, sorts: 0, filters: 0, total: 523


With Virtualize instead of paging, rows are fetched as they scroll into view - 100,000 here. The request's Aggregates name what the footer shows (a sum of Price and an average of Rating), and the result's Aggregates fill it in over the whole matching set.

1
Vintage Gadget 212
Home
Wayne Enterprises
$171.75
131
3.9
2
Eco Notebook 554
Clothing
Soylent
$382.16
130
3.1
3
Classic Gadget 181
Toys
Wonka Inc
$813.02
269
1.2
4
Vintage Blender 267
Electronics
Wayne Enterprises
$310.12
291
4.3
5
Vintage Jacket 234
Electronics
Wayne Enterprises
$55.50
390
3.5
6
Smart Drone 229
Electronics
Stark Industries
$603.51
257
1.2
7
Eco Widget 428
Books
Wayne Enterprises
$72.97
359
1.3
8
Pro Blender 549
Electronics
Acme Corp
$825.55
6
1.0
9
Deluxe Mug 514
Clothing
Wayne Enterprises
$615.44
22
2.5
10
Mini Jacket 367
Grocery
Initech
$585.87
367
1.1
11
Vintage Gadget 192
Home
Soylent
$334.92
388
1.6
12
Mini Mug 788
Toys
Acme Corp
$712.80
144
3.2
13
Classic Mug 124
Books
Acme Corp
$267.79
19
1.9
14
Compact Gadget 195
Clothing
Wayne Enterprises
$325.60
375
4.3
15
Deluxe Speaker 932
Sports
Initech
$281.65
272
3.5
16
Eco Widget 307
Grocery
Initech
$982.55
390
1.5
17
Mini Blender 740
Electronics
Wonka Inc
$597.20
195
4.5
18
Pro Blender 952
Sports
Stark Industries
$132.04
53
1.0
19
Classic Drone 459
Electronics
Soylent
$906.58
481
4.6
20
Mega Mug 839
Sports
Wonka Inc
$282.70
169
3.1
21
Mega Speaker 349
Books
Wonka Inc
$830.28
320
1.3
22
Modern Mug 947
Home
Stark Industries
$886.86
484
1.6


With OnReadError set, a read that throws stays inside the grid: an error row with a Retry button takes the place of the rows, and you get the exception to log or report. Check the box, then page or sort - and uncheck it to retry with success. Without OnReadError the exception propagates, as it always has.


1
Vintage Gadget 212
Home
$171.75
2
Eco Notebook 554
Clothing
$382.16
3
Classic Gadget 181
Toys
$813.02
4
Vintage Blender 267
Electronics
$310.12
5
Vintage Jacket 234
Electronics
$55.50
1–5 of 523
Page 1 of 105

Infinite scrolling

OnLoadMore appends the next LoadMoreBatchSize rows as the user nears the end - no total, no pager - and stops at a short batch. It needs a Height. An export asks once for every row with Take = null.

1
Vintage Gadget 212
Home
Wayne Enterprises
$171.75
131
2
Eco Notebook 554
Clothing
Soylent
$382.16
130
3
Classic Gadget 181
Toys
Wonka Inc
$813.02
269
4
Vintage Blender 267
Electronics
Wayne Enterprises
$310.12
291
5
Vintage Jacket 234
Electronics
Wayne Enterprises
$55.50
390
6
Smart Drone 229
Electronics
Stark Industries
$603.51
257
7
Eco Widget 428
Books
Wayne Enterprises
$72.97
359
8
Pro Blender 549
Electronics
Acme Corp
$825.55
6
9
Deluxe Mug 514
Clothing
Wayne Enterprises
$615.44
22
10
Mini Jacket 367
Grocery
Initech
$585.87
367
11
Vintage Gadget 192
Home
Soylent
$334.92
388
12
Mini Mug 788
Toys
Acme Corp
$712.80
144
13
Classic Mug 124
Books
Acme Corp
$267.79
19
14
Compact Gadget 195
Clothing
Wayne Enterprises
$325.60
375
15
Deluxe Speaker 932
Sports
Initech
$281.65
272
16
Eco Widget 307
Grocery
Initech
$982.55
390
17
Mini Blender 740
Electronics
Wonka Inc
$597.20
195
18
Pro Blender 952
Sports
Stark Industries
$132.04
53
19
Classic Drone 459
Electronics
Soylent
$906.58
481
20
Mega Mug 839
Sports
Wonka Inc
$282.70
169
21
Mega Speaker 349
Books
Wonka Inc
$830.28
320
22
Modern Mug 947
Home
Stark Industries
$886.86
484
23
Mini Backpack 199
Sports
Wayne Enterprises
$349.39
260
24
Mini Speaker 940
Electronics
Initech
$60.13
107
25
Deluxe Lamp 430
Home
Initech
$760.77
331
26
Eco Mug 633
Toys
Initech
$388.23
478
27
Compact Camera 900
Electronics
Stark Industries
$300.37
290
28
Mega Mug 366
Grocery
Stark Industries
$749.69
15
29
Mini Jacket 409
Books
Acme Corp
$604.08
321
30
Premium Camera 361
Grocery
Globex
$352.80
0
31
Mega Gadget 949
Books
Initech
$654.24
99
32
Mega Lamp 485
Books
Stark Industries
$787.62
277
33
Compact Backpack 302
Clothing
Wayne Enterprises
$540.00
406
34
Pro Mug 551
Grocery
Umbrella
$45.94
206
35
Ultra Mug 514
Clothing
Wayne Enterprises
$484.40
357
36
Pro Camera 944
Home
Wayne Enterprises
$211.34
473
37
Mini Notebook 156
Electronics
Umbrella
$900.67
312
38
Premium Jacket 198
Electronics
Wayne Enterprises
$651.34
10
39
Classic Drone 215
Sports
Acme Corp
$290.56
272
40
Mini Sneaker 570
Sports
Wayne Enterprises
$897.23
338

Batch #1 → rows 1–40

IQueryable data source

Bind an IQueryable<T> - an EF Core DbSet, say - and the filters, sorts, search and paging become an expression the provider runs at the source, so only the current page is materialized.

1
Vintage Gadget 212
Wayne Enterprises
$171.75
131
2
Eco Notebook 554
Soylent
$382.16
130
3
Classic Gadget 181
Wonka Inc
$813.02
269
4
Vintage Blender 267
Wayne Enterprises
$310.12
291
5
Vintage Jacket 234
Wayne Enterprises
$55.50
390
6
Smart Drone 229
Stark Industries
$603.51
257
7
Eco Widget 428
Wayne Enterprises
$72.97
359
8
Pro Blender 549
Acme Corp
$825.55
6
9
Deluxe Mug 514
Wayne Enterprises
$615.44
22
10
Mini Jacket 367
Initech
$585.87
367
1–10 of 400
Page 1 of 40

Export

ShowCsvExport and ShowExcelExport download every matching row (not just the page) as CSV or a real .xlsx with typed cells, an AutoFilter, frozen panes for Frozen columns and merged cells for ColSpan; ExcelExportStyled adds the grid's current colors. ExportValue exports a template column's value, Exportable="false" leaves a column out, and ExportFileName names the files. In code, every export method also takes selectedOnly.

1
Vintage Gadget 212
Home
$171.75
1/19/2023
Wayne Enterprises
$22,499
2
⚠ Eco Notebook 554 - discontinued
$382.16
7/18/2019
Soylent
$49,681
3
Classic Gadget 181
Toys
$813.02
3/12/2023
Wonka Inc
$218,702
4
⚠ Vintage Blender 267 - discontinued
$310.12
1/25/2021
Wayne Enterprises
$90,245
5
⚠ Vintage Jacket 234 - discontinued
$55.50
8/20/2022
Wayne Enterprises
$21,645
6
Smart Drone 229
Electronics
$603.51
2/18/2020
Stark Industries
$155,102
7
Eco Widget 428
Books
$72.97
12/8/2023
Wayne Enterprises
$26,196
8
⚠ Pro Blender 549 - discontinued
$825.55
6/2/2020
Acme Corp
$4,953
9
⚠ Deluxe Mug 514 - discontinued
$615.44
8/11/2021
Wayne Enterprises
$13,540
10
Mini Jacket 367
Grocery
$585.87
10/4/2018
Initech
$215,014
11
⚠ Vintage Gadget 192 - discontinued
$334.92
10/27/2022
Soylent
$129,949
12
Mini Mug 788
Toys
$712.80
6/9/2020
Acme Corp
$102,643
13
Classic Mug 124
Books
$267.79
9/9/2021
Acme Corp
$5,088
14
⚠ Compact Gadget 195 - discontinued
$325.60
10/9/2023
Wayne Enterprises
$122,100
15
Deluxe Speaker 932
Sports
$281.65
12/13/2022
Initech
$76,609
16
Eco Widget 307
Grocery
$982.55
12/24/2022
Initech
$383,195
17
Mini Blender 740
Electronics
$597.20
2/4/2022
Wonka Inc
$116,454
18
⚠ Pro Blender 952 - discontinued
$132.04
11/8/2018
Stark Industries
$6,998
19
⚠ Classic Drone 459 - discontinued
$906.58
3/5/2022
Soylent
$436,065
20
Mega Mug 839
Sports
$282.70
8/25/2022
Wonka Inc
$47,776
21
Mega Speaker 349
Books
$830.28
8/5/2019
Wonka Inc
$265,690
22
Modern Mug 947
Home
$886.86
11/5/2022
Stark Industries
$429,240
23
Mini Backpack 199
Sports
$349.39
2/6/2021
Wayne Enterprises
$90,841
24
⚠ Mini Speaker 940 - discontinued
$60.13
5/29/2022
Initech
$6,434
25
Deluxe Lamp 430
Home
$760.77
4/24/2019
Initech
$251,815
26
Eco Mug 633
Toys
$388.23
3/7/2019
Initech
$185,574
27
Compact Camera 900
Electronics
$300.37
10/2/2021
Stark Industries
$87,107
28
Mega Mug 366
Grocery
$749.69
10/8/2023
Stark Industries
$11,245
29
Mini Jacket 409
Books
$604.08
5/11/2020
Acme Corp
$193,910
30
Premium Camera 361
Grocery
$352.80
2/25/2023
Globex
$0

ToolbarIconOnly renders the toolbar's buttons as icons for a compact toolbar - the exports, Columns, Clear filters (once a filter is on) and Add row - their text kept as the accessible name and shown in a tooltip on hover, focus and touch. A button with no icon of its own draws a built-in one; CsvExportIconName, ExcelExportIconName, ColumnChooserIconName, ClearFiltersIconName and AddRowIconName (or their ...Icon twins for an external icon library) pick another, also shown beside the text when it is not hidden.

Vintage Gadget 212
Home
$171.75
Eco Notebook 554
Clothing
$382.16
Classic Gadget 181
Toys
$813.02
Vintage Blender 267
Electronics
$310.12
Vintage Jacket 234
Electronics
$55.50
Smart Drone 229
Electronics
$603.51
Eco Widget 428
Books
$72.97
Pro Blender 549
Electronics
$825.55
Deluxe Mug 514
Clothing
$615.44
Mini Jacket 367
Grocery
$585.87
Vintage Gadget 192
Home
$334.92
Mini Mug 788
Toys
$712.80
Classic Mug 124
Books
$267.79
Compact Gadget 195
Clothing
$325.60
Deluxe Speaker 932
Sports
$281.65
Eco Widget 307
Grocery
$982.55
Mini Blender 740
Electronics
$597.20
Pro Blender 952
Sports
$132.04
Classic Drone 459
Electronics
$906.58
Mega Mug 839
Sports
$282.70
Mega Speaker 349
Books
$830.28
Modern Mug 947
Home
$886.86
Mini Backpack 199
Sports
$349.39
Mini Speaker 940
Electronics
$60.13
Deluxe Lamp 430
Home
$760.77
Eco Mug 633
Toys
$388.23
Compact Camera 900
Electronics
$300.37
Mega Mug 366
Grocery
$749.69
Mini Jacket 409
Books
$604.08
Premium Camera 361
Grocery
$352.80

Row reordering

RowReorderable adds a ⠿ handle: drag it onto another row (mouse, touch or pen), or focus it and press ↑/↓. The grid moves the item in the bound list and raises OnRowReorder. It pauses while the view is sorted, filtered or grouped.

Reorder
ID
Name
Category
Price
1
Vintage Gadget 212
Home
$171.75
2
Eco Notebook 554
Clothing
$382.16
3
Classic Gadget 181
Toys
$813.02
4
Vintage Blender 267
Electronics
$310.12
5
Vintage Jacket 234
Electronics
$55.50
6
Smart Drone 229
Electronics
$603.51
7
Eco Widget 428
Books
$72.97
8
Pro Blender 549
Electronics
$825.55
9
Deluxe Mug 514
Clothing
$615.44
10
Mini Jacket 367
Grocery
$585.87
11
Vintage Gadget 192
Home
$334.92
12
Mini Mug 788
Toys
$712.80

Cell events & context menu

OnCellClick, OnCellDoubleClick and OnCellContextMenu report the row, the column, the value and the mouse event; right-click a cell for a custom menu. OnRowClick and OnRowDoubleClick report the row alone.

1
Vintage Gadget 212
Home
$171.75
2
Eco Notebook 554
Clothing
$382.16
3
Classic Gadget 181
Toys
$813.02
4
Vintage Blender 267
Electronics
$310.12
5
Vintage Jacket 234
Electronics
$55.50
6
Smart Drone 229
Electronics
$603.51
7
Eco Widget 428
Books
$72.97
8
Pro Blender 549
Electronics
$825.55
9
Deluxe Mug 514
Clothing
$615.44
10
Mini Jacket 367
Grocery
$585.87
11
Vintage Gadget 192
Home
$334.92
12
Mini Mug 788
Toys
$712.80
13
Classic Mug 124
Books
$267.79
14
Compact Gadget 195
Clothing
$325.60
15
Deluxe Speaker 932
Sports
$281.65
16
Eco Widget 307
Grocery
$982.55
17
Mini Blender 740
Electronics
$597.20
18
Pro Blender 952
Sports
$132.04
19
Classic Drone 459
Electronics
$906.58
20
Mega Mug 839
Sports
$282.70
21
Mega Speaker 349
Books
$830.28
22
Modern Mug 947
Home
$886.86
23
Mini Backpack 199
Sports
$349.39
24
Mini Speaker 940
Electronics
$60.13
25
Deluxe Lamp 430
Home
$760.77
26
Eco Mug 633
Toys
$388.23
27
Compact Camera 900
Electronics
$300.37
28
Mega Mug 366
Grocery
$749.69
29
Mini Jacket 409
Books
$604.08
30
Premium Camera 361
Grocery
$352.80
31
Mega Gadget 949
Books
$654.24
32
Mega Lamp 485
Books
$787.62
33
Compact Backpack 302
Clothing
$540.00
34
Pro Mug 551
Grocery
$45.94
35
Ultra Mug 514
Clothing
$484.40
36
Pro Camera 944
Home
$211.34
37
Mini Notebook 156
Electronics
$900.67
38
Premium Jacket 198
Electronics
$651.34
39
Classic Drone 215
Sports
$290.56
40
Mini Sneaker 570
Sports
$897.23

Click, double-click or right-click any cell.

Programmatic control

Everything the UI does is public API: SortByAsync, ApplyFilterAsync, GroupByAsync, GoToPageAsync, SetPageSizeAsync, MoveColumnAsync, SearchAsync, RefreshAsync and more. OnSortChange, OnFilterChange, OnGroupChange and OnPageChange report each change however it was made. OnViewChange hands over the rows of the view across every page - what a map or a chart of the same rows needs - and RevealItemAsync brings any of them into sight, going to its page and opening its group.


1
Vintage Gadget 212
Home
$171.75
131
2
Eco Notebook 554
Clothing
$382.16
130
3
Classic Gadget 181
Toys
$813.02
269
4
Vintage Blender 267
Electronics
$310.12
291
5
Vintage Jacket 234
Electronics
$55.50
390
6
Smart Drone 229
Electronics
$603.51
257
7
Eco Widget 428
Books
$72.97
359
8
Pro Blender 549
Electronics
$825.55
6
9
Deluxe Mug 514
Clothing
$615.44
22
10
Mini Jacket 367
Grocery
$585.87
367
1–10 of 200
Page 1 of 20

The grid reports every view change here.

State persistence

OnStateChange hands over a GetState snapshot - page and page size, search, sorts, filters, groups and which are open, and each column's order, width and visibility - after every change. Store it, then give it to ApplyStateAsync on a new grid; recreate this one to see. A JSON round trip is fine: filter values are converted back to their column's type.

Sort, filter, resize, move or hide columns - every change is saved.

1
Vintage Gadget 212
Home
$171.75
131
2
Eco Notebook 554
Clothing
$382.16
130
3
Classic Gadget 181
Toys
$813.02
269
4
Vintage Blender 267
Electronics
$310.12
291
5
Vintage Jacket 234
Electronics
$55.50
390
6
Smart Drone 229
Electronics
$603.51
257
7
Eco Widget 428
Books
$72.97
359
8
Pro Blender 549
Electronics
$825.55
6
9
Deluxe Mug 514
Clothing
$615.44
22
10
Mini Jacket 367
Grocery
$585.87
367
1–10 of 120
Page 1 of 12

Localization

Every string the grid renders or announces - pager, messages, placeholders, buttons, accessible names and live-region announcements - comes from Strings. Override what you need; the rest keeps its English default.

1
Vintage Gadget 212
$171.75
131
2
Eco Notebook 554
$382.16
130
3
Classic Gadget 181
$813.02
269
4
Vintage Blender 267
$310.12
291
5
Vintage Jacket 234
$55.50
390
6
Smart Drone 229
$603.51
257
7
Eco Widget 428
$72.97
359
8
Pro Blender 549
$825.55
6
1–8 von 60
Seite 1 von 8

Disabled

Disabled keeps the data readable - a focused cell still moves and copies - but disables every control and gesture in the grid, which reports aria-disabled.


ID
Name
Category
Price
1
Vintage Gadget 212
Home
$171.75
2
Eco Notebook 554
Clothing
$382.16
3
Classic Gadget 181
Toys
$813.02
4
Vintage Blender 267
Electronics
$310.12
5
Vintage Jacket 234
Electronics
$55.50
6
Smart Drone 229
Electronics
$603.51
7
Eco Widget 428
Books
$72.97
8
Pro Blender 549
Electronics
$825.55
1–8 of 40
Page 1 of 5

Cascading parameters

BitParams carries a BitDataGridParams to every grid under it - the defaults an app wants everywhere, Strings included. Both grids here take row numbers, a filter row and pages of 5 from it; they are defaults, not overrides, so the second grid keeps the Striped it sets itself.

1
1
Vintage Gadget 212
$171.75
2
2
Eco Notebook 554
$382.16
3
3
Classic Gadget 181
$813.02
4
4
Vintage Blender 267
$310.12
5
5
Vintage Jacket 234
$55.50
1–5 of 30
Page 1 of 6

1
1
Vintage Gadget 212
$171.75
2
2
Eco Notebook 554
$382.16
3
3
Classic Gadget 181
$813.02
4
4
Vintage Blender 267
$310.12
5
5
Vintage Jacket 234
$55.50
1–5 of 30
Page 1 of 6

Style & Class

Style and Class land on the root; Styles and Classes reach each part on its own - the toolbar, the header row and cells, the rows, a selected row, the cells, the footer, the pager and more.

1
Vintage Gadget 212
$171.75
2
Eco Notebook 554
$382.16
3
Classic Gadget 181
$813.02
4
Vintage Blender 267
$310.12
5
Vintage Jacket 234
$55.50
1–5 of 20
Page 1 of 4


The grid also reads CSS variables. They inherit, so a value on :root or an ancestor restyles every grid below it, and one on Style restyles one grid. Here: a compact, accent-colored grid.

1
1
Vintage Gadget 212
Home
$171.75
2
2
Eco Notebook 554
Clothing
$382.16
3
3
Classic Gadget 181
Toys
$813.02
4
4
Vintage Blender 267
Electronics
$310.12
5
5
Vintage Jacket 234
Electronics
$55.50
6
6
Smart Drone 229
Electronics
$603.51
7
7
Eco Widget 428
Books
$72.97
8
8
Pro Blender 549
Electronics
$825.55
9
9
Deluxe Mug 514
Clothing
$615.44
10
10
Mini Jacket 367
Grocery
$585.87
11
11
Vintage Gadget 192
Home
$334.92
12
12
Mini Mug 788
Toys
$712.80
13
13
Classic Mug 124
Books
$267.79
14
14
Compact Gadget 195
Clothing
$325.60
15
15
Deluxe Speaker 932
Sports
$281.65
16
16
Eco Widget 307
Grocery
$982.55
17
17
Mini Blender 740
Electronics
$597.20
18
18
Pro Blender 952
Sports
$132.04
19
19
Classic Drone 459
Electronics
$906.58
20
20
Mega Mug 839
Sports
$282.70

RTL

Dir="BitDir.Rtl" mirrors the grid: frozen columns, arrows and keyboard navigation follow the reading direction. Without it, the grid takes a cascaded BitDir, or else the page's direction.

1
قدیمی گجت 212
خانه
$171.75
131
2
اقتصادی دفترچه 554
پوشاک
$382.16
130
3
کلاسیک گجت 181
اسباب‌بازی
$813.02
269
4
قدیمی مخلوط‌کن 267
الکترونیک
$310.12
291
5
قدیمی ژاکت 234
الکترونیک
$55.50
390
6
هوشمند پهپاد 229
الکترونیک
$603.51
257
7
اقتصادی ویجت 428
کتاب
$72.97
359
8
حرفه‌ای مخلوط‌کن 549
الکترونیک
$825.55
6
1–8 از 60
صفحهٔ 1 از 8

CSS variables

The public custom properties this component reads off its root, for what no parameter covers.

Every variable is read with a fallback and never declared by the component, so it inherits like any other custom property: set one on :root (or in a [bit-theme] block) to restyle every instance, on any ancestor to restyle the ones inside it, or on the Style of one instance to restyle it - and any instance nested inside it, which inherits the value too; a parameter changes one alone, as does the real CSS property on the instance's Style / Styles when that property does not inherit (opacity: 1 keeps one disabled instance undimmed without undimming a disabled one inside it), while an inherited one such as color or font-family also reaches the nested instances that do not set it themselves. Leave a variable unset and the component falls back to the theme token beside it.

BitDataGrid CSS variables

Name Default value Description
--bit-DataGrid-background --bit-clr-bg-pri Background of the grid and its rows.
--bit-DataGrid-color --bit-clr-fg-pri Text color.
--bit-DataGrid-font-family --bit-tpg-font-family Font of the grid.
--bit-DataGrid-font-size --bit-tpg-fs-sm Font size of the grid.
--bit-DataGrid-line-height 1.4 Line height of the cells.
--bit-DataGrid-border-color --bit-clr-brd-ter Color of the border and of the row and column lines.
--bit-DataGrid-border-radius --bit-shp-radius-surface Corner radius of the grid.
--bit-DataGrid-cell-padding spacing(1) spacing(1.25) Padding of the cells.
--bit-DataGrid-header-background --bit-clr-bg-sec Background of the header rows and the column chooser.
--bit-DataGrid-header-color The grid's color Text color of the header rows.
--bit-DataGrid-header-font-weight --bit-tpg-fw-semibold Font weight of the column titles.
--bit-DataGrid-stripe-background --bit-clr-bg-sec Background of the striped rows.
--bit-DataGrid-hover-background --bit-clr-bg-pri-hover Background of the hovered row.
--bit-DataGrid-selected-background --bit-clr-pri-tint Wash over a selected row.
--bit-DataGrid-selected-color The grid's color Text color of a selected row.
--bit-DataGrid-editing-background --bit-clr-wrn-tint Wash over the row (or cell) being edited.
--bit-DataGrid-accent-color --bit-clr-pri Sort arrows, badges, group toggle and bar, checkboxes and resize handle.
--bit-DataGrid-focus-color --bit-clr-pri-focus Focus indicator of the cells, rows and controls.
--bit-DataGrid-group-background --bit-clr-bg-ter Background of the group header rows.
--bit-DataGrid-group-indent spacing(2.5) Indent of each group level.
--bit-DataGrid-tree-indent spacing(2.25) Indent of each tree level.
--bit-DataGrid-detail-background --bit-clr-bg-sec Background of the detail rows.
--bit-DataGrid-footer-background --bit-clr-bg-sec Background of the footer row.
--bit-DataGrid-disabled-color --bit-clr-fg-dis Text color of a disabled grid.
--bit-DataGrid-placeholder-color --bit-clr-fg-sec Placeholder of the search and filter boxes.

API

Every parameter, public member, sub-class and enum this component exposes.

BitDataGrid parameters

Name Type Default value Description
AddRowIcon BitIconInfo? null The icon of the Add row button from an external icon library (ligature sets such as Material Icons included), shown beside its text or alone with ToolbarIconOnly. Takes precedence over AddRowIconName.
AddRowIconName string? null The name of the icon of the Add row button from the Fluent UI icon set of Bit.BlazorUI.Icons, whose stylesheet the app links, e.g. BitIconName.CirclePlus.
AllowUnsorted bool true Whether a third header click removes the sort (ascending → descending → unsorted). Overridable per column.
AriaDescribedBy string? null Id of the element that describes the grid.
AriaLabelledBy string? null Id of the element that names the grid, in place of AriaLabel.
Bordered bool true Draws the outer border and the column lines; the row lines are always drawn.
CellNavigation bool false Makes the data cells one tab stop: the arrows, Home/End and PageUp/PageDown move; Enter/F2 or typing edits; Esc cancels; Space selects (Shift+Space a range); Ctrl+A selects all; Delete deletes when Editable. Without it (or Single selection, Cell editing, a tree) no cell takes the focus, so the grid is announced as a table: role=table, its cells cell.
ChildContent RenderFragment? null Column definitions and other children.
ChildrenProvider Func<TItem, Task<IEnumerable<TItem>?>>? null Async children loader of a lazy tree grid: a node's children load on its first expand and are cached. Use instead of ChildrenSelector, with HasChildrenSelector.
ChildrenSelector Func<TItem, IEnumerable<TItem>?>? null Child selector that turns the grid into a tree grid.
Classes BitDataGridClassStyles? null Custom CSS classes for the parts of the grid.
ClearFiltersIcon BitIconInfo? null The icon of the Clear filters button from an external icon library, shown beside its text or alone with ToolbarIconOnly. Takes precedence over ClearFiltersIconName.
ClearFiltersIconName string? null The name of the icon of the Clear filters button from the Fluent UI icon set of Bit.BlazorUI.Icons, e.g. BitIconName.FilterSolid.
ClipboardCopy bool false Enables Ctrl/⌘+C on a focused cell (with CellNavigation) and CopyToClipboardAsync, copying the selected or focused rows as tab-separated text with a header.
ColumnChooserIcon BitIconInfo? null The icon of the Columns button from an external icon library, shown beside its text or alone with ToolbarIconOnly. Takes precedence over ColumnChooserIconName.
ColumnChooserIconName string? null The name of the icon of the Columns button from the Fluent UI icon set of Bit.BlazorUI.Icons, e.g. BitIconName.TripleColumn.
Columns RenderFragment? null Alias of ChildContent for the column definitions (<Columns>...</Columns>).
CsvExportIcon BitIconInfo? null The icon of the CSV export button from an external icon library, shown beside its text or alone with ToolbarIconOnly. Takes precedence over CsvExportIconName.
CsvExportIconName string? null The name of the icon of the CSV export button from the Fluent UI icon set of Bit.BlazorUI.Icons, e.g. BitIconName.Download.
DetailTemplate RenderFragment<TItem>? null Expandable master-detail content rendered under a row.
Editable bool false Enables inline editing with a command column.
EditMode BitDataGridEditMode BitDataGridEditMode.Row Row edits the whole row with Save/Cancel; Cell edits one cell at a time (Enter, F2, double-click or typing opens; Enter, Tab or blur commits; Escape cancels).
EmptyTemplate RenderFragment? null Custom content rendered when there is no data.
ExcelExportIcon BitIconInfo? null The icon of the Excel export button from an external icon library, shown beside its text or alone with ToolbarIconOnly. Takes precedence over ExcelExportIconName.
ExcelExportIconName string? null The name of the icon of the Excel export button from the Fluent UI icon set of Bit.BlazorUI.Icons, e.g. BitIconName.ExcelLogo.
ExcelExportStyled bool false Excel exports also carry the grid's rendered theme (colors, striping, borders, fonts), read from the DOM; plain styling without JS.
ExpandDetailOnRowClick bool false Toggles a row's detail when the row is clicked (selecting it too with SelectionMode). Clicks on the grid's own cells or on a control in a cell are excluded.
ExpandedDetailItems IReadOnlyList<TItem>? null The rows whose detail is expanded (two-way bindable).
ExpandedDetailItemsChanged EventCallback<IReadOnlyList<TItem>> Raised when the expanded detail rows change.
ExportFileName string? null Base name of the export files, e.g. "orders" for orders.csv. Defaults to "export".
Filterable bool false Renders a per-column filter row. A tree is pruned to the matching branches; not available on a lazy tree.
FilterDebounce int 300 Delay (ms) before a text/number filter applies; 0 applies each keystroke, a negative value only Enter or blur.
FilterOperators bool false Shows an operator dropdown next to the text/number/date filters (contains, starts with, =, ≠, >, <, is blank, is any of, ...).
Groupable bool false Enables grouping via a header button on groupable columns.
GroupsInitiallyCollapsed bool false Groups start collapsed instead of expanded.
HasChildrenSelector Func<TItem, bool>? null Whether an unloaded lazy node can have children, so it renders an expand toggle. ChildrenProvider and OnLoadChildren only.
Height string? null Height of the scroll viewport, e.g. "480px". Required for virtualization and infinite scrolling.
Hoverable bool true Highlights the row under the pointer.
IsRowSelectionDisabled Func<TItem, bool>? null Returns true for the rows that may not be selected.
Items IEnumerable<TItem>? null The client-side data source. An IQueryable<T> (e.g. an EF Core DbSet) has its filtering, sorting and paging executed at the source.
KeyField Func<TItem, object>? null Key selector for selection/edit identity. Defaults to reference equality.
Loading bool false Shows a loading row (LoadingTemplate, or a spinner) in place of the rows and marks the grid aria-busy. A server grid (OnRead) needs it for neither: it marks itself aria-busy while it reads, and shows the loading row while it has no rows to show yet.
LoadingTemplate RenderFragment? null Custom content replacing the spinner while Loading, and while a server grid reads its first rows.
LoadMoreBatchSize int 50 Rows fetched per batch in infinite-scrolling mode.
MultiSort bool true Enables multi-column sorting via Ctrl/⌘+click.
NewItemFactory Func<TItem>? null Creates the new row of the toolbar Add button.
OnCellClick EventCallback<BitDataGridCellEventArgs<TItem>> Raised when a data cell is clicked; not on a control in it (see OnRowClick).
OnCellContextMenu EventCallback<BitDataGridCellEventArgs<TItem>> Raised when a data cell is right-clicked, suppressing the browser's menu; not on a control in it.
OnCellDoubleClick EventCallback<BitDataGridCellEventArgs<TItem>> Raised when a data cell is double-clicked; not on a control in it.
OnDetailToggle EventCallback<BitDataGridDetailEventArgs<TItem>> Raised when a row's detail is expanded or collapsed.
OnFilterChange EventCallback<IReadOnlyList<BitDataGridFilterDescriptor>> Raised with the new filters whenever the filtering changes.
OnGroupChange EventCallback<IReadOnlyList<BitDataGridGroupDescriptor>> Raised with the new groups whenever the grouping changes.
OnLoadChildren Func<BitDataGridChildrenRequest<TItem>, Task<IEnumerable<TItem>?>>? null ChildrenProvider with a cancellation token, cancelled once the grid no longer needs the children (new Items, or the grid is disposed). Use only one of ChildrenSelector, ChildrenProvider and OnLoadChildren.
OnLoadMore Func<BitDataGridReadRequest, Task<BitDataGridReadResult<TItem>>>? null Infinite-scrolling callback, appending a batch as the user scrolls to the end. Exports request all rows with Take = null, so honor a null Take.
OnPageChange EventCallback<int> Raised with the new 1-based page when the page or the page size changes.
OnRead Func<BitDataGridReadRequest, Task<BitDataGridReadResult<TItem>>>? null Server-side data callback; the grid delegates sort/filter/page/group to it.
OnReadError EventCallback<Exception> Raised with what OnRead threw reading the rows the grid shows. Setting it makes the grid handle the failure: an error row with a Retry button in place of the rows. Without it the exception propagates. A failed export never raises it.
OnRowCancel EventCallback<TItem> Raised when an edit is cancelled.
OnRowClick EventCallback<TItem> Raised when a row is clicked. A click on a control in a cell (a button, link, field, ARIA widget, focusable or data-bit-interactive element, or anything in a dialog or grid in the cell) raises neither this nor OnCellClick, and selects or expands nothing. data-bit-interactive="false" opts a control out.
OnRowCreate EventCallback<TItem> Raised when a new row is created.
OnRowDelete EventCallback<TItem> Raised when a row is deleted (Delete button or Delete key).
OnRowDoubleClick EventCallback<TItem> Raised when a row is double-clicked, e.g. to open the record or BeginEdit; not on a control in a cell.
OnRowReorder EventCallback<BitDataGridRowReorderEventArgs<TItem>> Raised when a row is dropped onto another row.
OnRowSave EventCallback<TItem> Raised when an edited row is saved.
OnSortChange EventCallback<IReadOnlyList<BitDataGridSortDescriptor>> Raised with the new sorts whenever the sorting changes.
OnStateChange EventCallback<BitDataGridState> Raised with a GetState snapshot after any state it captures changes (sorts, filters, search, groups, page, column layout), for persisting the view. Not raised by ApplyStateAsync.
OnViewChange EventCallback<IReadOnlyList<TItem>> Raised with the rows of the view across every page (see GetViewItems) when the search, filters, sorts or Items change them, to keep a chart or a map in step. Rows are matched by KeyField. List, tree and IQueryable sources only; use GetViewItemsAsync in server/infinite modes.
Pageable bool false Enables paging with a pager UI.
PagerPlacement BitPlacement BitPlacement.Bottom Where the pager renders: Top, Bottom or TopAndBottom.
PageSize int 20 The number of rows per page.
PageSizeOptions int[] { 10, 20, 50, 100 } The page sizes offered in the pager.
Reorderable bool false Lets the columns be reordered by dragging a header, Ctrl+Left/Right, or the column chooser.
Resizable bool false Lets the columns be resized by dragging a header's edge, double-clicking it (fit), or with the keyboard on it.
RowClass Func<TItem, string?>? null Per-row CSS class selector, appended after the grid's own row classes.
RowHeight float 36 Uniform row height in px (required when virtualizing).
RowHeightSelector Func<TItem, float>? null Per-row height selector (ignored while virtualizing).
RowReorderable bool false Enables drag-and-drop row reordering (pointer, or the drag handle's arrow keys).
RowStyle Func<TItem, string?>? null Per-row inline style selector.
SearchDebounce int 300 Delay (ms) after the last keystroke before the search applies; 0 applies each keystroke.
SearchText string? null The quick-search term (two-way bindable).
SearchTextChanged EventCallback<string?> Raised when the quick-search term changes.
SelectedItems IReadOnlyList<TItem>? null The selected items (two-way bindable).
SelectedItemsChanged EventCallback<IReadOnlyList<TItem>> Raised when the selection changes.
SelectionMode BitSelectionMode BitSelectionMode.None None, Single (a row click or Space; turns CellNavigation on) or Multiple (a checkbox column).
ShowCellTooltips bool false Gives each value cell a native tooltip with its full text. Overridable per column (ShowTooltip); Template cells are excluded.
ShowColumnChooser bool false Renders the column chooser button, to show, hide and (with Reorderable) move columns.
ShowCsvExport bool false Renders a CSV export button, exporting all matching rows in every data mode.
ShowDetailToggle bool true Renders the expand/collapse column while a DetailTemplate is set. Turn it off to drive the details from row clicks or code.
ShowExcelExport bool false Renders an Excel (.xlsx) export button. Built in-process, exporting all matching rows with the grid's layout (frozen header and columns, widths, merged ColSpan cells).
ShowFooter bool false Renders the footer/aggregate row.
ShowHeader bool true Renders the header rows (titles, header groups and the filter row).
ShowRowNumbers bool false Renders a leading gutter numbering the rows by their position in the whole dataset, across pages and batches. Never exported or copied.
ShowSearchBox bool false Renders a toolbar quick-search box filtering the rows across every searchable column, ignoring case. Sent as BitDataGridReadRequest.Search in server/infinite modes; not available on a lazy tree (ChildrenProvider, OnLoadChildren).
ShowToolbar bool false Renders the toolbar with its Clear filters button. Search, export, the column chooser, Add and ToolbarTemplate show it on their own.
Sortable bool true Enables column sorting by clicking headers.
Strings BitDataGridStrings new() All user-visible strings; assign a customized instance to localize.
Striped bool true Renders alternate-row striping.
Styles BitDataGridClassStyles? null Custom CSS styles for the parts of the grid.
ToolbarIconOnly bool false Renders the toolbar's buttons (Add row, Clear filters, the exports, Columns) as icons alone; each one's localized text stays its accessible name and is shown in a tooltip on hover, focus and touch. A button given no icon draws a built-in one (Add, ClearFilter, TextDocument, ExcelDocument, ColumnOptions) that needs no icon package.
ToolbarTemplate RenderFragment? null Custom content at the toolbar's start.
TreeInitiallyExpanded bool false Whether the tree nodes start expanded. Ignored in lazy mode.
Virtualize bool false Renders only the visible rows. Requires Height and RowHeight; server mode without paging fetches the rows as they scroll in. A grouped view is virtualized too, its group rows RowHeight tall on one line. Ignores RowHeightSelector, WrapCellText and the height of expanded detail rows.
VirtualizeColumns bool false Renders only the columns near the horizontal viewport. Requires px column widths; not applied with header groups or ColSpans.
WrapCellText bool false Wraps long headers and values onto several lines instead of clipping them. Overridable per column (WrapText); ignored while virtualizing.

BitDataGrid public members

Name Type Default value Description
RefreshAsync Task Recomputes the view (filter, sort, group, page) and re-renders.
SortByAsync Task SortByAsync(columnId, direction, additive) - sorts by a column; BitDataGridSortDirection.None removes the sort.
ClearSortsAsync Task Removes all the sorts.
ApplyFilterAsync Task ApplyFilterAsync(columnId, operator, value) - applies a filter, replacing the column's existing one.
ApplyRangeFilterAsync Task ApplyRangeFilterAsync(columnId, from, toExclusive) - applies a half-open range filter (>= from AND < toExclusive) as two comparison filters.
ClearFilterAsync Task ClearFilterAsync(columnId) - removes a column's filters.
ClearFiltersAsync Task Removes all the column filters.
GroupByAsync Task GroupByAsync(columnId) - adds the column as the next grouping level.
UngroupAsync Task UngroupAsync(columnId) - removes the column's grouping level.
ClearGroupsAsync Task Removes all the groupings.
ExpandAllGroupsAsync Task Expands every group, including the ones built later.
CollapseAllGroupsAsync Task Collapses every group, including the ones built later.
SearchAsync Task SearchAsync(text) - applies the quick-search term (null clears it) and goes to the first page.
ActiveSearch string? null The active quick-search term, or null.
SelectAllAsync Task Selects every selectable row of the view (only the loaded ones in server, queryable and infinite modes). Multiple mode only.
ClearSelectionAsync Task Clears the row selection.
CopyToClipboardAsync Task<int> CopyToClipboardAsync() / CopyToClipboardAsync(fallbackRow) - copies the selected rows (or the fallback row) as tab-separated text and returns how many were copied; 0 without a clipboard.
AutoFitColumnAsync Task AutoFitColumnAsync(columnId) - sizes a column to its widest content.
AutoFitAllColumnsAsync Task Auto-fits every visible column.
GoToPageAsync Task GoToPageAsync(page) - goes to a 1-based page (clamped).
MoveColumnAsync Task MoveColumnAsync(columnId, index) - moves a column to a 0-based position among all the columns.
SetPageSizeAsync Task SetPageSizeAsync(size) - changes the page size and goes to the first page.
GetViewItems IReadOnlyList<TItem> The rows of the view across every page, in display order. Server/infinite modes return only the loaded rows; use GetViewItemsAsync there.
GetViewItemsAsync Task<IReadOnlyList<TItem>> GetViewItemsAsync(cancellationToken) - the rows of the view across every page in every mode; server/infinite modes read them with an unpaged request (Take = null).
RevealItemAsync Task<bool> RevealItemAsync(item) - pages to, expands to and scrolls to a row of the view; false when the row is not in it.
GetState BitDataGridState Captures the user-adjustable state (page, search, sorts, filters, groups, column layout) as a serializable snapshot.
ApplyStateAsync Task ApplyStateAsync(state) - restores a GetState snapshot.
ExportCsvAsync Task ExportCsvAsync(selectedOnly) - downloads all the matching rows (or the selected ones) as CSV, in every data mode.
ToCsv string ToCsv(selectedOnly) - builds the CSV synchronously; server/infinite modes cover only the loaded rows (use ToCsvAsync).
ToCsvAsync Task<string> ToCsvAsync(selectedOnly) - builds the CSV of all the matching (or selected) rows in every mode.
ToExcelAsync Task<byte[]> ToExcelAsync(selectedOnly) - builds an .xlsx of all the matching (or selected) rows with native cell types and the grid's layout (and theme, with ExcelExportStyled).
ExportExcelAsync Task ExportExcelAsync(selectedOnly) - builds the .xlsx and downloads it.
ActiveSorts IReadOnlyList<BitDataGridSortDescriptor> [] The active sorts, in priority order.
ActiveFilters IReadOnlyList<BitDataGridFilterDescriptor> [] The active filters.
ActiveGroups IReadOnlyList<BitDataGridGroupDescriptor> [] The active groups, in nesting order.
TotalCount int 0 The rows of the filtered view; the server's total in server mode.
TotalPages int 1 The number of pages while paging.
CurrentPage int 1 The 1-based current page.
ExpandAllAsync Task Expands every tree node (tree mode only).
CollapseAllAsync Task Collapses every tree node (tree mode only).
IsDetailExpanded bool IsDetailExpanded(item) - whether the row's detail is expanded.
ExpandDetailAsync Task ExpandDetailAsync(item) - expands the row's detail.
CollapseDetailAsync Task CollapseDetailAsync(item) - collapses the row's detail.
ToggleDetailAsync Task ToggleDetailAsync(item) - toggles the row's detail.
SetDetailExpandedAsync Task SetDetailExpandedAsync(item, expanded) - expands or collapses the row's detail.
ExpandAllDetailsAsync Task Expands the detail of every row of the view (only the loaded rows in server, queryable and infinite modes).
CollapseAllDetailsAsync Task Collapses every expanded detail.
EditingItem TItem? null The row being edited, or null.
EditingColumnId string? null The column of the cell being edited in Cell mode, or null.
BeginEditAsync Task BeginEditAsync(item, columnId) - opens an edit at a cell and focuses its editor.
BeginEdit void BeginEdit(item) - puts a row into edit mode, as its Edit button does.
CommitEditAsync Task Saves the open edit and raises OnRowSave; refused while a value is invalid.
CancelEditAsync Task Abandons the open edit, restoring the row, and raises OnRowCancel.
AddNewRowAsync Task Adds a row from NewItemFactory and opens it for editing, as the toolbar Add button does.
DeleteRowAsync Task DeleteRowAsync(item) - deselects the row and raises OnRowDelete for the caller to remove it.

BitComponentBase parameters

Name Type Default value Description
AriaLabel string? null Gets or sets the accessible label for the component, used by assistive technologies.
Class string? null Gets or sets the CSS class name(s) to apply to the rendered element.
Dir BitDir? null Gets or sets the text directionality for the component's content.
Disabled bool false Gets or sets a value indicating whether the component is disabled and cannot respond to user interaction.
ForceAnimation bool false Gets or sets a value indicating whether the component's animations play at their full duration even when reduced motion is requested.
HtmlAttributes Dictionary<string, object> new Dictionary<string, object>() Captures additional HTML attributes to be applied to the rendered element, in addition to the component's parameters. An attribute written on the component wins over an entry of the same name.
Id string? null Gets or sets the unique identifier for the component's root element.
Style string? null Gets or sets the CSS style string to apply to the rendered element.
TabIndex string? null Gets or sets the tab order index for the component when navigating with the keyboard.
Visibility BitVisibility BitVisibility.Visible Gets or sets the visibility state (visible, hidden, or collapsed) of the component.

BitComponentBase public members

Name Type Default value Description
UniqueId Guid Guid.NewGuid() Gets the readonly unique identifier for the component's root element, assigned when the component instance is constructed.
RootElement ElementReference Gets the reference to the root HTML element associated with this component.

BitDataGridClassStyles properties

Defines per-part CSS class/style values for BitDataGrid.

Name Type Default value Description
Root string? null Custom class or style of the root element.
Toolbar string? null Custom class or style of the toolbar.
ColumnChooser string? null Custom class or style of the column chooser.
Viewport string? null Custom class or style of the scrolling viewport.
HeaderRow string? null Custom class or style of the column titles row.
HeaderCell string? null Custom class or style of each header cell, before the column's HeaderClass.
FilterRow string? null Custom class or style of the filter row.
Row string? null Custom class or style of each data row, before RowClass/RowStyle.
SelectedRow string? null Custom class or style of each selected row, after Row.
Cell string? null Custom class or style of each data cell, before the column's CellClass.
GroupRow string? null Custom class or style of each group header cell.
DetailRow string? null Custom class or style of each detail row's content.
FooterRow string? null Custom class or style of the footer row.
Pager string? null Custom class or style of the pager.
Empty string? null Custom class or style of the empty message cell.
Loading string? null Custom class or style of the loading indicator cell.
ReadError string? null Custom class or style of the cell showing a failed read and its Retry button.

BitDataGridColumn properties

A column of a BitDataGrid, placed in its child content.

Name Type Default value Description
Field string? null Name of the bound property; supports nested paths ("Address.City"). Prefer Property.
Property Expression<Func<TItem, object?>>? null Typed selector of the bound property, e.g. p => p.Address.City. Refactor-safe; takes precedence over Field.
ColumnId string? null Stable column identifier. Defaults to the Property/Field path.
Title string? null Header text. Defaults to the humanized Property/Field name.
Width string? null CSS width, e.g. "120px" or "20%"; null shares the remaining space.
MinWidth int 60 Minimum resize width in px.
MaxWidth int? null Maximum resize width in px.
Sortable bool? null Overrides the grid's Sortable. A template-only column sorts only through SortBy (in-memory sources) or ServerSortable (server/infinite modes).
SortBy Func<TItem, object?>? null Custom sort key, making a template-only column sortable; in-memory sources only.
ServerSortable bool false Lets a template-only column sort in server/infinite modes, sending its ColumnId (required) in the request.
SortDescendingFirst bool false The first header click sorts descending.
AllowUnsorted bool? null Overrides the grid's AllowUnsorted.
Comparer IComparer<object?>? null Custom comparer of the column's sort keys; client-side only.
Validate Func<TItem, object?, string?>? null Inline-edit validator: returns an error message to reject the value, or null to accept it.
Filterable bool? null Overrides the grid's Filterable.
FilterOperators bool? null Overrides the grid's FilterOperators.
FilterTemplate RenderFragment<BitDataGridFilterContext>? null Custom filter editor; its context carries the filter and ApplyAsync/ApplyRangeAsync/ClearAsync.
Resizable bool? null Overrides the grid's Resizable.
Reorderable bool? null Overrides the grid's Reorderable.
Editable bool? null Overrides the grid's Editable.
Groupable bool? null Overrides the grid's Groupable.
Searchable bool? null Whether the quick search covers the column. Defaults to the bound (or ExportValue) columns.
Exportable bool? null Whether exports include the column. Defaults to the columns with a value (a bound field or ExportValue).
ExportValue Func<TItem, object?>? null The value exports and the clipboard use instead of the bound field.
ShowTooltip bool? null Overrides the grid's ShowCellTooltips.
WrapText bool? null Overrides the grid's WrapCellText.
Frozen bool false Pins the column to the start edge while scrolling horizontally.
FrozenEnd bool false Pins the column to the end edge.
Group string? null Header group name; consecutive columns sharing it render under one spanning header.
ColSpan Func<TItem, int?>? null Per-row column span.
Visible bool true Whether the column is visible.
RowHeader bool false Makes the cells the headers of their rows (role rowheader), naming the row for screen readers.
Align BitTextAlign BitTextAlign.Start Horizontal alignment of the cells: Start, Center, End, Left or Right; any other value is Start.
Format string? null A .NET format string, e.g. "C2" or "yyyy-MM-dd".
ValueText Func<object, string?>? null The text a value is shown as (e.g. a translated enum name) in the cells, tooltips, group headers, Min/Max aggregates, enum and boolean filter and editor options, and what the in-memory quick search and text filters match; null keeps the default. Display only: exports keep the value itself (use ExportValue for other text). An enum member otherwise shows its [Display] name, unless a Format is set.
DataType BitDataGridColumnDataType BitDataGridColumnDataType.Auto The data type picking the editor and filter.
Aggregate BitDataGridAggregateType BitDataGridAggregateType.None The footer/group aggregate function.
AggregateBy Func<IReadOnlyList<TItem>, object?>? null Custom aggregate function (e.g. a distinct count); takes precedence over Aggregate.
AggregateFormat string? null Format of the aggregate value; falls back to Format.
HeaderClass string? null CSS class of the header cell.
CellClass string? null CSS class of each data cell.
CellClassSelector Func<TItem, string?>? null Per-row CSS class of the cells, after CellClass.
CellStyleSelector Func<TItem, string?>? null Per-row inline style of the cells. Prefer color/font to background, which hides selection and hover.
Template RenderFragment<TItem>? null Custom data cell content.
HeaderTemplate RenderFragment? null Custom header cell content.
EditTemplate RenderFragment<TItem>? null Custom editor in edit mode.
FooterTemplate RenderFragment<BitDataGridAggregateResult>? null Custom footer/aggregate cell content.

BitDataGridReadRequest properties

What the grid asks of OnRead/OnLoadMore.

Name Type Default value Description
Skip int 0 Zero-based number of items to skip.
Take int? null Maximum number of items to return; null means all.
Sorts IReadOnlyList<BitDataGridSortDescriptor> [] The active sorts, by priority.
Filters IReadOnlyList<BitDataGridFilterDescriptor> [] The active filters.
Groups IReadOnlyList<BitDataGridGroupDescriptor> [] The active groups, in nesting order.
Search string? null The quick-search term to match across the searchable columns, or null.
Aggregates IReadOnlyList<BitDataGridAggregateDescriptor> [] The aggregates the footer shows, one per aggregating column: compute them over the whole filtered data and return them in the result's Aggregates. Empty for OnLoadMore and export reads.
CancellationToken CancellationToken Cancelled when a newer request supersedes this one.

BitDataGridReadResult<TItem> properties

The result of OnRead/OnLoadMore.

Name Type Default value Description
Items IReadOnlyList<TItem> The items of the current page/window.
TotalCount int The total of the matching items (ignored in infinite mode).
Aggregates IReadOnlyList<BitDataGridAggregateResult>? null Aggregates over the whole filtered data, shown in the footer instead of the page's own.

BitDataGridChildrenRequest<TItem> properties

What a lazy tree grid asks of OnLoadChildren.

Name Type Default value Description
Parent TItem The node whose direct children are requested.
CancellationToken CancellationToken Cancelled once the grid no longer needs the children: new Items replaced the hierarchy, or the grid is disposed. Collapsing the node does not cancel it.

BitDataGridCellEventArgs<TItem> properties

Arguments of the cell events.

Name Type Default value Description
Item TItem The row item.
Column BitDataGridColumn<TItem> The cell's column.
ColumnId string The column's identifier.
ColumnTitle string The column's title.
Value object? null The cell's raw value.
Mouse MouseEventArgs The browser mouse event.

BitDataGridDetailEventArgs<TItem> properties

Arguments of a row's detail toggle.

Name Type Default value Description
Item TItem The toggled row.
Expanded bool Whether the detail was expanded.

BitDataGridRowReorderEventArgs<TItem> properties

Arguments of a row drop.

Name Type Default value Description
DraggedItem TItem The dragged row.
TargetItem TItem The drop-target row.
FromIndex int? The original index, or null when Items is not an indexable list.
ToIndex int? The destination index, or null when Items is not an indexable list.

BitDataGridSortDescriptor properties

A column's sort (in BitDataGridReadRequest.Sorts).

Name Type Default value Description
ColumnId string The sorted column's identifier.
Direction BitDataGridSortDirection BitDataGridSortDirection.Ascending The sort direction.
Priority int int.MaxValue Multi-sort priority (1 = primary).

BitDataGridFilterDescriptor properties

A column's filter (in BitDataGridReadRequest.Filters).

Name Type Default value Description
ColumnId string The filtered column's identifier.
Operator BitDataGridFilterOperator BitDataGridFilterOperator.Unspecified The comparison operator; Unspecified applies no filter.
Value object? null The operand; a collection for In/NotIn.

BitDataGridFilterContext properties

The context of a column's FilterTemplate: its filter and the calls that change it.

Name Type Default value Description
ColumnId string The filtered column's identifier.
Title string The column's header text.
Label string The editor's accessible name ("Filter by {Title}").
ValueType Type? null The bound member's type, Nullable<T> unwrapped.
Disabled bool Whether the grid is disabled.
Filters IReadOnlyList<BitDataGridFilterDescriptor> The column's filters: none, one, or a range's two halves.
IsActive bool Whether the column is filtered.
Operator BitDataGridFilterOperator The first filter's operator, or Unspecified.
Value object? The first filter's value, or null.
ApplyAsync Task (BitDataGridFilterOperator, object?) Replaces the filter; an empty value clears it.
ApplyRangeAsync Task (object?, object?) Replaces the filter with a half-open range (>= from AND < toExclusive).
ClearAsync Task () Removes the filter.

BitDataGridGroupDescriptor properties

A column's grouping.

Name Type Default value Description
ColumnId string The grouped column's identifier.
Direction BitDataGridSortDirection BitDataGridSortDirection.Ascending The sort direction of the group keys.

BitDataGridAggregateDescriptor properties

An aggregate the footer shows (in BitDataGridReadRequest.Aggregates).

Name Type Default value Description
ColumnId string The aggregating column's identifier.
Type BitDataGridAggregateType The column's aggregate function; Custom for a column with its own AggregateBy, which the server computes its own way.

BitDataGridAggregateResult properties

A computed footer or group aggregate (passed to FooterTemplate).

Name Type Default value Description
ColumnId string The aggregated column's identifier.
Type BitDataGridAggregateType The aggregate function.
Value object? null The raw value.
FormattedValue string string.Empty The value formatted with AggregateFormat/Format.

BitDataGridState properties

A serializable snapshot of the user-adjustable state, from GetState() for ApplyStateAsync().

Name Type Default value Description
CurrentPage int 1 The 1-based current page.
PageSize int? null The user-chosen page size, or null for the PageSize parameter.
Search string? null The quick-search term, or null.
Sorts List<BitDataGridSortDescriptor> [] The active sorts.
Filters List<BitDataGridFilterDescriptor> [] The active filters.
Groups List<BitDataGridGroupDescriptor> [] The active groups.
GroupsCollapsed bool false Whether the groups were collapsed by default.
GroupExpansionOverrides List<string> [] The paths of the groups whose expansion differs from GroupsCollapsed. Tree expansion is not captured.
Columns List<BitDataGridColumnState> [] The column layout.

BitDataGridColumnState properties

A column's layout in BitDataGridState.Columns.

Name Type Default value Description
ColumnId string string.Empty The column's identifier.
Visible bool true Whether the column is shown.
Width double? null The resized width in px, or null.
Order int 0 The display position among all the columns.

BitDataGridStrings properties

All the user-visible and screen-reader strings of the grid, in English by default; assign a customized instance to Strings to localize.

Name Type Default value Description
GridLabel string "Data grid" The grid's accessible name when no AriaLabel is given.
EmptyText string BitStrings.NoItemsFound Shown when there are no rows; "No items found" unless BitStrings.Current says otherwise.
NoMatchesText string BitStrings.NoResultsFound Shown instead of EmptyText when the filters or the search exclude every row; "No results found" unless BitStrings.Current says otherwise.
LoadingText string "Loading…" Shown while Loading is true, and while a server grid reads its first rows.
ReadErrorText string "The records could not be loaded." Shown in place of the rows when a read fails and OnReadError is set.
RetryText string "Retry" The button that reads the rows again after a failed read.
PagerRangeFormat string "{0}–{1} of {2}" Pager range summary format.
PagerPageFormat string "Page {0} of {1}" Pager page summary format.
InvalidValueError string "Invalid value for {0}." Shown when an edited value can't be converted.
SearchPlaceholder string "Search…" The quick-search placeholder.
… string Plus 86 more: button texts, labels, placeholders, operator and option texts, tooltips, aggregate formats and live announcements.

BitTextAlign enum

Name Value Description
Start 0 The leading edge, whatever the text direction.
End 1 The trailing edge, whatever the text direction.
Left 2 The left edge, whatever the text direction.
Right 3 The right edge, whatever the text direction.
Center 4 Centers the lines.
Justify 5 Lines up both edges of every line but the last.
JustifyAll 6 Justifies the last line too. Not implemented by browsers yet.
MatchParent 7 Inherits, resolving start/end against the parent's direction.
Inherit 8 Takes the parent's alignment.
Initial 9 Takes the initial value.
Revert 10 Reverts to the user agent or user stylesheet value.
RevertLayer 11 Reverts to the previous cascade layer's value.
Unset 12 Inherits, or takes the initial value where not inherited.

BitDataGridSortDirection enum

Name Value Description
None 0 Not sorted. SortByAsync removes the sort with it; a group keeps its keys in first-met order.
Ascending 1 Smallest to largest.
Descending 2 Largest to smallest.

BitDataGridEditMode enum

Name Value Description
Row 0 The whole row, with Save/Cancel.
Cell 1 One cell at a time; Enter, Tab or blur commits, Escape cancels.

BitSelectionMode enum

Name Value Description
None 0 Nothing can be selected: the items act as plain content or as plain action buttons.
Single 1 At most one item can be selected at a time, so selecting one clears the one before it.
Multiple 2 Any number of items can be selected at the same time.

BitDataGridAggregateType enum

Name Value Description
None 0 No aggregate, unless the column has an AggregateBy.
Sum 1 The total of the numeric values.
Average 2 The mean of the numeric values, or 0.
Count 3 The number of rows.
Min 4 The smallest non-null value.
Max 5 The largest non-null value.
Custom 6 Produced by the column's AggregateBy.

BitPlacement enum

Name Value Description
Top 0 The top edge.
Bottom 1 The bottom edge.
Start 2 The edge the reading direction starts from - the left in LTR, the right in RTL. On the vertical axis, which does not turn around, it is the top.
End 3 The edge the reading direction ends at - the right in LTR, the left in RTL. On the vertical axis, which does not turn around, it is the bottom.
Left 4 The left edge, in both reading directions.
Right 5 The right edge, in both reading directions.
Center 6 The middle of the axis, against neither edge.
TopAndBottom 7 Both edges of the block axis at once.
StartAndEnd 8 Both edges of the inline axis at once, following the reading direction the way Start and End do.

BitDataGridColumnDataType enum

Name Value Description
Auto 0 Inferred from the property type (bool, enum, date, numeric; otherwise Text).
Text 1 A text box with the text operators.
Number 2 A numeric text box with the comparison operators.
Boolean 3 A true/false dropdown.
Date 4 A date picker, without a time of day.
DateTime 5 A date picker; equality matches the whole day.
DateTimeOffset 6 A date picker; equality matches the whole day.
Enum 7 A dropdown of the enum's names.

BitDataGridFilterOperator enum

Name Value Description
Unspecified 0 No operator; the filter is ignored.
Contains 1 The text contains the term, ignoring case.
DoesNotContain 2 The text does not contain the term, ignoring case.
StartsWith 3 The text starts with the term, ignoring case.
EndsWith 4 The text ends with the term, ignoring case.
Equals 5 Equals the operand; a null operand matches nulls.
NotEquals 6 Does not equal the operand.
GreaterThan 7 Greater than the operand; nulls never match.
GreaterThanOrEqual 8 Greater than or equal to the operand; nulls never match.
LessThan 9 Less than the operand; nulls never match.
LessThanOrEqual 10 Less than or equal to the operand; nulls never match.
IsEmpty 11 Null or empty text; takes no operand.
IsNotEmpty 12 Neither null nor empty text; takes no operand.
In 13 Equals a member of the Value collection.
NotIn 14 Equals no member of the Value collection.

BitVisibility enum

Name Value Description
Visible 0 The content of the component is visible.
Hidden 1 The content of the component is hidden, but the space it takes on the page remains (visibility:hidden).
Collapsed 2 The component is hidden (display:none).

BitDir enum

Name Value Description
Ltr 0 Ltr (left to right) is to be used for languages that are written from the left to the right (like English).
Rtl 1 Rtl (right to left) is to be used for languages that are written from the right to the left (like Arabic).
Auto 2 Auto lets the user agent decide. It uses a basic algorithm as it parses the characters inside the element until it finds a character with a strong directionality, then applies that directionality to the whole element.

Feedback

Found a mistake, a gap, or something that could be clearer? Every page and every component is one click from its source.