Skip to content

Commit 6ae7a80

Browse files
Merge pull request #1 from SyncfusionExamples/KB
How to use callbacks for server sorting in Flutter DataTable
2 parents d74001b + 0dce1c0 commit 6ae7a80

File tree

125 files changed

+4830
-2
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

125 files changed

+4830
-2
lines changed

.gitignore

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# Miscellaneous
2+
*.class
3+
*.log
4+
*.pyc
5+
*.swp
6+
.DS_Store
7+
.atom/
8+
.build/
9+
.buildlog/
10+
.history
11+
.svn/
12+
.swiftpm/
13+
migrate_working_dir/
14+
15+
# IntelliJ related
16+
*.iml
17+
*.ipr
18+
*.iws
19+
.idea/
20+
21+
# The .vscode folder contains launch configuration and tasks you configure in
22+
# VS Code which you may wish to be included in version control, so this line
23+
# is commented out by default.
24+
#.vscode/
25+
26+
# Flutter/Dart/Pub related
27+
**/doc/api/
28+
**/ios/Flutter/.last_build_id
29+
.dart_tool/
30+
.flutter-plugins
31+
.flutter-plugins-dependencies
32+
.pub-cache/
33+
.pub/
34+
/build/
35+
36+
# Symbolication related
37+
app.*.symbols
38+
39+
# Obfuscation related
40+
app.*.map.json
41+
42+
# Android Studio will place build artifacts here
43+
/android/app/debug
44+
/android/app/profile
45+
/android/app/release

README.md

