From 23f62b6a4334e1b4636be9df3c4793d5d263fa18 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Wed, 17 Sep 2025 13:47:35 +0400 Subject: [PATCH 1/4] Pagination: Add showPageSizeSelector: 'auto' info --- .../dxPagination/1 Configuration/itemCount.md | 10 ++++++++++ .../dxPagination/1 Configuration/pageSize.md | 11 +++++++++++ .../1 Configuration/showPageSizeSelector.md | 16 ++++++++++++++-- 3 files changed, 35 insertions(+), 2 deletions(-) diff --git a/api-reference/10 UI Components/dxPagination/1 Configuration/itemCount.md b/api-reference/10 UI Components/dxPagination/1 Configuration/itemCount.md index 0a6aa999dc..d94f5e4f19 100644 --- a/api-reference/10 UI Components/dxPagination/1 Configuration/itemCount.md +++ b/api-reference/10 UI Components/dxPagination/1 Configuration/itemCount.md @@ -10,6 +10,16 @@ Specifies the total number of items. --- `itemCount` is the main configuration setting of the component. Specify the total number of items to ensure the Pagination component functions properly. +[note] + +Pagination hides itself when the [pageSize](/) value is greater than [itemCount](/). To avoid this behavior, assign `true` to at least one of the following properties: + +- [showInfo]() +- [showNavigationButtons]() +- [showPageSizeSelector]() + +[/note] + #include btn-open-demo with { href: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/Pagination/Overview/" } \ No newline at end of file diff --git a/api-reference/10 UI Components/dxPagination/1 Configuration/pageSize.md b/api-reference/10 UI Components/dxPagination/1 Configuration/pageSize.md index 0c3880bbb2..78572f1ea6 100644 --- a/api-reference/10 UI Components/dxPagination/1 Configuration/pageSize.md +++ b/api-reference/10 UI Components/dxPagination/1 Configuration/pageSize.md @@ -9,6 +9,17 @@ default: 5 Specifies the page size. --- + +[note] + +Pagination hides itself when the [pageSize](/) value is greater than [itemCount](/). To avoid this behavior, assign `true` to at least one of the following properties: + +- [showInfo]() +- [showNavigationButtons]() +- [showPageSizeSelector]() + +[/note] + #include btn-open-demo with { href: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/Pagination/Overview/" } \ No newline at end of file diff --git a/api-reference/10 UI Components/dxPagination/1 Configuration/showPageSizeSelector.md b/api-reference/10 UI Components/dxPagination/1 Configuration/showPageSizeSelector.md index 2005a86e7e..3588227e54 100644 --- a/api-reference/10 UI Components/dxPagination/1 Configuration/showPageSizeSelector.md +++ b/api-reference/10 UI Components/dxPagination/1 Configuration/showPageSizeSelector.md @@ -1,10 +1,22 @@ --- id: dxPagination.Options.showPageSizeSelector -type: Boolean -default: false +type: Boolean | Enums.Mode +default: 'auto' --- --- ##### shortDescription Specifies whether to show the page size selector. --- + +The default Pagination behavior is to hide the page size selector if you assign an empty array to [allowedPageSizes](). + +[note] + +Pagination hides itself when the [pageSize](/) value is greater than [itemCount](/). To prevent the component from hiding, set at least one of the following properties to `true`: + +- [showInfo]() +- [showNavigationButtons]() +- [showPageSizeSelector]() + +[/note] \ No newline at end of file From ad7a19bf6d1bc84d4e4b24ec98c99e2cd07a1954 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Thu, 18 Sep 2025 12:28:11 +0400 Subject: [PATCH 2/4] Finalize content --- .../dxPagination/1 Configuration/itemCount.md | 10 +++++----- .../dxPagination/1 Configuration/pageSize.md | 8 ++++---- .../1 Configuration/showPageSizeSelector.md | 14 ++------------ 3 files changed, 11 insertions(+), 21 deletions(-) diff --git a/api-reference/10 UI Components/dxPagination/1 Configuration/itemCount.md b/api-reference/10 UI Components/dxPagination/1 Configuration/itemCount.md index d94f5e4f19..2a2343afe9 100644 --- a/api-reference/10 UI Components/dxPagination/1 Configuration/itemCount.md +++ b/api-reference/10 UI Components/dxPagination/1 Configuration/itemCount.md @@ -8,15 +8,15 @@ default: 1 Specifies the total number of items. --- -`itemCount` is the main configuration setting of the component. Specify the total number of items to ensure the Pagination component functions properly. +Define this property to ensure Pagination functions properly. [note] -Pagination hides itself when the [pageSize](/) value is greater than [itemCount](/). To avoid this behavior, assign `true` to at least one of the following properties: +If the [pageSize](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#pageSize) value is greater than **itemCount**, Pagination hides itself. To avoid this behavior, assign `true` to at least one of the following properties: -- [showInfo]() -- [showNavigationButtons]() -- [showPageSizeSelector]() +- [showInfo](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#showInfo) +- [showNavigationButtons](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#showNavigationButtons) +- [showPageSizeSelector](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#showPageSizeSelector) [/note] diff --git a/api-reference/10 UI Components/dxPagination/1 Configuration/pageSize.md b/api-reference/10 UI Components/dxPagination/1 Configuration/pageSize.md index 78572f1ea6..130f065a2b 100644 --- a/api-reference/10 UI Components/dxPagination/1 Configuration/pageSize.md +++ b/api-reference/10 UI Components/dxPagination/1 Configuration/pageSize.md @@ -12,11 +12,11 @@ Specifies the page size. [note] -Pagination hides itself when the [pageSize](/) value is greater than [itemCount](/). To avoid this behavior, assign `true` to at least one of the following properties: +If the **pageSize** value is greater than [itemCount](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#itemCount), Pagination hides itself. To avoid this behavior, assign `true` to at least one of the following properties: -- [showInfo]() -- [showNavigationButtons]() -- [showPageSizeSelector]() +- [showInfo](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#showInfo) +- [showNavigationButtons](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#showNavigationButtons) +- [showPageSizeSelector](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#showPageSizeSelector) [/note] diff --git a/api-reference/10 UI Components/dxPagination/1 Configuration/showPageSizeSelector.md b/api-reference/10 UI Components/dxPagination/1 Configuration/showPageSizeSelector.md index 3588227e54..851fb48691 100644 --- a/api-reference/10 UI Components/dxPagination/1 Configuration/showPageSizeSelector.md +++ b/api-reference/10 UI Components/dxPagination/1 Configuration/showPageSizeSelector.md @@ -5,18 +5,8 @@ default: 'auto' --- --- ##### shortDescription -Specifies whether to show the page size selector. +Specifies page size selector visibility. --- -The default Pagination behavior is to hide the page size selector if you assign an empty array to [allowedPageSizes](). - -[note] - -Pagination hides itself when the [pageSize](/) value is greater than [itemCount](/). To prevent the component from hiding, set at least one of the following properties to `true`: - -- [showInfo]() -- [showNavigationButtons]() -- [showPageSizeSelector]() - -[/note] \ No newline at end of file +When this property is set to *"auto"*, pagination hides itself if the [pageSize](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#pageSize) value is greater than [itemCount](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#itemCount). To avoid this behavior, set **showPageSizeSelector** to `true`. From 9e193dde7dd91467d90a7399a1b07b1256be8415 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Wed, 5 Nov 2025 13:09:26 +0400 Subject: [PATCH 3/4] Add final updates --- .../GridBase/1 Configuration/pager/showPageSizeSelector.md | 5 ++++- .../dxPagination/1 Configuration/showPageSizeSelector.md | 2 +- .../40 Common Types/PagerBase/showPageSizeSelector.md | 4 +++- 3 files changed, 8 insertions(+), 3 deletions(-) diff --git a/api-reference/10 UI Components/GridBase/1 Configuration/pager/showPageSizeSelector.md b/api-reference/10 UI Components/GridBase/1 Configuration/pager/showPageSizeSelector.md index f7d34ecbda..1c8fde9b6c 100644 --- a/api-reference/10 UI Components/GridBase/1 Configuration/pager/showPageSizeSelector.md +++ b/api-reference/10 UI Components/GridBase/1 Configuration/pager/showPageSizeSelector.md @@ -3,9 +3,12 @@ id: GridBase.Options.pager.showPageSizeSelector --- --- ##### shortDescription -Specifies whether to show the page size selector. +Specifies page size selector visibility. --- + +When this property is set to *"auto"*, the pager hides itself if [pageSize](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#pageSize) is greater than [itemCount](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#itemCount). To avoid this behavior, set **showPageSizeSelector** to `true`. + #include common-demobutton-named with { url: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/DataGrid/RecordPaging/", name: "DataGrid" diff --git a/api-reference/10 UI Components/dxPagination/1 Configuration/showPageSizeSelector.md b/api-reference/10 UI Components/dxPagination/1 Configuration/showPageSizeSelector.md index 851fb48691..e8145cfa42 100644 --- a/api-reference/10 UI Components/dxPagination/1 Configuration/showPageSizeSelector.md +++ b/api-reference/10 UI Components/dxPagination/1 Configuration/showPageSizeSelector.md @@ -9,4 +9,4 @@ Specifies page size selector visibility. --- -When this property is set to *"auto"*, pagination hides itself if the [pageSize](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#pageSize) value is greater than [itemCount](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#itemCount). To avoid this behavior, set **showPageSizeSelector** to `true`. +When this property is set to *"auto"*, Pagination hides itself if [pageSize](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#pageSize) is greater than [itemCount](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#itemCount). To avoid this behavior, set **showPageSizeSelector** to `true`. diff --git a/api-reference/40 Common Types/PagerBase/showPageSizeSelector.md b/api-reference/40 Common Types/PagerBase/showPageSizeSelector.md index cff2afc859..9e43c9fa00 100644 --- a/api-reference/40 Common Types/PagerBase/showPageSizeSelector.md +++ b/api-reference/40 Common Types/PagerBase/showPageSizeSelector.md @@ -5,6 +5,8 @@ default: 'auto' --- --- ##### shortDescription -Specifies whether to show the page size selector. +Specifies page size selector visibility. --- + +When this property is set to *"auto"*, the pager hides itself if [pageSize](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#pageSize) is greater than [itemCount](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#itemCount). To avoid this behavior, set **showPageSizeSelector** to `true`. \ No newline at end of file From 5636c6285032b2d206efb19769ea8bb049b1d745 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Wed, 5 Nov 2025 14:53:22 +0400 Subject: [PATCH 4/4] Apply suggestions from code review Co-authored-by: dirkpieterse --- .../GridBase/1 Configuration/pager/showPageSizeSelector.md | 2 +- .../10 UI Components/dxPagination/1 Configuration/itemCount.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/10 UI Components/GridBase/1 Configuration/pager/showPageSizeSelector.md b/api-reference/10 UI Components/GridBase/1 Configuration/pager/showPageSizeSelector.md index 1c8fde9b6c..c415a7ad73 100644 --- a/api-reference/10 UI Components/GridBase/1 Configuration/pager/showPageSizeSelector.md +++ b/api-reference/10 UI Components/GridBase/1 Configuration/pager/showPageSizeSelector.md @@ -7,7 +7,7 @@ Specifies page size selector visibility. --- -When this property is set to *"auto"*, the pager hides itself if [pageSize](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#pageSize) is greater than [itemCount](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#itemCount). To avoid this behavior, set **showPageSizeSelector** to `true`. +When this property is set to *"auto"*, the pager is hidden if [pageSize](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#pageSize) is greater than [itemCount](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#itemCount). To avoid this behavior, set **showPageSizeSelector** to `true`. #include common-demobutton-named with { url: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/DataGrid/RecordPaging/", diff --git a/api-reference/10 UI Components/dxPagination/1 Configuration/itemCount.md b/api-reference/10 UI Components/dxPagination/1 Configuration/itemCount.md index 2a2343afe9..6532527046 100644 --- a/api-reference/10 UI Components/dxPagination/1 Configuration/itemCount.md +++ b/api-reference/10 UI Components/dxPagination/1 Configuration/itemCount.md @@ -12,7 +12,7 @@ Define this property to ensure Pagination functions properly. [note] -If the [pageSize](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#pageSize) value is greater than **itemCount**, Pagination hides itself. To avoid this behavior, assign `true` to at least one of the following properties: +If the [pageSize](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#pageSize) value is greater than **itemCount**, Pagination is hidden. To avoid this behavior, assign `true` to at least one of the following properties: - [showInfo](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#showInfo) - [showNavigationButtons](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#showNavigationButtons)