Skip to content

Pagination: Add showPageSizeSelector: 'auto' info #8015

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Nov 5, 2025
+34 −6
Merged

Pagination: Add showPageSizeSelector: 'auto' info #8015

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
23f62b6
Pagination: Add showPageSizeSelector: 'auto' info
arman-boyakhchyan Sep 17, 2025
ad7a19b
Finalize content
arman-boyakhchyan Sep 18, 2025
9e193dd
Add final updates
arman-boyakhchyan Nov 5, 2025
5636c62
Apply suggestions from code review
arman-boyakhchyan Nov 5, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion ...ference/10 UI Components/GridBase/1 Configuration/pager/showPageSizeSelector.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand Down
12 changes: 11 additions & 1 deletion api-reference/10 UI Components/dxPagination/1 Configuration/itemCount.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,17 @@ 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]

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](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#showInfo)
- [showNavigationButtons](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#showNavigationButtons)
- [showPageSizeSelector](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#showPageSizeSelector)

[/note]

#include btn-open-demo with {
href: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/Pagination/Overview/"
Expand Down
11 changes: 11 additions & 0 deletions api-reference/10 UI Components/dxPagination/1 Configuration/pageSize.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,17 @@ default: 5
Specifies the page size.

---

[note]

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](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#showInfo)
- [showNavigationButtons](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#showNavigationButtons)
- [showPageSizeSelector](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#showPageSizeSelector)

[/note]

#include btn-open-demo with {
href: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/Pagination/Overview/"
}
8 changes: 5 additions & 3 deletions ...reference/10 UI Components/dxPagination/1 Configuration/showPageSizeSelector.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,12 @@
---
id: dxPagination.Options.showPageSizeSelector
type: Boolean
default: false
type: Boolean | Enums.Mode
default: 'auto'
---
---
##### shortDescription
Specifies whether to show the page size selector.
Specifies page size selector visibility.

---

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`.
4 changes: 3 additions & 1 deletion api-reference/40 Common Types/PagerBase/showPageSizeSelector.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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`.
Loading