Lines changed: 112 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,112 @@
1-
# How-to-use-callbacks-for-server-sorting-in-Flutter-DataTable
2-
This demo shows How to use callbacks for server sorting in Flutter DataTable
1+
# How to use callbacks for server sorting in Flutter DataTable (SfDataGrid)?
2+
3+
In this article, we will show how to use callbacks for server sorting in [Flutter DataTable](https://www.syncfusion.com/flutter-widgets/flutter-datagrid).
4+
5+
Initialize the [SfDataGrid](https://pub.dev/documentation/syncfusion_flutter_datagrid/latest/datagrid/SfDataGrid-class.html) widget with the necessary properties. The SfDataGrid provides the following callbacks for sorting: [onColumnSortChanging](https://pub.dev/documentation/syncfusion_flutter_datagrid/latest/datagrid/SfDataGrid/onColumnSortChanging.html) and [onColumnSortChanged](https://pub.dev/documentation/syncfusion_flutter_datagrid/latest/datagrid/SfDataGrid/onColumnSortChanged.html). The onColumnSortChanged callback is triggered when a column is sorted in the SfDataGrid. You can use [SfDataGrid.source.sortedColumns](https://pub.dev/documentation/syncfusion_flutter_datagrid/latest/datagrid/DataGridSource/sortedColumns.html) to retrieve the sorted column details, including the sort direction. Based on this direction, you can load the corresponding data into the DataGrid. After adding new data, make sure to call [notifyListeners](https://api.flutter.dev/flutter/foundation/ChangeNotifier/notifyListeners.html) to refresh the DataGrid when the underlying data changes.
6+
7+
Additionally, note that you should override the [performSorting](https://pub.dev/documentation/syncfusion_flutter_datagrid/latest/datagrid/DataGridSource/performSorting.html) method with an empty implementation to disable built-in DataGrid sorting.
8+
9+
```dart
10+
@override
11+
Widget build(BuildContext context) {
12+
return Scaffold(
13+
appBar: AppBar(title: const Text('Syncfusion Flutter DataGrid')),
14+
body: StreamBuilder(
15+
stream: loadingController.stream,
16+
builder: (BuildContext context, AsyncSnapshot<bool> snapshot) {
17+
return Stack(
18+
children: [
19+
SfDataGrid(
20+
source: employeeDataSource,
21+
columnWidthMode: ColumnWidthMode.fill,
22+
allowSorting: true,
23+
sortingGestureType: SortingGestureType.tap,
24+
onColumnSortChanged: (newSortedColumn, oldSortedColumn) async {
25+
// Show loading indicator
26+
loadingController.add(true);
27+
await Future<void>.delayed(const Duration(seconds: 2));
28+
// Hide loading indicator
29+
loadingController.add(false);
30+
employeeDataSource._employeeData.clear();
31+
for (
32+
int i = 0;
33+
i < employeeDataSource.sortedColumns.length;
34+
i++
35+
) {
36+
if (employeeDataSource.sortedColumns[i].sortDirection ==
37+
DataGridSortDirection.ascending) {
38+
var employee2 = getEmployeeDataAscending();
39+
employeeDataSource._buildDataGridRows(employee2);
40+
employeeDataSource.updateDataGridSource();
41+
} else if (employeeDataSource
42+
.sortedColumns[i]
43+
.sortDirection ==
44+
DataGridSortDirection.descending) {
45+
var employee2 = getEmployeeDataDescending();
46+
employeeDataSource._buildDataGridRows(employee2);
47+
employeeDataSource.updateDataGridSource();
48+
}
49+
}
50+
},
51+
columns: <GridColumn>[
52+
GridColumn(
53+
columnName: 'id',
54+
label: Container(
55+
padding: const EdgeInsets.all(16.0),
56+
alignment: Alignment.center,
57+
child: const Text('ID'),
58+
),
59+
),
60+
GridColumn(
61+
columnName: 'name',
62+
label: Container(
63+
padding: const EdgeInsets.all(8.0),
64+
alignment: Alignment.center,
65+
child: const Text('Name'),
66+
),
67+
),
68+
GridColumn(
69+
columnName: 'designation',
70+
label: Container(
71+
padding: const EdgeInsets.all(8.0),
72+
alignment: Alignment.center,
73+
child: const Text(
74+
'Designation',
75+
overflow: TextOverflow.ellipsis,
76+
),
77+
),
78+
),
79+
GridColumn(
80+
columnName: 'salary',
81+
label: Container(
82+
padding: const EdgeInsets.all(8.0),
83+
alignment: Alignment.center,
84+
child: const Text('Salary'),
85+
),
86+
),
87+
],
88+
),
89+
if (snapshot.data == true)
90+
const Center(child: CircularProgressIndicator()),
91+
],
92+
);
93+
},
94+
),
95+
);
96+
}
97+
98+
class EmployeeDataSource extends DataGridSource {
99+
100+
….
101+
102+
103+
@override
104+
Future<void> performSorting(List<DataGridRow> rows) async {}
105+
106+
void updateDataGridSource() {
107+
notifyListeners();
108+
}
109+
}
110+
```
111+
112+
You can download this example on [GitHub](https://github.com/SyncfusionExamples/How-to-use-callbacks-for-server-sorting-in-Flutter-DataTable).

android/.gitignore

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
gradle-wrapper.jar
2+
/.gradle
3+
/captures/
4+
/gradlew
5+
/gradlew.bat
6+
/local.properties
7+
GeneratedPluginRegistrant.java
8+
.cxx/
9+
10+
# Remember to never publicly share your keystore.
11+
# See https://flutter.dev/to/reference-keystore
12+
key.properties
13+
**/*.keystore
14+
**/*.jks

android/app/build.gradle.kts

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
plugins {
2+
id("com.android.application")
3+
id("kotlin-android")
4+
// The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.
5+
id("dev.flutter.flutter-gradle-plugin")
6+
}
7+
8+
android {
9+
namespace = "com.example.flutter_application"
10+
compileSdk = flutter.compileSdkVersion
11+
ndkVersion = flutter.ndkVersion
12+
13+
compileOptions {
14+
sourceCompatibility = JavaVersion.VERSION_11
15+
targetCompatibility = JavaVersion.VERSION_11
16+
}
17+
18+
kotlinOptions {
19+
jvmTarget = JavaVersion.VERSION_11.toString()
20+
}
21+
22+
defaultConfig {
23+
// TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
24+
applicationId = "com.example.flutter_application"
25+
// You can update the following values to match your application needs.
26+
// For more information, see: https://flutter.dev/to/review-gradle-config.
27+
minSdk = flutter.minSdkVersion
28+
targetSdk = flutter.targetSdkVersion
29+
versionCode = flutter.versionCode
30+
versionName = flutter.versionName
31+
}
32+
33+
buildTypes {
34+
release {
35+
// TODO: Add your own signing config for the release build.
36+
// Signing with the debug keys for now, so `flutter run --release` works.
37+
signingConfig = signingConfigs.getByName("debug")
38+
}
39+
}
40+
}
41+
42+
flutter {
43+
source = "../.."
44+
}
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
2+
<!-- The INTERNET permission is required for development. Specifically,
3+
the Flutter tool needs it to communicate with the running application
4+
to allow setting breakpoints, to provide hot reload, etc.
5+
-->
6+
<uses-permission android:name="android.permission.INTERNET"/>
7+
</manifest>
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
2+
<application
3+
android:label="flutter_application"
4+
android:name="${applicationName}"
5+
android:icon="@mipmap/ic_launcher">
6+
<activity
7+
android:name=".MainActivity"
8+
android:exported="true"
9+
android:launchMode="singleTop"
10+
android:taskAffinity=""
11+
android:theme="@style/LaunchTheme"
12+
android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
13+
android:hardwareAccelerated="true"
14+
android:windowSoftInputMode="adjustResize">
15+
<!-- Specifies an Android theme to apply to this Activity as soon as
16+
the Android process has started. This theme is visible to the user
17+
while the Flutter UI initializes. After that, this theme continues
18+
to determine the Window background behind the Flutter UI. -->
19+
<meta-data
20+
android:name="io.flutter.embedding.android.NormalTheme"
21+
android:resource="@style/NormalTheme"
22+
/>
23+
<intent-filter>
24+
<action android:name="android.intent.action.MAIN"/>
25+
<category android:name="android.intent.category.LAUNCHER"/>
26+
</intent-filter>
27+
</activity>
28+
<!-- Don't delete the meta-data below.
29+
This is used by the Flutter tool to generate GeneratedPluginRegistrant.java -->
30+
<meta-data
31+
android:name="flutterEmbedding"
32+
android:value="2" />
33+
</application>
34+
<!-- Required to query activities that can process text, see:
35+
https://developer.android.com/training/package-visibility and
36+
https://developer.android.com/reference/android/content/Intent#ACTION_PROCESS_TEXT.
37+
38+
In particular, this is used by the Flutter engine in io.flutter.plugin.text.ProcessTextPlugin. -->
39+
<queries>
40+
<intent>
41+
<action android:name="android.intent.action.PROCESS_TEXT"/>
42+
<data android:mimeType="text/plain"/>
43+
</intent>
44+
</queries>
45+
</manifest>
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
package com.example.flutter_application
2+
3+
import io.flutter.embedding.android.FlutterActivity
4+
5+
class MainActivity : FlutterActivity()
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- Modify this file to customize your launch splash screen -->
3+
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
4+
<item android:drawable="?android:colorBackground" />
5+
6+
<!-- You can insert your own image assets here -->
7+
<!-- <item>
8+
<bitmap
9+
android:gravity="center"
10+
android:src="@mipmap/launch_image" />
11+
</item> -->
12+
</layer-list>
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- Modify this file to customize your launch splash screen -->
3+
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
4+
<item android:drawable="@android:color/white" />
5+
6+
<!-- You can insert your own image assets here -->
7+
<!-- <item>
8+
<bitmap
9+
android:gravity="center"
10+
android:src="@mipmap/launch_image" />
11+
</item> -->
12+
</layer-list>
544 Bytes
Loading

0 commit comments

Comments
 (0)