DataGrid Documentation
Search…
Controls
HTML Table with Sortable Headers
DataGrid Library may be used for creating HTML tables with sortable headers, search, and pagination. Any DataGird control can be used with tables as with any other HTML structure.
HTML Table with Sortable Headers
First, let's add a minimal HTML structure:
1
<!DOCTYPE html>
2
<html lang="en">
3
<head>
4
<meta charset="UTF-8" />
5
<title>HTML Table with Sortable Headers</title>
6
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no" />
7
</head>
8
<body>
9
10
</body>
11
</html>
Copied!
Now, let's add a table with some sample data. It will contain three columns - user first name, user last name, and age. Each column has an appropriate CSS class:
.first-name and .last-name , and .age1
<!DOCTYPE html>
2
<html lang="en">
3
<head>
4
<meta charset="UTF-8" />
5
<title>HTML Table with Sortable Headers</title>
6
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no" />
7
</head>
8
<body>
9
<table class="demo-table">
10
<thead>
11
<tr>
12
<th>First Name</th>
13
<th>Last Name</th>
14
<th>Age</th>
15
</tr>
16
</thead>
17
<tbody>
18
<tr>
19
<td class="first-name">Wendye</td>
20
<td class="last-name">Lightwing</td>
21
<td class="age">24</td>
22
</tr>
23
<tr>
24
<td class="first-name">Milena</td>
25
<td class="last-name">Torre</td>
26
<td class="age">82</td>
27
</tr>
28
<tr>
29
<td class="first-name">Erinn</td>
30
<td class="last-name">Hills</td>
31
<td class="age">81</td>
32
</tr>
33
<tr>
34
<td class="first-name">Yoshiko</td>
35
<td class="last-name">Smithson</td>
36
<td class="age">62</td>
37
</tr>
38
<tr>
39
<td class="first-name">Umberto</td>
40
<td class="last-name">McFadden</td>
41
<td class="age">93</td>
42
</tr>
43
<tr>
44
<td class="first-name">Donaugh</td>
45
<td class="last-name-name">Huban</td>
46
<td class="age">75</td>
47
</tr>
48
<tr>
49
<td class="first-name">Cami</td>
50
<td class="last-name">Pickthorn</td>
51
<td class="age">45</td>
52
</tr>
53
<tr>
54
<td class="first-name">Alistair</td>
55
<td class="last-name">Reddell</td>
56
<td class="age">55</td>
57
</tr>
58
<tr>
59
<td class="first-name">Genia</td>
60
<td class="last-name">Crawshay</td>
61
<td class="age">60</td>
62
</tr>
63
<tr>
64
<td class="first-name">Allyn</td>
65
<td class="last-name">Liell</td>
66
<td class="age">37</td>
67
</tr>
68
</tbody>
69
</table>
70
</body>
71
</html>
Copied!
Also, let's add some styles:
1
.demo-table{
2
margin: 2rem auto;
3
border: 1px solid #ddd;
4
border-collapse: collapse;
5
table-layout: fixed;
6
font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
7
width: 100%;
8
}
9
10
.demo-table td,
11
.demo-table th{
12
padding: 1rem;
13
border: 1px solid #ddd;
14
width: 33%;
15
text-align: left;
16
}
17
18
.demo-table tr:nth-child(odd) td{
19
background: #f4f4f4;
20
}
21
22
.demo-table th a{
23
color: #07909b;
24
display: flex;
25
align-items: center;
26
justify-content: space-between;
27
text-decoration: none;
28
}
29
30
.demo-table th a::after{
31
margin-left: 1rem;
32
display: inline-block;
33
font-size: 1rem;
34
content: '\2195';
35
}
36
37
.dg-sort-selected.dg-asc::after{
38
content: '\25BC';
39
font-size: 0.8rem;
40
}
41
42
.dg-sort-selected.dg-desc::after{
43
content: '\25B2';
44
font-size: 0.8rem;
45
}
Copied!
Now we need to add a DataGrid CSS to the HEAD of the document:
1
<!-- DataGrid library CSS -->
2
<link href="datagrid.min.css" rel="stylesheet" />
Copied!
And additionally, we need to add the DataGrid script at the bottom of the document.
1
<!-- DataGrid library JavaScript -->
2
<script src="datagrid.min.js"></script>
Copied!
All we need to do now is to define what exactly should be sorted. Let's add the
data-grid attribute to the <tbody> element of the table, and data-grid-item property to each <tr> element. Now the table will look like follows:1
<table class="demo-table">
2
<thead>
3
<tr>
4
<th>First Name</th>
5
<th>Last Name</th>
6
<th>Age</th>
7
</tr>
8
</thead>
9
<tbody data-grid>
10
<tr data-grid-item>
11
<td class="first-name">Wendye</td>
12
<td class="last-name">Lightwing</td>
13
<td class="age">24</td>
14
</tr>
15
<tr data-grid-item>
16
<td class="first-name">Milena</td>
17
<td class="last-name">Torre</td>
18
<td class="age">82</td>
19
</tr>
20
<tr data-grid-item>
21
<td class="first-name">Erinn</td>
22
<td class="last-name">Hills</td>
23
<td class="age">81</td>
24
</tr>
25
<tr data-grid-item>
26
<td class="first-name">Yoshiko</td>
27
<td class="last-name">Smithson</td>
28
<td class="age">62</td>
29
</tr>
30
<tr data-grid-item>
31
<td class="first-name">Umberto</td>
32
<td class="last-name">McFadden</td>
33
<td class="age">93</td>
34
</tr>
35
<tr data-grid-item>
36
<td class="first-name">Donaugh</td>
37
<td class="last-name-name">Huban</td>
38
<td class="age">75</td>
39
</tr>
40
<tr data-grid-item>
41
<td class="first-name">Cami</td>
42
<td class="last-name">Pickthorn</td>
43
<td class="age">45</td>
44
</tr>
45
<tr data-grid-item>
46
<td class="first-name">Alistair</td>
47
<td class="last-name">Reddell</td>
48
<td class="age">55</td>
49
</tr>
50
<tr data-grid-item>
51
<td class="first-name">Genia</td>
52
<td class="last-name">Crawshay</td>
53
<td class="age">60</td>
54
</tr>
55
<tr data-grid-item>
56
<td class="first-name">Allyn</td>
57
<td class="last-name">Liell</td>
58
<td class="age">37</td>
59
</tr>
60
</tbody>
61
</table>
Copied!
1
<table class="demo-table">
2
<thead>
3
<tr>
4
<th>
5
<a
6
href="#"
7
data-id="table_header_sort"
8
data-grid-control="sort-button"
9
data-path=".first-name"
10
data-direction="asc"
11
data-toggle-direction
12
data-type="text">First Name</a>
13
</th>
14
<th>
15
<a
16
href="#"
17
data-id="table_header_sort"
18
data-grid-control="sort-button"
19
data-path=".last-name"
20
data-direction="asc"
21
data-toggle-direction
22
data-type="text">Last Name</a>
23
</th>
24
25
<th>
26
<a
27
href="#"
28
data-id="table_header_sort"
29
data-grid-control="sort-button"
30
data-path=".age"
31
data-direction="asc"
32
data-toggle-direction
33
data-type="number">Age</a>
34
</th>
35
</tr>
36
</thead>
37
<tbody data-grid>
38
<tr data-grid-item>
39
<td class="first-name">Wendye</td>
40
<td class="last-name">Lightwing</td>
41
<td class="age">24</td>
42
</tr>
43
<tr data-grid-item>
44
<td class="first-name">Milena</td>
45
<td class="last-name">Torre</td>
46
<td class="age">82</td>
47
</tr>
48
<tr data-grid-item>
49
<td class="first-name">Erinn</td>
50
<td class="last-name">Hills</td>
51
<td class="age">81</td>
52
</tr>
53
<tr data-grid-item>
54
<td class="first-name">Yoshiko</td>
55
<td class="last-name">Smithson</td>
56
<td class="age">62</td>
57
</tr>
58
<tr data-grid-item>
59
<td class="first-name">Umberto</td>
60
<td class="last-name">McFadden</td>
61
<td class="age">93</td>
62
</tr>
63
<tr data-grid-item>
64
<td class="first-name">Donaugh</td>
65
<td class="last-name-name">Huban</td>
66
<td class="age">75</td>
67
</tr>
68
<tr data-grid-item>
69
<td class="first-name">Cami</td>
70
<td class="last-name">Pickthorn</td>
71
<td class="age">45</td>
72
</tr>
73
<tr data-grid-item>
74
<td class="first-name">Alistair</td>
75
<td class="last-name">Reddell</td>
76
<td class="age">55</td>
77
</tr>
78
<tr data-grid-item>
79
<td class="first-name">Genia</td>
80
<td class="last-name">Crawshay</td>
81
<td class="age">60</td>
82
</tr>
83
<tr data-grid-item>
84
<td class="first-name">Allyn</td>
85
<td class="last-name">Liell</td>
86
<td class="age">37</td>
87
</tr>
88
</tbody>
89
</table>
Copied!
The final step is to initialize the DataGrid library as follows:
1
<script>
2
datagrid();
3
</script>
Copied!
That's all! The final HTML is:
1
<!DOCTYPE html>
2
<html lang="en">
3
<head>
4
<meta charset="UTF-8" />
5
<title>Sort HTML Table with DataGrid Library</title>
6
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no" />
7
8
<!-- Demo page CSS -->
9
<link href="styles.css" rel="stylesheet" />
10
11
<!-- DataGrid library CSS -->
12
<link href="datagrid.min.css" rel="stylesheet" />
13
</head>
14
<body>
15
<table class="demo-table">
16
<thead>
17
<tr>
18
<th>
19
<a
20
href="#"
21
data-id="table_header_sort"
22
data-grid-control="sort-button"
23
data-path=".first-name"
24
data-direction="asc"
25
data-toggle-direction
26
data-type="text">First Name</a>
27
</th>
28
<th>
29
<a
30
href="#"
31
data-id="table_header_sort"
32
data-grid-control="sort-button"
33
data-path=".last-name"
34
data-direction="asc"
35
data-toggle-direction
36
data-type="text">Last Name</a>
37
</th>
38
39
<th>
40
<a
41
href="#"
42
data-id="table_header_sort"
43
data-grid-control="sort-button"
44
data-path=".age"
45
data-direction="asc"
46
data-toggle-direction
47
data-type="number">Age</a>
48
</th>
49
</tr>
50
</thead>
51
<tbody data-grid>
52
<tr data-grid-item>
53
<td class="first-name">Wendye</td>
54
<td class="last-name">Lightwing</td>
55
<td class="age">24</td>
56
</tr>
57
<tr data-grid-item>
58
<td class="first-name">Milena</td>
59
<td class="last-name">Torre</td>
60
<td class="age">82</td>
61
</tr>
62
<tr data-grid-item>
63
<td class="first-name">Erinn</td>
64
<td class="last-name">Hills</td>
65
<td class="age">81</td>
66
</tr>
67
<tr data-grid-item>
68
<td class="first-name">Yoshiko</td>
69
<td class="last-name">Smithson</td>
70
<td class="age">62</td>
71
</tr>
72
<tr data-grid-item>
73
<td class="first-name">Umberto</td>
74
<td class="last-name">McFadden</td>
75
<td class="age">93</td>
76
</tr>
77
<tr data-grid-item>
78
<td class="first-name">Donaugh</td>
79
<td class="last-name-name">Huban</td>
80
<td class="age">75</td>
81
</tr>
82
<tr data-grid-item>
83
<td class="first-name">Cami</td>
84
<td class="last-name">Pickthorn</td>
85
<td class="age">45</td>
86
</tr>
87
<tr data-grid-item>
88
<td class="first-name">Alistair</td>
89
<td class="last-name">Reddell</td>
90
<td class="age">55</td>
91
</tr>
92
<tr data-grid-item>
93
<td class="first-name">Genia</td>
94
<td class="last-name">Crawshay</td>
95
<td class="age">60</td>
96
</tr>
97
<tr data-grid-item>
98
<td class="first-name">Allyn</td>
99
<td class="last-name">Liell</td>
100
<td class="age">37</td>
101
</tr>
102
</tbody>
103
</table>
104
105
<!-- DataGrid library JavaScript -->
106
<script src="datagrid.min.js"></script>
107
108
<script>
109
datagrid();
110
</script>
111
</body>
112
</html>
Copied!
Copy link