Focused Row
The DataGrid component can highlight the focused row. To enable this feature, set the focusedRowEnabled property to true.
To focus a row programmatically, specify the focusedRowKey property. The DataGrid automatically scrolls to the focused row if the autoNavigateToFocusedRow property is enabled. In the UI, users can click a row to focus it. The focused row is saved in the DataGrid's state.
You can use the onFocusedRowChanging or onFocusedRowChanged property to specify a custom function that is executed before or after a row is focused.
In this demo, the row with the 117 key is focused initially. You can specify the focusedRowKey and autoNavigateToFocusedRow properties via the input field and the checkbox below the DataGrid.
Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you!
We appreciate your feedback.
We appreciate your feedback.
<dx-data-grid
id="gridContainer"
[dataSource]="dataSource"
[columns]="columns"
[showBorders]="true"
[focusedRowEnabled]="true"
[(focusedRowKey)]="focusedRowKey"
[(autoNavigateToFocusedRow)]="autoNavigateToFocusedRow"
(onFocusedRowChanging)="onFocusedRowChanging($event)"
(onFocusedRowChanged)="onFocusedRowChanged($event)"
>
<dxo-paging [pageSize]="10"> </dxo-paging>
</dx-data-grid>
<div class="task-info">
<div class="info">
<div id="taskSubject">{{ taskSubject }}</div>
<p id="taskDetails" [innerHtml]="taskDetailsHtml"></p>
</div>
<div class="progress">
<span id="taskStatus">{{ taskStatus }}</span>
<span id="taskProgress">{{ taskProgress }}</span>
</div>
</div>
<div class="options">
<div class="caption">Options</div>
<div class="options-container">
<div class="option">
<span>Focused Row Key</span>
<dx-number-box
id="taskId"
min="1"
max="183"
step="0"
[(value)]="focusedRowKey"
>
</dx-number-box>
</div>
<div class="option">
<dx-check-box
[text]="'Auto Navigate To Focused Row'"
[(value)]="autoNavigateToFocusedRow"
>
</dx-check-box>
</div>
</div>
</div>
import {
NgModule, Component, ViewChild, enableProdMode,
} from '@angular/core';
import { BrowserModule, DomSanitizer, SafeHtml } from '@angular/platform-browser';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import {
DxDataGridComponent,
DxNumberBoxComponent,
DxDataGridModule,
DxNumberBoxModule,
DxCheckBoxModule,
} from 'devextreme-angular';
import 'devextreme/data/odata/store';
if (!/localhost/.test(document.location.host)) {
enableProdMode();
}
@Component({
selector: 'demo-app',
templateUrl: 'app/app.component.html',
styleUrls: ['app/app.component.css'],
preserveWhitespaces: true,
})
export class AppComponent {
@ViewChild(DxDataGridComponent, { static: false }) dataGrid: DxDataGridComponent;
@ViewChild(DxNumberBoxComponent, { static: false }) numberBox: DxNumberBoxComponent;
columns: any;
dataSource: any;
isReady: boolean;
taskSubject: string;
taskDetailsHtml: SafeHtml;
taskStatus: string;
taskProgress: string;
focusedRowKey = 117;
autoNavigateToFocusedRow = true;
constructor(private sanitizer: DomSanitizer) {
this.dataSource = {
store: {
type: 'odata',
key: 'Task_ID',
url: 'https://js.devexpress.com/Demos/DevAV/odata/Tasks',
},
expand: 'ResponsibleEmployee',
select: [
'Task_ID',
'Task_Subject',
'Task_Start_Date',
'Task_Status',
'Task_Description',
'Task_Completion',
'ResponsibleEmployee/Employee_Full_Name',
],
};
this.columns = [
{
dataField: 'Task_ID',
width: 80,
}, {
caption: 'Start Date',
dataField: 'Task_Start_Date',
dataType: 'date',
}, {
caption: 'Assigned To',
dataField: 'ResponsibleEmployee.Employee_Full_Name',
cssClass: 'employee',
allowSorting: false,
}, {
caption: 'Subject',
dataField: 'Task_Subject',
width: 350,
}, {
caption: 'Status',
dataField: 'Task_Status',
},
];
}
onFocusedRowChanging(e) {
const rowsCount = e.component.getVisibleRows().length;
const pageCount = e.component.pageCount();
const pageIndex = e.component.pageIndex();
const key = e.event && e.event.key;
if (key && e.prevRowIndex === e.newRowIndex) {
if (e.newRowIndex === rowsCount - 1 && pageIndex < pageCount - 1) {
e.component.pageIndex(pageIndex + 1).done(() => {
e.component.option('focusedRowIndex', 0);
});
} else if (e.newRowIndex === 0 && pageIndex > 0) {
e.component.pageIndex(pageIndex - 1).done(() => {
e.component.option('focusedRowIndex', rowsCount - 1);
});
}
}
}
onFocusedRowChanged(e) {
const rowData = e.row && e.row.data;
if (rowData) {
this.taskSubject = rowData.Task_Subject;
this.taskDetailsHtml = this.sanitizer.bypassSecurityTrustHtml(rowData.Task_Description);
this.taskStatus = rowData.Task_Status;
this.taskProgress = rowData.Task_Completion ? `${rowData.Task_Completion}` + '%' : '';
}
}
}
@NgModule({
imports: [
BrowserModule,
DxDataGridModule,
DxNumberBoxModule,
DxCheckBoxModule,
],
declarations: [AppComponent],
bootstrap: [AppComponent],
})
export class AppModule { }
platformBrowserDynamic().bootstrapModule(AppModule);
.task-info {
font-family: Segoe UI;
min-height: 200px;
display: flex;
flex-wrap: nowrap;
border: 2px solid rgba(0, 0, 0, 0.1);
padding: 16px;
box-sizing: border-box;
align-items: baseline;
justify-content: space-between;
}
#taskSubject {
line-height: 29px;
font-size: 18px;
font-weight: bold;
}
#taskDetails {
line-height: 22px;
font-size: 14px;
margin-top: 0;
margin-bottom: 0;
}
.progress {
display: flex;
flex-direction: column;
white-space: pre;
min-width: 105px;
}
.info {
margin-right: 40px;
}
#taskProgress {
line-height: 42px;
font-size: 40px;
font-weight: bold;
}
.options {
margin-top: 20px;
padding: 20px;
background-color: rgba(191, 191, 191, 0.15);
position: relative;
}
.caption {
font-size: 18px;
font-weight: 500;
}
.option {
margin-top: 10px;
margin-right: 40px;
display: inline-block;
}
.option:last-child {
margin-right: 0;
}
.option > .dx-numberbox {
width: 200px;
display: inline-block;
vertical-align: middle;
}
.option > span {
margin-right: 10px;
}
.options-container {
display: flex;
align-items: center;
}
// 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.config = {
transpiler: 'ts',
typescriptOptions: {
module: 'system',
emitDecoratorMetadata: true,
experimentalDecorators: true,
},
meta: {
'typescript': {
'exports': 'ts',
},
'devextreme-aspnet-data-nojquery': {
'esModule': true,
},
'devextreme/localization.js': {
'esModule': true,
},
},
paths: {
'npm:': 'https://unpkg.com/',
},
map: {
'ts': 'npm:plugin-typescript@8.0.0/lib/plugin.js',
'typescript': 'npm:typescript@3.5.3/lib/typescript.js',
'@angular/core': 'npm:@angular/core@12.2.13',
'@angular/platform-browser': 'npm:@angular/platform-browser@12.2.13',
'@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic@12.2.13',
'@angular/forms': 'npm:@angular/forms@12.2.13',
'@angular/common/http': 'npm:@angular/common@12.2.13/bundles/common-http.umd.js',
'@angular/common': 'npm:@angular/common@12.2.13',
'@angular/compiler': 'npm:@angular/compiler@12.2.13',
'tslib': 'npm:tslib@2.3.1/tslib.js',
'rxjs': 'npm:rxjs@6.4.0',
'devextreme-aspnet-data-nojquery': 'npm:devextreme-aspnet-data-nojquery@2.8.4/index.js',
'rrule': 'npm:rrule@2.6.6/dist/es5/rrule.js',
'luxon': 'npm:luxon@1.28.0/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign@1.1.0',
'devextreme': 'npm:devextreme@21.2.3/cjs',
'devextreme/bundles/dx.all': 'npm:devextreme@21.2.3/bundles/dx.all.js',
'jszip': 'npm:jszip@3.7.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.5.5/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.1.37',
'devexpress-gantt': 'npm:devexpress-gantt@3.1.24',
'devextreme-angular': 'npm:devextreme-angular@21.2.3',
'@devextreme/vdom': 'npm:@devextreme/vdom@2.2.3',
'@devextreme/runtime': 'npm:@devextreme/runtime@2.3.8',
'inferno': 'npm:inferno@7.4.10/dist/inferno.min.js',
'inferno-compat': 'npm:inferno-compat@7.4.10/dist/inferno-compat.min.js',
'inferno-create-element': 'npm:inferno-create-element@7.4.10/dist/inferno-create-element.min.js',
'inferno-dom': 'npm:inferno-dom@1.0.7/dist/inferno-dom.min.js',
'inferno-hydrate': 'npm:inferno-hydrate@7.4.10/dist/inferno-hydrate.min.js',
'inferno-clone-vnode': 'npm:inferno-clone-vnode@7.4.10/dist/inferno-clone-vnode.min.js',
'inferno-create-class': 'npm:inferno-create-class@7.4.10/dist/inferno-create-class.min.js',
'inferno-extras': 'npm:inferno-extras@7.4.10/dist/inferno-extras.min.js',
},
packages: {
'app': {
main: './app.component.ts',
defaultExtension: 'ts',
},
'devextreme': {
defaultExtension: 'js',
},
'@devextreme/vdom': {
defaultExtension: 'js',
},
'devextreme/events/utils': {
main: 'index',
},
'devextreme/events': {
main: 'index',
},
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js',
},
},
packageConfigPaths: [
'npm:@devextreme/*/package.json',
'npm:@devextreme/runtime@2.3.8/inferno/package.json',
'npm:@angular/*/package.json',
'npm:@angular/common/*/package.json',
'npm:rxjs@6.4.0/package.json',
'npm:rxjs@6.4.0/operators/package.json',
'npm:devextreme-angular/*/package.json',
'npm:devextreme-angular@21.2.3/ui/*/package.json',
'npm:devextreme-angular@21.2.3/package.json',
'npm:devexpress-diagram@2.1.37/package.json',
'npm:devexpress-gantt@3.1.24/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/21.2.3/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/21.2.3/css/dx.light.css" />
<script src="https://unpkg.com/core-js@2.4.1/client/shim.min.js"></script>
<script src="https://unpkg.com/zone.js@0.11.4/dist/zone.js"></script>
<script src="https://unpkg.com/reflect-metadata@0.1.3/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>