chore(filtering): Deprecated filterGlobal (#15016) (#15064)

* chore(filtering): Deprecated filterGlobal (#15016)

Author: Otixa

CHANGELOG.md

@@ -3,6 +3,9 @@
 All notable changes for each version of this project will be documented in this file.
 
 ## 19.0.0
+### General
+- `IgxFilteringService`, `IgxGridBaseDirective`
+    - **Deprecation** The `filterGlobal` method has been deprecated and will be removed in a future version.
 ### New Features
 - `IgxColumn`
     - Introduced the `disabledSummaries` property, allowing users to specify which summaries should be disabled for a given column. This property accepts an array of strings corresponding to the summary keys, enabling selective control over both default summaries (e.g., 'Count', 'Min') and any custom summaries created by the user.

projects/igniteui-angular/src/lib/grids/README.md

@@ -273,7 +273,6 @@ Here is a list of all public methods exposed by **igx-grid**:
 |`updateRow(value: any, rowIndex: number)`|Updates the row object and the data source record with the passed value.|
 |`updateCell(value: any, rowIndex: number, column: string)`|Updates the cell object and the record field in the data source.|
 |`filter(name: string, value: any, conditionOrExpressionTree?: IFilteringOperation | IFilteringExpressionsTree, ignoreCase?: boolean)`|Filters a single column. A filtering condition or filtering expressions tree could be used. Check the available [filtering conditions](#filtering-conditions)|
-|`filterGlobal(value: any, condition?, ignoreCase?)`|Filters all the columns in the grid with the same condition.|
 |`clearFilter(name?: string)`|If `name` is provided, clears the filtering state of the corresponding column, otherwise clears the filtering state of all columns.|
 |`sort(expression: ISortingExpression)`|Sorts a single column.|
 |`sort(expressions: Array)`|Sorts the grid columns based on the provided array of sorting expressions.|

projects/igniteui-angular/src/lib/grids/filtering/grid-filtering.service.ts

@@ -287,6 +287,7 @@ export class IgxFilteringService implements OnDestroy {
 
     /**
      * Filters all the `IgxColumnComponent` in the `IgxGridComponent` with the same condition.
+     * @deprecated in version 19.0.0.
      */
     public filterGlobal(value: any, condition, ignoreCase?) {
         if (!condition) {

projects/igniteui-angular/src/lib/grids/grid-base.directive.ts

@@ -4930,6 +4930,7 @@ export abstract class IgxGridBaseDirective implements GridType,
      * @param value
      * @param condition
      * @param ignoreCase
+     * @deprecated in version 19.0.0. 
      */
     public filterGlobal(value: any, condition, ignoreCase?) {
         this.filteringService.filterGlobal(value, condition, ignoreCase);

src/app/grid-events/grid-events.component.html

@@ -9,9 +9,6 @@
 <igx-input-group>
     <input igxInput #productName type="text" placeholder="Filter by product name" (input)="filter(productName.value)">
 </igx-input-group><br>
-<igx-input-group>
-    <input igxInput #globalFilter type="text" placeholder="Filter global" (input)="filterGlobal(globalFilter.value)">
-</igx-input-group><br>
 
 <div class="sample-wrapper">
     <div class="grid-wrapper">

src/app/grid-events/grid-events.component.ts

@@ -19,8 +19,7 @@ import {
     IgxColumnComponent,
     IgxPaginatorComponent,
     IgxButtonDirective,
-    IgxIconComponent,
-    FilteringLogic
+    IgxIconComponent
 } from 'igniteui-angular';
 import { data } from '../shared/data';
 
@@ -54,15 +53,6 @@ export class GridEventsComponent {
         this.grid.filter('ProductName', term, IgxStringFilteringOperand.instance().condition('contains'));
     }
 
-    public filterGlobal(term) {
-        if (term) {
-            this.grid.filteringLogic = FilteringLogic.Or;
-            this.grid.filterGlobal(term, IgxStringFilteringOperand.instance().condition('contains'));
-        } else {
-            this.grid.clearFilter();
-        }
-    }
-
     public columnMovingStart(event: IColumnMovingStartEventArgs) {
         console.log('event' + event);
         this.logAnEvent('=> columnMovingStart');