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.
Thank you for the feedback!
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Backend API
import React from 'react';
import { DataGrid, Column, Paging } from 'devextreme-react/data-grid';
import { NumberBox } from 'devextreme-react/number-box';
import { CheckBox } from 'devextreme-react/check-box';
import 'devextreme/data/odata/store';
const focusedRowKeyLabel = { 'aria-label': 'Focused Row Key' };
const dataSourceOptions = {
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',
],
};
class App extends React.Component {
constructor(props) {
super(props);
this.state = {
taskSubject: '',
taskDetails: '',
taskStatus: '',
taskProgress: '',
focusedRowKey: 117,
autoNavigateToFocusedRow: true,
};
this.onFocusedRowChanged = this.onFocusedRowChanged.bind(this);
this.onTaskIdChanged = this.onTaskIdChanged.bind(this);
this.onAutoNavigateToFocusedRowChanged = this.onAutoNavigateToFocusedRowChanged.bind(this);
}
onTaskIdChanged(e) {
if (e.event && e.value > 0) {
this.setState({ focusedRowKey: e.value });
}
}
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 dataRow = e.row && e.row.data;
const progress = dataRow && dataRow.Task_Completion ? `${dataRow.Task_Completion}%` : '';
this.setState({
taskSubject: dataRow && dataRow.Task_Subject,
taskDetails: dataRow && dataRow.Task_Description,
taskStatus: dataRow && dataRow.Task_Status,
taskProgress: progress,
focusedRowKey: e.component.option('focusedRowKey'),
});
}
onAutoNavigateToFocusedRowChanged(e) {
this.setState({ autoNavigateToFocusedRow: e.value });
}
render() {
return (
<div>
<DataGrid
id="gridContainer"
dataSource={dataSourceOptions}
focusedRowEnabled={true}
focusedRowKey={this.state.focusedRowKey}
autoNavigateToFocusedRow={this.state.autoNavigateToFocusedRow}
onFocusedRowChanging={this.onFocusedRowChanging}
onFocusedRowChanged={this.onFocusedRowChanged}
showBorders={true}>
<Paging defaultPageSize={10} />
<Column
dataField="Task_ID"
width={80} />
<Column
caption="Start Date"
dataField="Task_Start_Date"
dataType="date" />
<Column
caption="Assigned To"
dataField="ResponsibleEmployee.Employee_Full_Name"
dataType="date"
allowSorting={false}
/>
<Column
caption="Subject"
dataField="Task_Subject"
width={350} />
<Column
caption="Status"
dataField="Task_Status" />
</DataGrid>
<div className="task-info">
<div className="info">
<div id="taskSubject">{this.state.taskSubject}</div>
<p id="taskDetails" dangerouslySetInnerHTML={{ __html: this.state.taskDetails }}></p>
</div>
<div className="progress">
<span id="taskStatus">{this.state.taskStatus}</span>
<span id="taskProgress">{this.state.taskProgress}</span>
</div>
</div>
<div className="options">
<div className="caption">Options</div>
<div className="options-container">
<div className="option">
<span>Focused Row Key </span>
<NumberBox
id="taskId"
min={1}
max={183}
step={0}
value={this.state.focusedRowKey}
inputAttr={focusedRowKeyLabel}
onValueChanged={this.onTaskIdChanged}>
</NumberBox>
</div>
<div className="option">
<CheckBox
text="Auto Navigate To Focused Row"
value={this.state.autoNavigateToFocusedRow}
onValueChanged={this.onAutoNavigateToFocusedRowChanged}>
</CheckBox>
</div>
</div>
</div>
</div>
);
}
}
export default App;
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.js';
ReactDOM.render(
<App />,
document.getElementById('app'),
);
<!DOCTYPE html>
<html>
<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.1.5/css/dx.light.css" />
<link rel="stylesheet" type="text/css" href="styles.css" />
<script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script>
<script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script>
<script type="text/javascript" src="config.js"></script>
<script type="text/javascript">
System.import("./index.js");
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<div id="app"></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;
}
.options-container {
display: flex;
align-items: center;
}
window.exports = window.exports || {};
window.config = {
transpiler: 'plugin-babel',
meta: {
'devextreme/localization.js': {
'esModule': true,
},
'devextreme-aspnet-data-nojquery': {
'esModule': true,
},
},
paths: {
'npm:': 'https://unpkg.com/',
},
defaultExtension: 'js',
map: {
'react': 'npm:react@17.0.2/umd/react.development.js',
'react-dom': 'npm:react-dom@17.0.2/umd/react-dom.development.js',
'prop-types': 'npm:prop-types@15.8.1/prop-types.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.1/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign@1.1.0',
'devextreme': 'npm:devextreme@23.1.6/cjs',
'devextreme-react': 'npm:devextreme-react@23.1.6',
'jszip': 'npm:jszip@3.7.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.6.2/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.2.2/dist/dx-diagram.js',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.49/dist/dx-gantt.js',
'@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',
// SystemJS plugins
'plugin-babel': 'npm:systemjs-plugin-babel@0.0.25/plugin-babel.js',
'systemjs-babel-build': 'npm:systemjs-plugin-babel@0.0.25/systemjs-babel-browser.js',
// Prettier
'prettier/standalone': 'npm:prettier@2.8.4/standalone.js',
'prettier/parser-html': 'npm:prettier@2.8.4/parser-html.js',
},
packages: {
'devextreme': {
defaultExtension: 'js',
},
'devextreme-react': {
main: 'index.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@3.0.12/inferno/package.json',
],
babelOptions: {
sourceMaps: false,
stage0: true,
react: true,
},
};
System.config(window.config);