@tanstack/react-table 0.0.1-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/dist/react-table.development.js +3406 -0
  2. package/dist/react-table.development.js.map +1 -0
  3. package/dist/react-table.production.min.js +2 -0
  4. package/dist/react-table.production.min.js.map +1 -0
  5. package/lib/index.js +65 -0
  6. package/package.json +122 -0
  7. package/src/.DS_Store +0 -0
  8. package/src/aggregationTypes.ts +115 -0
  9. package/src/core.tsx +1194 -0
  10. package/src/createTable.tsx +181 -0
  11. package/src/features/Expanding.ts +388 -0
  12. package/src/features/Filters.ts +707 -0
  13. package/src/features/Grouping.ts +451 -0
  14. package/src/features/Headers.ts +907 -0
  15. package/src/features/Ordering.ts +134 -0
  16. package/src/features/Pinning.ts +213 -0
  17. package/src/features/Sorting.ts +487 -0
  18. package/src/features/Visibility.ts +281 -0
  19. package/src/features/notest/useAbsoluteLayout.test.js +152 -0
  20. package/src/features/notest/useBlockLayout.test.js +158 -0
  21. package/src/features/notest/useColumnOrder.test.js +186 -0
  22. package/src/features/notest/useExpanded.test.js +125 -0
  23. package/src/features/notest/useFilters.test.js +393 -0
  24. package/src/features/notest/useFiltersAndRowSelect.test.js +256 -0
  25. package/src/features/notest/useFlexLayout.test.js +152 -0
  26. package/src/features/notest/useGroupBy.test.js +259 -0
  27. package/src/features/notest/usePagination.test.js +231 -0
  28. package/src/features/notest/useResizeColumns.test.js +229 -0
  29. package/src/features/notest/useRowSelect.test.js +250 -0
  30. package/src/features/notest/useRowState.test.js +178 -0
  31. package/src/features/tests/Visibility.test.tsx +225 -0
  32. package/src/features/tests/__snapshots__/Visibility.test.tsx.snap +390 -0
  33. package/src/features/tests/withSorting.notest.tsx +341 -0
  34. package/src/features/withColumnResizing.ts +281 -0
  35. package/src/features/withPagination.ts +208 -0
  36. package/src/features/withRowSelection.ts +467 -0
  37. package/src/filterTypes.ts +251 -0
  38. package/src/index.tsx +7 -0
  39. package/src/sortTypes.ts +159 -0
  40. package/src/test-utils/makeTestData.ts +41 -0
  41. package/src/tests/__snapshots__/core.test.tsx.snap +148 -0
  42. package/src/tests/core.test.tsx +241 -0
  43. package/src/types.ts +285 -0
  44. package/src/utils/columnFilterRowsFn.ts +162 -0
  45. package/src/utils/expandRowsFn.ts +53 -0
  46. package/src/utils/globalFilterRowsFn.ts +129 -0
  47. package/src/utils/groupRowsFn.ts +196 -0
  48. package/src/utils/sortRowsFn.ts +115 -0
  49. package/src/utils.tsx +243 -0
