Your search did not match any results.
Data Grid

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.

Copy to CodeSandBox
Apply
Reset
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 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) { 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(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 pageSize={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="option"> <span>Focused Row Key </span> <NumberBox id="taskId" min={1} max={183} step={0} value={this.state.focusedRowKey} onValueChanged={this.onTaskIdChanged}> </NumberBox> </div> &nbsp; <div className="option"> <CheckBox text="Auto Navigate To Focused Row" value={this.state.autoNavigateToFocusedRow} onValueChanged={this.onAutoNavigateToFocusedRowChanged}> </CheckBox> </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/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://unpkg.com/core-js@2.4.1/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; }
System.config({ transpiler: 'plugin-babel', meta: { 'devextreme-aspnet-data-nojquery': { "esModule": true }, }, paths: { 'npm:': 'https://unpkg.com/' }, defaultExtension: 'js', map: { 'react': 'npm:react@16/umd/react.development.js', 'react-dom': 'npm:react-dom@16/umd/react-dom.development.js', 'prop-types': 'npm:prop-types/prop-types.js', 'devextreme-aspnet-data-nojquery': 'npm:devextreme-aspnet-data-nojquery@2.6.1', 'devextreme': 'npm:devextreme@20.1', 'devextreme-react': 'npm:devextreme-react@20.1', 'jszip': 'npm:jszip@3.1.3/dist/jszip.min.js', 'quill': 'npm:quill@1.3.7/dist/quill.js', 'devexpress-diagram': 'npm:devexpress-diagram@1.0.17', 'devexpress-gantt': 'npm:devexpress-gantt@1.0.10', // SystemJS plugins 'plugin-babel': 'npm:systemjs-plugin-babel@0/plugin-babel.js', 'systemjs-babel-build': 'npm:systemjs-plugin-babel@0/systemjs-babel-browser.js' }, packages: { 'devextreme': { defaultExtension: 'js' }, 'devextreme-react': { main: 'index.js' }, 'devextreme/events/utils': { main: 'index' }, 'devextreme/events': { main: 'index' }, }, babelOptions: { sourceMaps: false, stage0: true, react: true } });