Focused Row
Documentation
The DataGrid widget can highlight the focused row. To enable this feature, set the focusedRowEnabled option to true.
To focus a row programmatically, specify the focusedRowKey option. In the UI, users can click a row to focus it. To focus a row in code, specify the focusedRowKey option. The widget automatically scrolls to the focused row if the autoNavigateToFocusedRow option is enabled. The focused row is saved in the widget's state.
You can use the onFocusedRowChanging or onFocusedRowChanged option 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 options via the input field and the checkbox below the widget.
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.
var DemoApp = angular.module('DemoApp', ['dx', 'ngSanitize']);
DemoApp.controller('DemoController', function DemoController($scope) {
$scope.dataGrid;
$scope.focusedRowKey = 117;
$scope.taskSubject = "";
$scope.taskDetailsHtml ="";
$scope.taskStatus = "";
$scope.taskProgress = "";
$scope.autoNavigateToFocusedRow = true;
$scope.dataGridOptions = {
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'
]
},
bindingOptions: {
focusedRowKey: 'focusedRowKey',
autoNavigateToFocusedRow: 'autoNavigateToFocusedRow'
},
focusedRowEnabled: true,
showBorders: true,
paging: {
pageSize: 10
},
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"
}
],
onInitialized: function(e) {
$scope.dataGrid = e.component;
},
onFocusedRowChanging: function(e) {
var rowsCount = e.component.getVisibleRows().length,
pageCount = e.component.pageCount(),
pageIndex = e.component.pageIndex(),
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(function() {
e.component.option("focusedRowIndex", 0);
});
} else if(e.newRowIndex === 0 && pageIndex > 0) {
e.component.pageIndex(pageIndex - 1).done(function() {
e.component.option("focusedRowIndex", rowsCount - 1);
});
}
}
},
onFocusedRowChanged: function(e) {
var rowData = e.row && e.row.data;
if(rowData) {
$scope.taskSubject = rowData.Task_Subject;
$scope.taskDetailsHtml = rowData.Task_Description;
$scope.taskStatus = rowData.Task_Status;
$scope.taskProgress = rowData.Task_Completion ? rowData.Task_Completion + "%" : "";
}
}
};
$scope.focusedRowKeyOptions = {
min: 1,
max: 183,
step: 0,
bindingOptions: {
value: 'focusedRowKey'
}
};
$scope.autoNavigateToFocusedRowOptions = {
text: "Auto Navigate To Focused Row",
bindingOptions: {
value: 'autoNavigateToFocusedRow'
}
};
});
<!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" />
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>
<script>window.jQuery || document.write(decodeURIComponent('%3Cscript src="js/jquery.min.js"%3E%3C/script%3E'))</script>
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/20.1.8/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/20.1.8/css/dx.light.css" />
<link rel="stylesheet" type="text/css" href="styles.css" />
<script src="https://ajax.googleapis.com/ajax/libs/angularjs/1.3.16/angular.min.js"></script>
<script>window.angular || document.write(decodeURIComponent('%3Cscript src="js/angular.min.js"%3E%3C\/script%3E'))</script>
<script src="https://ajax.googleapis.com/ajax/libs/angularjs/1.3.16/angular-sanitize.min.js"></script>
<script>
(function () {
try {
window.angular.module('ngSanitize');
}
catch (e) {
return false;
}
return true;
})() || document.write(decodeURIComponent('%3Cscript src="js/angular-sanitize.min.js"%3E%3C\/script%3E'))
</script>
<script src="https://cdn3.devexpress.com/jslib/20.1.8/js/dx.all.js"></script>
<script src="index.js"></script>
</head>
<body class="dx-viewport">
<div class="demo-container" ng-app="DemoApp" ng-controller="DemoController">
<div id="gridContainer" dx-data-grid="dataGridOptions"></div>
<div class="task-info">
<div class="info">
<div id="taskSubject">{{taskSubject}}</div>
<p id="taskDetails" ng-bind-html="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="option">
<span>Focused Row Key</span>
<div id="taskId" dx-number-box="focusedRowKeyOptions"></div>
</div>
<div class="option">
<div dx-check-box="autoNavigateToFocusedRowOptions"></div>
</div>
</div>
</div>
</body>
</html>
.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;
}