DevExtreme v23.2 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

Multiple Sorting

The DataGrid component can sort values by a single or multiple columns. Use the sorting.mode property to specify the sort mode:

  • Single sort mode
    A user can click the column header to sort by this column and click it again to change the sort order (ascending or descending). An arrow icon in the column's header indicates the sort order.

  • Multiple sort mode
    A user can hold the Shift key and click column headers in the order the user wants to apply sorting. A number in the column's header indicates the sort index. To cancel a column's sort settings, a user should hold the Ctrl key and click the column header.

A user can also apply or cancel sort settings in the column header's context menu. To disallow a user to sort by a particular column, set the column's allowSorting property to false.

To specify the initial sort settings, use the column's sortOrder and sortIndex properties. You can also use these properties to change sort settings at runtime, as shown in this demo.

Backend API
<dx-data-grid id="gridContainer" [dataSource]="employees" keyExpr="ID" [showBorders]="true" > <dxo-sorting mode="multiple"></dxo-sorting> <dxi-column dataField="Prefix" caption="Title" [width]="70"></dxi-column> <dxi-column dataField="FirstName" sortOrder="asc"></dxi-column> <dxi-column dataField="LastName" sortOrder="asc"></dxi-column> <dxi-column dataField="City"></dxi-column> <dxi-column dataField="State"></dxi-column> <dxi-column dataField="Position" [width]="130" [allowSorting]="!positionDisableSorting" ></dxi-column> <dxi-column dataField="HireDate" dataType="date"></dxi-column> </dx-data-grid> <div class="options"> <div class="caption">Options</div> <div class="option"> <dx-check-box [(value)]="positionDisableSorting" (onValueChanged)="onValueChange($event)" text="Disable Sorting for the Position Column" > </dx-check-box> </div> </div>
import { NgModule, Component, ViewChild, enableProdMode, } from '@angular/core'; import { BrowserModule, BrowserTransferStateModule } from '@angular/platform-browser'; import { platformBrowserDynamic } from '@angular/platform-browser-dynamic'; import { DxDataGridComponent, DxDataGridModule } from 'devextreme-angular'; import { DxCheckBoxModule, DxCheckBoxTypes } from 'devextreme-angular/ui/check-box'; import { Employee, Service } from './app.service'; if (!/localhost/.test(document.location.host)) { enableProdMode(); } @Component({ selector: 'demo-app', providers: [Service], templateUrl: 'app/app.component.html', styleUrls: ['app/app.component.css'], }) export class AppComponent { @ViewChild(DxDataGridComponent, { static: false }) dataGrid: DxDataGridComponent; employees: Employee[]; positionDisableSorting = false; constructor(service: Service) { this.employees = service.getEmployees(); } onValueChange(e: DxCheckBoxTypes.ValueChangedEvent) { if (e.value) { this.dataGrid.instance.columnOption(5, 'sortOrder', undefined); } } } @NgModule({ imports: [ BrowserModule, BrowserTransferStateModule, DxDataGridModule, DxCheckBoxModule, ], declarations: [AppComponent], bootstrap: [AppComponent], }) export class AppModule { } platformBrowserDynamic().bootstrapModule(AppModule);
::ng-deep .options { padding: 20px; margin-top: 20px; background-color: rgba(191, 191, 191, 0.15); } ::ng-deep .caption { font-size: 18px; font-weight: 500; } ::ng-deep .option { margin-top: 10px; }
import { Injectable } from '@angular/core'; export class Employee { ID: number; FirstName: string; LastName: string; Phone: string; Prefix: string; Position: string; BirthDate: string; HireDate: string; Email: string; Address: string; City: string; State: string; StateID: number; HomePhone: string; Skype: string; } const employees: Employee[] = [{ ID: 1, FirstName: 'John', LastName: 'Heart', Phone: '(213) 555-9392', Prefix: 'Mr.', Position: 'CEO', BirthDate: '1964-03-16', HireDate: '1995-01-15', Email: 'jheart@dx-email.com', Address: '351 S Hill St.', City: 'Los Angeles', StateID: 5, State: 'California', HomePhone: '(213) 555-9208', Skype: 'jheartDXskype', }, { ID: 2, FirstName: 'Olivia', LastName: 'Peyton', Phone: '(310) 555-2728', Prefix: 'Mrs.', Position: 'Sales Assistant', BirthDate: '1981-06-03', HireDate: '2012-05-14', Email: 'oliviap@dx-email.com', Address: '807 W Paseo Del Mar', City: 'Los Angeles', StateID: 5, State: 'California', HomePhone: '(310) 555-4547', Skype: 'oliviapDXskype', }, { ID: 3, FirstName: 'Robert', LastName: 'Reagan', Phone: '(818) 555-2387', Prefix: 'Mr.', Position: 'CMO', BirthDate: '1974-09-07', HireDate: '2002-11-08', Email: 'robertr@dx-email.com', Address: '4 Westmoreland Pl.', City: 'Bentonville', StateID: 4, State: 'Arkansas', HomePhone: '(818) 555-2438', Skype: 'robertrDXskype', }, { ID: 4, FirstName: 'Greta', LastName: 'Sims', Phone: '(818) 555-6546', Prefix: 'Ms.', Position: 'HR Manager', BirthDate: '1977-11-22', HireDate: '1998-04-23', Email: 'gretas@dx-email.com', Address: '1700 S Grandview Dr.', City: 'Atlanta', StateID: 11, State: 'Georgia', HomePhone: '(818) 555-0976', Skype: 'gretasDXskype', }, { ID: 5, FirstName: 'Brett', LastName: 'Wade', Phone: '(626) 555-0358', Prefix: 'Mr.', Position: 'IT Manager', BirthDate: '1968-12-01', HireDate: '2009-03-06', Email: 'brettw@dx-email.com', Address: '1120 Old Mill Rd.', City: 'Boise', StateID: 13, State: 'Idaho', HomePhone: '(626) 555-5985', Skype: 'brettwDXskype', }, { ID: 6, FirstName: 'Sandra', LastName: 'Johnson', Phone: '(562) 555-2082', Prefix: 'Mrs.', Position: 'Controller', BirthDate: '1974-11-15', HireDate: '2005-05-11', Email: 'sandraj@dx-email.com', Address: '4600 N Virginia Rd.', City: 'Beaver', StateID: 44, State: 'Utah', HomePhone: '(562) 555-8272', Skype: 'sandrajDXskype', }, { ID: 7, FirstName: 'Kevin', LastName: 'Carter', Phone: '(213) 555-2840', Prefix: 'Mr.', Position: 'Shipping Manager', BirthDate: '1978-01-09', HireDate: '2009-08-11', Email: 'kevinc@dx-email.com', Address: '424 N Main St.', City: 'San Diego', StateID: 5, State: 'California', HomePhone: '(213) 555-8038', Skype: 'kevincDXskype', }, { ID: 8, FirstName: 'Cynthia', LastName: 'Stanwick', Phone: '(818) 555-6655', Prefix: 'Ms.', Position: 'HR Assistant', BirthDate: '1985-06-05', HireDate: '2008-03-24', Email: 'cindys@dx-email.com', Address: '2211 Bonita Dr.', City: 'Little Rock', StateID: 4, State: 'Arkansas', HomePhone: '(818) 555-6808', Skype: 'cindysDXskype', }, { ID: 9, FirstName: 'Kent', LastName: 'Samuelson', Phone: '(562) 555-9282', Prefix: 'Dr.', Position: 'Ombudsman', BirthDate: '1972-09-11', HireDate: '2009-04-22', Email: 'kents@dx-email.com', Address: '12100 Mora Dr', City: 'St. Louis', StateID: 26, State: 'Missouri', HomePhone: '(562) 555-1328', Skype: 'kentsDXskype', }, { ID: 10, FirstName: 'Taylor', LastName: 'Riley', Phone: '(310) 555-7276', Prefix: 'Mr.', Position: 'Network Admin', BirthDate: '1982-08-14', HireDate: '2012-04-14', Email: 'taylorr@dx-email.com', Address: '7776 Torreyson Dr', City: 'San Jose', StateID: 5, State: 'California', HomePhone: '(310) 555-9712', Skype: 'taylorrDXskype', }]; @Injectable() export class Service { getEmployees() : Employee[] { return employees; } }
// In real applications, you should not transpile code in the browser. // You can see how to create your own application with Angular and DevExtreme here: // https://js.devexpress.com/Documentation/Guide/Angular_Components/Getting_Started/Create_a_DevExtreme_Application/ window.exports = window.exports || {}; window.config = { transpiler: 'ts', typescriptOptions: { module: 'system', emitDecoratorMetadata: true, experimentalDecorators: true, }, meta: { 'typescript': { 'exports': 'ts', }, 'devextreme/time_zone_utils.js': { 'esModule': true, }, 'devextreme/localization.js': { 'esModule': true, }, 'devextreme/viz/palette.js': { 'esModule': true, }, }, paths: { 'npm:': 'https://unpkg.com/', }, map: { 'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js', 'typescript': 'npm:typescript@4.2.4/lib/typescript.js', '@angular/core': 'npm:@angular/core@12.2.17', '@angular/platform-browser': 'npm:@angular/platform-browser@12.2.17', '@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic@12.2.17', '@angular/forms': 'npm:@angular/forms@12.2.17', '@angular/common': 'npm:@angular/common@12.2.17', '@angular/compiler': 'npm:@angular/compiler@12.2.17', 'tslib': 'npm:tslib@2.6.2/tslib.js', 'rxjs': 'npm:rxjs@7.5.3/dist/bundles/rxjs.umd.js', 'rxjs/operators': 'npm:rxjs@7.5.3/dist/cjs/operators/index.js', 'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js', 'luxon': 'npm:luxon@1.28.1/build/global/luxon.min.js', 'es6-object-assign': 'npm:es6-object-assign@1.1.0', 'devextreme': 'npm:devextreme@23.2.5/cjs', 'devextreme/bundles/dx.all': 'npm:devextreme@23.2.5/bundles/dx.all.js', 'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js', 'devextreme-quill': 'npm:devextreme-quill@1.6.4/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.5', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.51', 'devextreme-angular': 'npm:devextreme-angular@23.2.5', '@devextreme/runtime': 'npm:@devextreme/runtime@3.0.12', 'inferno': 'npm:inferno@7.4.11/dist/inferno.min.js', 'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js', 'inferno-create-element': 'npm:inferno-create-element@7.4.11/dist/inferno-create-element.min.js', 'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js', 'inferno-hydrate': 'npm:inferno-hydrate@7.4.11/dist/inferno-hydrate.min.js', 'inferno-clone-vnode': 'npm:inferno-clone-vnode/dist/inferno-clone-vnode.min.js', 'inferno-create-class': 'npm:inferno-create-class/dist/inferno-create-class.min.js', 'inferno-extras': 'npm:inferno-extras/dist/inferno-extras.min.js', // Prettier 'prettier/standalone': 'npm:prettier@2.8.4/standalone.js', 'prettier/parser-html': 'npm:prettier@2.8.4/parser-html.js', }, packages: { 'app': { main: './app.component.ts', defaultExtension: 'ts', }, 'devextreme': { defaultExtension: 'js', }, 'devextreme/events/utils': { main: 'index', }, 'devextreme/events': { main: 'index', }, 'es6-object-assign': { main: './index.js', defaultExtension: 'js', }, 'rxjs': { defaultExtension: 'js', }, 'rxjs/operators': { defaultExtension: 'js', }, }, packageConfigPaths: [ 'npm:@devextreme/*/package.json', 'npm:@devextreme/runtime@3.0.12/inferno/package.json', 'npm:@angular/*/package.json', 'npm:@angular/common@12.2.17/*/package.json', 'npm:rxjs@7.5.3/package.json', 'npm:rxjs@7.5.3/operators/package.json', 'npm:devextreme-angular@23.2.5/*/package.json', 'npm:devextreme-angular@23.2.5/ui/*/package.json', 'npm:devextreme-angular@23.2.5/package.json', 'npm:devexpress-diagram@2.2.5/package.json', 'npm:devexpress-gantt@4.1.51/package.json', ], }; System.config(window.config);
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/23.2.5/css/dx.light.css" /> <script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script> <script src="https://unpkg.com/zone.js@0.12.0/dist/zone.js"></script> <script src="https://unpkg.com/reflect-metadata@0.1.13/Reflect.js"></script> <script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script> <script src="config.js"></script> <script> System.import("app").catch(console.error.bind(console)); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <demo-app>Loading...</demo-app> </div> </body> </html>