Focused Row
The TreeList 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 TreeList automatically scrolls to the focused row. You can set the autoNavigateToFocusedRow property to false to deactivate this behavior. In the UI, users can click a row to focus it. The focused row is saved in the TreeList's state.
You can use the onFocusedRowChanging and onFocusedRowChanged properties to specify a custom function that is executed before or after a row is focused.
In this demo, the row with the 4 key is focused initially. You can specify the focusedRowKey property via the input field below the TreeList. The onFocusedRowChanged function is used to display additional information below the component when the focused row changes.
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-tree-list
id="treeList"
[dataSource]="dataSource"
parentIdExpr="Task_Parent_ID"
wordWrapEnabled="true"
showBorders="true"
focusedRowEnabled="true"
hasItemsExpr="Has_Items"
[(focusedRowKey)]="focusedRowKey"
(onFocusedRowChanged)="onFocusedRowChanged($event)"
>
<dxo-remote-operations
[filtering]="true"
[sorting]="true"
[grouping]="true"
></dxo-remote-operations>
<dxi-column dataField="Task_ID" width="100" alignment="left"></dxi-column>
<dxi-column
dataField="Task_Assigned_Employee_ID"
caption="Assigned"
minWidth="120"
>
<dxo-lookup
[dataSource]="taskEmployees"
valueExpr="ID"
displayExpr="Name"
></dxo-lookup>
</dxi-column>
<dxi-column dataField="Task_Status" caption="Status" width="160"></dxi-column>
<dxi-column
dataField="Task_Start_Date"
caption="Start Date"
dataType="date"
width="160"
></dxi-column>
<dxi-column
dataField="Task_Due_Date"
caption="Due Date"
dataType="date"
width="160"
></dxi-column>
</dx-tree-list>
<div class="task-info">
<div class="info">
<div class="task-subject">{{ taskSubject }}</div>
<span class="task-assigned">{{ taskAssigned }}</span>
<span class="start-date">{{ startDate }}</span>
</div>
<div class="progress">
<span class="task-status">{{ taskStatus }}</span>
<span class="task-progress">{{ taskProgress }}</span>
</div>
</div>
<div class="options">
<div class="caption">Options</div>
<div class="option">
<span>Focused row key</span>
<dx-number-box
id="taskId"
min="1"
max="182"
step="0"
[(value)]="focusedRowKey"
>
</dx-number-box>
</div>
</div>
import {
NgModule, Component, ViewChild, enableProdMode,
} from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import { DxTreeListModule, DxNumberBoxModule } from 'devextreme-angular';
import * as AspNetData from 'devextreme-aspnet-data-nojquery';
if (!/localhost/.test(document.location.host)) {
enableProdMode();
}
const url = 'https://js.devexpress.com/Demos/Mvc/api/TreeListTasks';
@Component({
selector: 'demo-app',
templateUrl: 'app/app.component.html',
styleUrls: ['app/app.component.css'],
preserveWhitespaces: true,
})
export class AppComponent {
columns: any;
dataSource: any;
taskEmployees: any;
taskSubject: string;
taskAssigned: string;
startDate: string;
taskStatus: string;
taskProgress: string;
focusedRowKey: number;
constructor() {
this.focusedRowKey = 4;
this.dataSource = AspNetData.createStore({
key: 'Task_ID',
loadUrl: `${url}/Tasks`,
onBeforeSend(_, ajaxOptions) {
ajaxOptions.xhrFields = { withCredentials: true };
},
});
this.taskEmployees = AspNetData.createStore({
key: 'ID',
loadMode: 'raw',
loadUrl: `${url}/TaskEmployees`,
});
}
onFocusedRowChanged(e) {
const rowData = e.row && e.row.data;
let cellValue;
let assigned;
if (rowData) {
cellValue = e.component.cellValue(e.row.rowIndex, 'Assigned');
this.taskEmployees.byKey(cellValue).done((item) => {
assigned = item.Name;
});
this.taskSubject = rowData.Task_Subject;
this.taskAssigned = assigned;
this.startDate = new Date(rowData.Task_Start_Date).toLocaleDateString();
this.taskStatus = rowData.Task_Status;
this.taskProgress = rowData.Task_Completion ? `${rowData.Task_Completion}%` : '';
}
}
}
@NgModule({
imports: [
BrowserModule,
DxTreeListModule,
DxNumberBoxModule,
],
declarations: [AppComponent],
bootstrap: [AppComponent],
})
export class AppModule { }
platformBrowserDynamic().bootstrapModule(AppModule);
#treeList {
max-height: 400px;
}
.task-info {
font-family: Segoe UI;
min-height: 100px;
display: flex;
flex-wrap: nowrap;
border: 2px solid rgba(0, 0, 0, 0.1);
padding: 16px;
box-sizing: border-box;
align-items: center;
justify-content: space-between;
}
.info {
display: flex;
flex-direction: column;
}
.task-subject {
line-height: 29px;
font-size: 18px;
font-weight: bold;
}
.progress {
display: flex;
flex-direction: column;
white-space: pre;
min-width: 105px;
}
.task-progress {
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;
}
.option > .dx-numberbox {
width: 200px;
display: inline-block;
vertical-align: middle;
}
.option > span {
margin-right: 10px;
}
// 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@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.3.1/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',
'devextreme-aspnet-data-nojquery': 'npm:devextreme-aspnet-data-nojquery@2.9.0/index.js',
'rrule': 'npm:rrule@2.6.4/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@22.2.6/cjs',
'devextreme/bundles/dx.all': 'npm:devextreme@22.2.6/bundles/dx.all.js',
'jszip': 'npm:jszip@3.7.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.5.20/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.1.72',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.43',
'devextreme-angular': 'npm:devextreme-angular@22.2.6',
'@devextreme/runtime': 'npm:@devextreme/runtime@3.0.11',
'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.11/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@22.2.6/*/package.json',
'npm:devextreme-angular@22.2.6/ui/*/package.json',
'npm:devextreme-angular@22.2.6/package.json',
'npm:devexpress-diagram@2.1.72/package.json',
'npm:devexpress-gantt@4.1.43/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/22.2.6/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.13.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>