Merge pull request #383 from syncfusion-content/FLUT-6128-Filtering-support

NeelakandanKannan · web-flow · commit 75e42f4b2491 · 2022-09-28T12:44:48.000+05:30
FLUT-6128 - [Feature] Adapted the content review changes in the data grid filtering UG documentation
diff --git a/Flutter/datagrid/filtering.md b/Flutter/datagrid/filtering.md
@@ -1,21 +1,21 @@
 ---
 layout: post
 title: Filtering in Flutter DataGrid | DataTable | Syncfusion
-description: Learn here all about how to filter the data rows in Syncfusion Flutter DataGrid (SfDataGrid) widget and more.
+description: Learn all about how to filter the data rows in Syncfusion Flutter DataGrid (SfDataGrid) widget and more here.
 platform: flutter
 control: SfDataGrid
 documentation: ug
 --- 
 
 # Filtering in Flutter DataGrid (SfDataGrid)
 
-Filtering is the process of fetching the values from the collection which satisfy the specified condition. In the `SfDataGrid`, the filtering can be applied through the UI as well as programmatically.
+Filtering is the process of fetching the values from a collection that satisfies a specified condition. In the `SfDataGrid`, filtering can be applied through the UI and programmatically.
 
 ## Programmatical Filtering
 
 The SfDataGrid allows you to filter the data rows programmatically by adding the filter conditions along with the respective column name to the `DataGridSource.filterConditions` map collection. In the map collection, the `key` defines the `columnName` and the `values` defines the list of `FilterCondition`.
 
-`DataGridSource.filterConditions` is a unmodifiable map collection. So, it doesn't allow to perform CRUD operations directly in the `DataGridSource.filterConditions` property. But, it can be done by the following public methods.
+`DataGridSource.filterConditions` is an unmodifiable map collection. So, it doesn't allow us to perform CRUD operations directly in the `DataGridSource.filterConditions` property. However, it can be done by the following public methods:
 
 ### Add filter
 
@@ -212,7 +212,7 @@ Widget build(BuildContext context) {
 
 The `FilterBehavior` property is used to specify whether filtering should consider the value of a cell as the string or its data type
 
-* **stringDataType** - It converts the cell value as string data type and compare the condition.
+* **stringDataType** - It converts the cell value as string data type and compares the condition.
 * **strongDataType** - It compares the cell value with its actual data type.
 
 {% tabs %}
@@ -285,8 +285,8 @@ Widget build(BuildContext context) {
 
 The `FilterOperator` property is used to decide how a logical operator is to be applied between multiple filter conditions.
 
-* **and** - `AND` logical operator applies between multiple filter conditions 
-* **or** - `OR` logical operator applies between multiple filter conditions
+* **and** - `AND` logical operator applies between multiple filter conditions. 
+* **or** - `OR` logical operator applies between multiple filter conditions.
 
 {% tabs %}
 {% highlight Dart %} 
@@ -448,11 +448,11 @@ After filtering, the rows can be retrieved in the same order as displayed in the
 
 ## UI Filtering
 
-The `SfDataGrid` provides excel-like filtering UI and also advanced filter UI to filter the data easily. UI filtering can be enabled by setting `SfDataGrid.allowFiltering` property to `true`. This allows to open the filter UI by clicking on the filter icon available in the column header. The filtering UI will be shown as a popup menu on the desktop and web platforms and it will be shown as a new page on the mobile platforms.
+The `SfDataGrid` provides an excel-like filtering UI and an advanced filter UI to filter the data easily. UI filtering can be enabled by setting the `SfDataGrid.allowFiltering` property to `true`. This allows the filter UI to be opened by clicking on the filter icon in the column header. The filtering UI will be shown as a popup menu on the desktop and web platforms, and it will be shown as a new page on the mobile platforms.
 
-The `SfDataGrid` provides the following types of filter popup modes,
+The `SfDataGrid` provides the following types of filter popup modes:
 
-* **Checkbox Filter** - Provides excel like filter interface with list of check boxes.
+* **Checkbox Filter** - Provides excel like filter interface with a list of checkboxes.
 * **Advanced Filter** - Provides advanced filter options to filter the data with multiple conditions.
 
 ![Flutter datagrid shows a checkbox filter in web platform](images/filtering/flutter-datagrid-checkbox-filter-view.png)
@@ -473,8 +473,8 @@ The Checkbox filtering is like the Excel-like filter popup that shows the checke
 
 ### Advanced filtering
 
-Advanced filter UI provides multiple filter options to filter the data rows. The filter menu options are loaded based on advanced filter type by automatically detecting the underlying date type of the current column.
-Below are the built-in filter types supported.
+Advanced filter UI provides multiple filter options to filter the data rows. The filter menu options are loaded based on advanced filter type by automatically detecting the underlying data type of the current column.
+Below are the built-in filter types supported:
 
 * **Text Filters** – Loads various menu options to filter the display text effectively.
 * **Number Filters** – Loads various menu options to filter the numeric data.
@@ -509,13 +509,13 @@ Below are the built-in filter types supported.
 
 #### Case sensitive filtering
 
-The case sensitive filtering can be enabled for the column by using the casing icon available in the advanced filter UI. This is available only for `TextFilters` filter view. If the icon is active, the filtering will be applied with the case sensitive with the filter text. The case sensitive icon will be shown only to the string type columns.
+Case-sensitive filtering can be enabled for the column using the casing icon available in the advanced filter UI. This is available only for the `TextFilters` filter view. If the icon is active, the filtering will be applied with the case sensitive with the filter text. The case-sensitive icon will be shown only to the string-type columns.
 
 ![Flutter datagrid shows the case sensitive icon](images/filtering/flutter-datagrid-casesensitive-filtering.png)
 
 ### Disable filtering for an individual column
 
-The `GridColumn.allowFiltering` has higher priority than `SfDataGrid.allowFiltering` property. So, you can disable the filtering for any particular column by setting `GridColumn.allowFiltering` property to `false`.
+The `GridColumn.allowFiltering` has a higher priority than the `SfDataGrid.allowFiltering` property. So, you can disable the filtering for any particular column by setting the `GridColumn.allowFiltering` property to `false`.
 
 {% tabs %}
 {% highlight Dart %} 
@@ -575,7 +575,7 @@ The SfDataGrid provides the following callbacks to notify the filtering stages:
 
 ### OnFilterChanging callback
 
-`onFilterChanging` callback invokes when the filtering is being appiled to the particular column through UI filtering. You can return `false` from this callback to restrict the column from being filtered.
+`onFilterChanging` callback invokes when the filtering is being applied to the particular column through UI filtering. You can return `false` from this callback to restrict the column from being filtered.
 
 {% tabs %}
 {% highlight Dart %} 
@@ -636,7 +636,7 @@ Widget build(BuildContext context) {
 
 ### OnFilterChanged callback
 
-`onFilterChanged` callback invokes after the filtering is appiled to the particular column through UI filtering. You can use this callback to get filter conditions.
+`onFilterChanged` callback invokes after the filtering is applied to the particular column through UI filtering. You can use this callback to get filter conditions.
 
 {% tabs %}
 {% highlight Dart %} 
