Skip to content

Commit dbde6c0

Browse files
Grids: Add missing focusedRow info (DevExpress#8134) (DevExpress#8144)
1 parent 601fc93 commit dbde6c0

File tree

3 files changed

+5
-3
lines changed

3 files changed

+5
-3
lines changed

api-reference/10 UI Components/GridBase/1 Configuration/autoNavigateToFocusedRow.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,8 @@ Automatically scrolls the component to the focused row when the [focusedRowKey](
1212
[note]
1313

1414
- You must specify the component [height](/api-reference/10%20UI%20Components/DOMComponent/1%20Configuration/height.md '/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/#height') to ensure **autoNavigateToFocusedRow** works correctly.
15-
- When **autoNavigateToFocusedRow** is disabled, the default browser scrolling behavior remains in effect. If you focus a row that is loaded in the {WidgetName} container, the browser scrolls to the focused row.
15+
- When **autoNavigateToFocusedRow** is `true`, {WidgetName} sorts records by key on data load if remote [filtering]({basewidgetpath}/Configuration/remoteOperations/#filtering), [sorting]({basewidgetpath}/Configuration/remoteOperations/#sorting), and [paging]({basewidgetpath}/Configuration/remoteOperations/#paging) are enabled.
16+
- When **autoNavigateToFocusedRow** is disabled, default browser scrolling behavior remains in effect. If you focus a row that is loaded in the {WidgetName} container, the browser scrolls to the focused row.
1617

1718
[/note]
1819

api-reference/10 UI Components/GridBase/1 Configuration/focusedRowEnabled.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ Specifies whether the focused row feature is enabled.
1010
---
1111
The component relies on the key ([focusedRowKey](/api-reference/10%20UI%20Components/GridBase/1%20Configuration/focusedRowKey.md '{basewidgetpath}/Configuration/#focusedRowKey')) or index ([focusedRowIndex](/api-reference/10%20UI%20Components/GridBase/1%20Configuration/focusedRowIndex.md '{basewidgetpath}/Configuration/#focusedRowIndex')) of the focused row to maintain focus. Specify the key to ensure the focused row feature works correctly, as row indexes can change due to filtering or sorting operations. Utilize [keyExpr](/api-reference/10%20UI%20Components/dxDataGrid/1%20Configuration/keyExpr.md '{basewidgetpath}/Configuration/#keyExpr') or the **key** property of the component's [store](/concepts/70%20Data%20Binding/5%20Data%20Layer/1%20Creating%20DataSource/3%20What%20Are%20Stores.md '/Documentation/Guide/Data_Binding/Data_Layer/#Creating_DataSource/What_Are_Stores').
1212

13-
[note] The focused row can change if it is hidden by filtering or searching operations. To maintain focus on the same row through filtering and searching operations, set [selection](/api-reference/10%20UI%20Components/GridBase/1%20Configuration/selection '{basewidgetpath}/Configuration/selection/').[mode](/api-reference/10%20UI%20Components/GridBase/1%20Configuration/selection/mode.md '{basewidgetpath}/Configuration/selection/#mode') to "single" instead of enabling **focusedRowEnabled**.
13+
[note] The focused row can change if it is hidden by filtering or searching operations. To maintain focus on the same row through those operations, set [selection](/api-reference/10%20UI%20Components/GridBase/1%20Configuration/selection '{basewidgetpath}/Configuration/selection/').[mode](/api-reference/10%20UI%20Components/GridBase/1%20Configuration/selection/mode.md '{basewidgetpath}/Configuration/selection/#mode') to "single" instead of enabling **focusedRowEnabled**.
1414

15-
The component navigates to the page of the focused row and scrolls to it automatically when you modify **focusedRowKey** or **focusedRowIndex**. Assign `false` to [autoNavigateToFocusedRow](/api-reference/10%20UI%20Components/GridBase/1%20Configuration/autoNavigateToFocusedRow.md '{basewidgetpath}/Configuration/#autoNavigateToFocusedRow') to disable this behavior.
15+
If **focusedRowEnabled** is `true`, the component navigates to the page of the focused row and scrolls to it automatically when you modify **focusedRowKey** or **focusedRowIndex**. {WidgetName} also sorts records by key on data load when remote [filtering]({basewidgetpath}/Configuration/remoteOperations/#filtering), [sorting]({basewidgetpath}/Configuration/remoteOperations/#sorting), and [paging]({basewidgetpath}/Configuration/remoteOperations/#paging) are enabled. Assign `false` to [autoNavigateToFocusedRow](/api-reference/10%20UI%20Components/GridBase/1%20Configuration/autoNavigateToFocusedRow.md '{basewidgetpath}/Configuration/#autoNavigateToFocusedRow') to disable these behaviors.
1616

1717
{WidgetName} generates requests with comparison operators (such as `<` and `>`) to calculate the page number of the focused row. This logic does not work for certain key types (such as GUID) and data providers (such as ODataStore). Disable [remoteOperations](/api-reference/10%20UI%20Components/dxDataGrid/1%20Configuration/remoteOperations '/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/remoteOperations/') to ensure the component navigates to the focused row correctly.
1818

api-reference/10 UI Components/dxDataGrid/1 Configuration/autoNavigateToFocusedRow.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ Automatically scrolls the component to the focused row when the [focusedRowKey](
77
[note]
88

99
- You must specify the component [height](/api-reference/10%20UI%20Components/DOMComponent/1%20Configuration/height.md '/Documentation/ApiReference/UI_Components/dxTreeList/Configuration/#height') to ensure **autoNavigateToFocusedRow** works correctly.
10+
- When **autoNavigateToFocusedRow** is `true`, {WidgetName} sorts records by key on data load if remote [filtering](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/remoteOperations/#filtering), [sorting](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/remoteOperations/#sorting), and [paging](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/remoteOperations/#paging) are enabled.
1011
- When **autoNavigateToFocusedRow** is disabled, the default browser scrolling behavior remains in effect. If you focus a row that is loaded in the {WidgetName} container, the browser scrolls to the focused row.
1112

1213
[/note]

0 commit comments

Comments
 (0)