@@ -0,0 +1,186 @@
1
+ import React from 'react'
2
+ import { render, fireEvent } from '@testing-library/react'
3
+ import { useTable } from '../../hooks/useTable'
4
+ import { useColumnOrder } from '../useColumnOrder'
5
+
6
+ const data = [
7
+ {
8
+ firstName: 'tanner',
9
+ lastName: 'linsley',
10
+ age: 29,
11
+ visits: 100,
12
+ status: 'In Relationship',
13
+ progress: 50,
14
+ },
15
+ {
16
+ firstName: 'derek',
17
+ lastName: 'perkins',
18
+ age: 40,
19
+ visits: 40,
20
+ status: 'Single',
21
+ progress: 80,
22
+ },
23
+ {
24
+ firstName: 'joe',
25
+ lastName: 'bergevin',
26
+ age: 45,
27
+ visits: 20,
28
+ status: 'Complicated',
29
+ progress: 10,
30
+ },
31
+ {
32
+ firstName: 'jaylen',
33
+ lastName: 'linsley',
34
+ age: 26,
35
+ visits: 99,
36
+ status: 'In Relationship',
37
+ progress: 70,
38
+ },
39
+ ]
40
+
41
+ function shuffle(arr, mapping) {
42
+ if (arr.length !== mapping.length) {
43
+ throw new Error()
44
+ }
45
+ arr = [...arr]
46
+ mapping = [...mapping]
47
+ const shuffled = []
48
+ while (arr.length) {
49
+ shuffled.push(arr.splice([mapping.shift()], 1)[0])
50
+ }
51
+ return shuffled
52
+ }
53
+
54
+ function Table({ columns, data }) {
55
+ const {
56
+ getTableProps,
57
+ getTableBodyProps,
58
+ headerGroups,
59
+ rows,
60
+ leafColumns,
61
+ prepareRow,
62
+ setColumnOrder,
63
+ state,
64
+ } = useTable(
65
+ {
66
+ columns,
67
+ data,
68
+ },
69
+ useColumnOrder
70
+ )
71
+
72
+ const testColumnOrder = () => {
73
+ setColumnOrder(
74
+ shuffle(
75
+ leafColumns.map(d => d.id),
76
+ [1, 4, 2, 0, 3, 5]
77
+ )
78
+ )
79
+ }
80
+
81
+ return (
82
+ <>
83
+ <button onClick={() => testColumnOrder({})}>Randomize Columns</button>
84
+ <table {...getTableProps()}>
85
+ <thead>
86
+ {headerGroups.map((headerGroup, i) => (
87
+ <tr {...headerGroup.getHeaderGroupProps()}>
88
+ {headerGroup.headers.map(column => (
89
+ <th {...column.getHeaderProps()}>{column.render('Header')}</th>
90
+ ))}
91
+ </tr>
92
+ ))}
93
+ </thead>
94
+ <tbody {...getTableBodyProps()}>
95
+ {rows.slice(0, 10).map((row, i) => {
96
+ prepareRow(row)
97
+ return (
98
+ <tr {...row.getRowProps()}>
99
+ {row.cells.map((cell, i) => {
100
+ return <td {...cell.getCellProps()}>{cell.render('Cell')}</td>
101
+ })}
102
+ </tr>
103
+ )
104
+ })}
105
+ </tbody>
106
+ </table>
107
+ <pre>
108
+ <code>{JSON.stringify(state, null, 2)}</code>
109
+ </pre>
110
+ </>
111
+ )
112
+ }
113
+
114
+ function App() {
115
+ const columns = React.useMemo(
116
+ () => [
117
+ {
118
+ Header: 'Name',
119
+ columns: [
120
+ {
121
+ Header: 'First Name',
122
+ accessor: 'firstName',
123
+ },
124
+ {
125
+ Header: 'Last Name',
126
+ accessor: 'lastName',
127
+ },
128
+ ],
129
+ },
130
+ {
131
+ Header: 'Info',
132
+ columns: [
133
+ {
134
+ Header: 'Age',
135
+ accessor: 'age',
136
+ },
137
+ {
138
+ Header: 'Visits',
139
+ accessor: 'visits',
140
+ },
141
+ {
142
+ Header: 'Status',
143
+ accessor: 'status',
144
+ },
145
+ {
146
+ Header: 'Profile Progress',
147
+ accessor: 'progress',
148
+ },
149
+ ],
150
+ },
151
+ ],
152
+ []
153
+ )
154
+
155
+ return <Table columns={columns} data={data} />
156
+ }
157
+
158
+ test('renders a column-orderable table', () => {
159
+ const rtl = render(<App />)
160
+
161
+ expect(rtl.getAllByRole('columnheader').map(d => d.textContent)).toEqual([
162
+ 'Name',
163
+ 'Info',
164
+ 'First Name',
165
+ 'Last Name',
166
+ 'Age',
167
+ 'Visits',
168
+ 'Status',
169
+ 'Profile Progress',
170
+ ])
171
+
172
+ fireEvent.click(rtl.getByText('Randomize Columns'))
173
+
174
+ expect(rtl.getAllByRole('columnheader').map(d => d.textContent)).toEqual([
175
+ 'Name',
176
+ 'Info',
177
+ 'Name',
178
+ 'Info',
179
+ 'Last Name',
180
+ 'Profile Progress',
181
+ 'Visits',
182
+ 'First Name',
183
+ 'Age',
184
+ 'Status',
185
+ ])
186
+ })
@@ -0,0 +1,125 @@
1
+ import React from 'react'
2
+ import { render, fireEvent } from '@testing-library/react'
3
+ import { useTable } from '../../hooks/useTable'
4
+ import { useExpanded } from '../useExpanded'
5
+ import makeTestData from '../../../test-utils/makeTestData'
6
+
7
+ const data = makeTestData(3, 3, 3)
8
+
9
+ function Table({ columns: userColumns, data, SubComponent }) {
10
+ const {
11
+ getTableProps,
12
+ getTableBodyProps,
13
+ headerGroups,
14
+ rows,
15
+ prepareRow,
16
+ leafColumns,
17
+ } = useTable(
18
+ {
19
+ columns: userColumns,
20
+ data,
21
+ },
22
+ useExpanded
23
+ )
24
+
25
+ return (
26
+ <>
27
+ <table {...getTableProps()}>
28
+ <thead>
29
+ {headerGroups.map(headerGroup => (
30
+ <tr {...headerGroup.getHeaderGroupProps()}>
31
+ {headerGroup.headers.map(column => (
32
+ <th {...column.getHeaderProps()}>{column.render('Header')}</th>
33
+ ))}
34
+ </tr>
35
+ ))}
36
+ </thead>
37
+ <tbody {...getTableBodyProps()}>
38
+ {rows.map((row, i) => {
39
+ prepareRow(row)
40
+ const { key, ...rowProps } = row.getRowProps()
41
+ return (
42
+ <React.Fragment key={key}>
43
+ <tr {...rowProps}>
44
+ {row.cells.map(cell => {
45
+ return (
46
+ <td {...cell.getCellProps()}>{cell.render('Cell')}</td>
47
+ )
48
+ })}
49
+ </tr>
50
+ {!row.subRows.length && row.isExpanded ? (
51
+ <tr>
52
+ <td colSpan={leafColumns.length}>
53
+ {SubComponent({ row })}
54
+ </td>
55
+ </tr>
56
+ ) : null}
57
+ </React.Fragment>
58
+ )
59
+ })}
60
+ </tbody>
61
+ </table>
62
+ </>
63
+ )
64
+ }
65
+
66
+ function App() {
67
+ const columns = React.useMemo(
68
+ () => [
69
+ {
70
+ Header: () => null,
71
+ id: 'expander',
72
+ Cell: ({ row }) => (
73
+ <span
74
+ style={{
75
+ cursor: 'pointer',
76
+ paddingLeft: `${row.depth * 2}rem`,
77
+ }}
78
+ onClick={() => row.toggleRowExpanded()}
79
+ >
80
+ {row.isExpanded ? 'Collapse' : 'Expand'} Row {row.id}
81
+ </span>
82
+ ),
83
+ },
84
+ {
85
+ Header: 'First Name',
86
+ accessor: 'name',
87
+ Cell: ({ row: { id } }) => `Row ${id}`,
88
+ },
89
+ ],
90
+ []
91
+ )
92
+
93
+ return (
94
+ <Table
95
+ columns={columns}
96
+ data={data}
97
+ SubComponent={({ row }) => <span>SubComponent: {row.id}</span>}
98
+ />
99
+ )
100
+ }
101
+
102
+ test('renders an expandable table', () => {
103
+ const rtl = render(<App />)
104
+
105
+ rtl.getByText('Row 0')
106
+
107
+ fireEvent.click(rtl.getByText('Expand Row 0'))
108
+
109
+ rtl.getByText('Row 0.0')
110
+ rtl.getByText('Row 0.1')
111
+ rtl.getByText('Row 0.2')
112
+
113
+ fireEvent.click(rtl.getByText('Expand Row 0.1'))
114
+
115
+ rtl.getByText('Row 0.1.2')
116
+
117
+ fireEvent.click(rtl.getByText('Expand Row 0.1.2'))
118
+
119
+ rtl.getByText('SubComponent: 0.1.2')
120
+
121
+ fireEvent.click(rtl.getByText('Collapse Row 0'))
122
+
123
+ expect(rtl.queryByText('SubComponent: 0.1.2')).toBe(null)
124
+ rtl.getByText('Expand Row 0')
125
+ })
@@ -0,0 +1,393 @@
1
+ import React from 'react'
2
+ import { render, fireEvent } from '../../../test-utils/react-testing'
3
+ import { useTable } from '../../hooks/useTable'
4
+ import { useFilters } from '../useFilters'
5
+ import { useGlobalFilter } from '../useGlobalFilter'
6
+
7
+ const makeData = () => [
8
+ {
9
+ firstName: 'tanner',
10
+ lastName: 'linsley',
11
+ age: 29,
12
+ visits: 100,
13
+ status: 'In Relationship',
14
+ progress: 50,
15
+ },
16
+ {
17
+ firstName: 'derek',
18
+ lastName: 'perkins',
19
+ age: 40,
20
+ visits: 40,
21
+ status: 'Single',
22
+ progress: 80,
23
+ },
24
+ {
25
+ firstName: 'joe',
26
+ lastName: 'bergevin',
27
+ age: 45,
28
+ visits: 20,
29
+ status: 'Complicated',
30
+ progress: 10,
31
+ },
32
+ {
33
+ firstName: 'jaylen',
34
+ lastName: 'linsley',
35
+ age: 26,
36
+ visits: 99,
37
+ status: 'In Relationship',
38
+ progress: 70,
39
+ },
40
+ ]
41
+
42
+ const defaultColumn = {
43
+ Cell: ({ value, column: { id } }) => `${id}: ${value}`,
44
+ Filter: ({ column: { filterValue, setFilter } }) => (
45
+ <input
46
+ value={filterValue || ''}
47
+ onChange={e => {
48
+ setFilter(e.target.value || undefined) // Set undefined to remove the filter entirely
49
+ }}
50
+ placeholder="Search..."
51
+ />
52
+ ),
53
+ }
54
+
55
+ function App(props) {
56
+ const [data, setData] = React.useState(makeData)
57
+
58
+ const columns = React.useMemo(() => {
59
+ if (props.columns) {
60
+ return props.columns
61
+ }
62
+ return [
63
+ {
64
+ Header: 'Name',
65
+ columns: [
66
+ {
67
+ Header: 'First Name',
68
+ accessor: 'firstName',
69
+ },
70
+ {
71
+ Header: 'Last Name',
72
+ accessor: 'lastName',
73
+ },
74
+ ],
75
+ },
76
+ {
77
+ Header: 'Info',
78
+ columns: [
79
+ {
80
+ Header: 'Age',
81
+ accessor: 'age',
82
+ },
83
+ {
84
+ Header: 'Visits',
85
+ accessor: 'visits',
86
+ },
87
+ {
88
+ Header: 'Status',
89
+ accessor: 'status',
90
+ },
91
+ {
92
+ Header: 'Profile Progress',
93
+ accessor: 'progress',
94
+ },
95
+ ],
96
+ },
97
+ ]
98
+ }, [props.columns])
99
+
100
+ const {
101
+ getTableProps,
102
+ getTableBodyProps,
103
+ headerGroups,
104
+ rows,
105
+ prepareRow,
106
+ leafColumns,
107
+ state,
108
+ setGlobalFilter,
109
+ } = useTable(
110
+ {
111
+ columns,
112
+ data,
113
+ defaultColumn,
114
+ },
115
+ useFilters,
116
+ useGlobalFilter
117
+ )
118
+
119
+ const reset = () => setData(makeData())
120
+
121
+ return (
122
+ <>
123
+ <button onClick={reset}>Reset Data</button>
124
+ <table {...getTableProps()}>
125
+ <thead>
126
+ {headerGroups.map(headerGroup => (
127
+ <tr {...headerGroup.getHeaderGroupProps()}>
128
+ {headerGroup.headers.map(column => (
129
+ <th {...column.getHeaderProps()}>
130
+ {column.render('Header')}
131
+ {column.canFilter ? column.render('Filter') : null}
132
+ </th>
133
+ ))}
134
+ </tr>
135
+ ))}
136
+ <tr>
137
+ <th
138
+ colSpan={leafColumns.length}
139
+ style={{
140
+ textAlign: 'left',
141
+ }}
142
+ >
143
+ <span>
144
+ <input
145
+ value={state.globalFilter || ''}
146
+ onChange={e => {
147
+ setGlobalFilter(e.target.value || undefined) // Set undefined to remove the filter entirely
148
+ }}
149
+ placeholder={`Global search...`}
150
+ style={{
151
+ fontSize: '1.1rem',
152
+ border: '0',
153
+ }}
154
+ />
155
+ </span>
156
+ </th>
157
+ </tr>
158
+ </thead>
159
+ <tbody {...getTableBodyProps()}>
160
+ {rows.map(
161
+ (row, i) =>
162
+ prepareRow(row) || (
163
+ <tr {...row.getRowProps()}>
164
+ {row.cells.map(cell => (
165
+ <td {...cell.getCellProps()}>{cell.render('Cell')}</td>
166
+ ))}
167
+ </tr>
168
+ )
169
+ )}
170
+ </tbody>
171
+ </table>
172
+ </>
173
+ )
174
+ }
175
+
176
+ test('renders a filterable table', async () => {
177
+ const rendered = render(<App />)
178
+
179
+ const resetButton = rendered.getByText('Reset Data')
180
+ const globalFilterInput = rendered.getByPlaceholderText('Global search...')
181
+ const filterInputs = rendered.getAllByPlaceholderText('Search...')
182
+
183
+ expect(filterInputs).toHaveLength(6)
184
+
185
+ fireEvent.change(filterInputs[1], { target: { value: 'l' } })
186
+ expect(
187
+ rendered
188
+ .queryAllByRole('row')
189
+ .slice(3)
190
+ .map(row => Array.from(row.children)[0].textContent)
191
+ ).toEqual(['firstName: tanner', 'firstName: jaylen'])
192
+
193
+ fireEvent.change(filterInputs[1], { target: { value: 'er' } })
194
+ expect(
195
+ rendered
196
+ .queryAllByRole('row')
197
+ .slice(3)
198
+ .map(row => Array.from(row.children)[0].textContent)
199
+ ).toEqual(['firstName: derek', 'firstName: joe'])
200
+
201
+ fireEvent.change(filterInputs[2], { target: { value: 'nothing' } })
202
+ expect(
203
+ rendered
204
+ .queryAllByRole('row')
205
+ .slice(3)
206
+ .map(row => Array.from(row.children)[0].textContent)
207
+ ).toEqual([])
208
+
209
+ fireEvent.change(filterInputs[1], { target: { value: '' } })
210
+ expect(
211
+ rendered
212
+ .queryAllByRole('row')
213
+ .slice(3)
214
+ .map(row => Array.from(row.children)[0].textContent)
215
+ ).toEqual([])
216
+
217
+ fireEvent.change(filterInputs[2], { target: { value: '' } })
218
+ expect(
219
+ rendered
220
+ .queryAllByRole('row')
221
+ .slice(3)
222
+ .map(row => Array.from(row.children)[0].textContent)
223
+ ).toEqual([
224
+ 'firstName: tanner',
225
+ 'firstName: derek',
226
+ 'firstName: joe',
227
+ 'firstName: jaylen',
228
+ ])
229
+
230
+ fireEvent.change(globalFilterInput, { target: { value: 'li' } })
231
+ expect(
232
+ rendered
233
+ .queryAllByRole('row')
234
+ .slice(3)
235
+ .map(row => Array.from(row.children)[0].textContent)
236
+ ).toEqual(['firstName: tanner', 'firstName: joe', 'firstName: jaylen'])
237
+
238
+ fireEvent.click(resetButton)
239
+ expect(
240
+ rendered
241
+ .queryAllByRole('row')
242
+ .slice(3)
243
+ .map(row => Array.from(row.children)[0].textContent)
244
+ ).toEqual([
245
+ 'firstName: tanner',
246
+ 'firstName: derek',
247
+ 'firstName: joe',
248
+ 'firstName: jaylen',
249
+ ])
250
+ })
251
+
252
+ test('does not filter columns marked as disableFilters', () => {
253
+ const columns = [
254
+ {
255
+ Header: 'Name',
256
+ columns: [
257
+ {
258
+ Header: 'First Name',
259
+ accessor: 'firstName',
260
+ disableFilters: true,
261
+ },
262
+ {
263
+ Header: 'Last Name',
264
+ accessor: 'lastName',
265
+ disableFilters: true,
266
+ },
267
+ ],
268
+ },
269
+ {
270
+ Header: 'Info',
271
+ columns: [
272
+ {
273
+ Header: 'Age',
274
+ accessor: 'age',
275
+ },
276
+ {
277
+ Header: 'Visits',
278
+ accessor: 'visits',
279
+ },
280
+ {
281
+ Header: 'Status',
282
+ accessor: 'status',
283
+ },
284
+ {
285
+ Header: 'Profile Progress',
286
+ accessor: 'progress',
287
+ },
288
+ ],
289
+ },
290
+ ]
291
+ const rendered = render(<App columns={columns} />)
292
+
293
+ const filterInputs = rendered.getAllByPlaceholderText('Search...')
294
+
295
+ expect(filterInputs).toHaveLength(4)
296
+
297
+ // should be Age column
298
+ fireEvent.change(filterInputs[0], { target: { value: '45' } })
299
+ expect(
300
+ rendered
301
+ .queryAllByRole('row')
302
+ .slice(3)
303
+ .map(row => Array.from(row.children)[0].textContent)
304
+ ).toEqual(['firstName: joe'])
305
+
306
+ fireEvent.change(filterInputs[0], { target: { value: '' } })
307
+ expect(
308
+ rendered
309
+ .queryAllByRole('row')
310
+ .slice(3)
311
+ .map(row => Array.from(row.children)[0].textContent)
312
+ ).toEqual([
313
+ 'firstName: tanner',
314
+ 'firstName: derek',
315
+ 'firstName: joe',
316
+ 'firstName: jaylen',
317
+ ])
318
+ })
319
+
320
+ test('does not filter columns with GlobalFilter if marked disableGlobalFilter', () => {
321
+ const columns = [
322
+ {
323
+ Header: 'Name',
324
+ columns: [
325
+ {
326
+ Header: 'First Name',
327
+ accessor: 'firstName',
328
+ disableGlobalFilter: true,
329
+ },
330
+ {
331
+ Header: 'Last Name',
332
+ accessor: 'lastName',
333
+ disableGlobalFilter: true,
334
+ },
335
+ ],
336
+ },
337
+ {
338
+ Header: 'Info',
339
+ columns: [
340
+ {
341
+ Header: 'Age',
342
+ accessor: 'age',
343
+ },
344
+ {
345
+ Header: 'Visits',
346
+ accessor: 'visits',
347
+ },
348
+ {
349
+ Header: 'Status',
350
+ accessor: 'status',
351
+ },
352
+ {
353
+ Header: 'Profile Progress',
354
+ accessor: 'progress',
355
+ },
356
+ ],
357
+ },
358
+ ]
359
+ const rendered = render(<App columns={columns} />)
360
+
361
+ const globalFilterInput = rendered.getByPlaceholderText('Global search...')
362
+
363
+ fireEvent.change(globalFilterInput, { target: { value: '' } })
364
+ expect(
365
+ rendered
366
+ .queryAllByRole('row')
367
+ .slice(3)
368
+ .map(row => Array.from(row.children)[0].textContent)
369
+ ).toEqual([
370
+ 'firstName: tanner',
371
+ 'firstName: derek',
372
+ 'firstName: joe',
373
+ 'firstName: jaylen',
374
+ ])
375
+
376
+ // global filter shouldn't apply to firstName or lastName
377
+ fireEvent.change(globalFilterInput, { target: { value: 'li' } })
378
+ expect(
379
+ rendered
380
+ .queryAllByRole('row')
381
+ .slice(3)
382
+ .map(row => Array.from(row.children)[0].textContent)
383
+ ).toEqual(['firstName: joe'])
384
+
385
+ // double check global filter ignore (should ignore joe bergevin)
386
+ fireEvent.change(globalFilterInput, { target: { value: 'in' } })
387
+ expect(
388
+ rendered
389
+ .queryAllByRole('row')
390
+ .slice(3)
391
+ .map(row => Array.from(row.children)[0].textContent)
392
+ ).toEqual(['firstName: tanner', 'firstName: derek', 'firstName: jaylen'])
393
+ })