Pagination: Add showPageSizeSelector: 'auto' info (#8015) (#8159)

Author: arman-boyakhchyan

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 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/",
     name: "DataGrid"

api-reference/10 UI Components/dxPagination/1 Configuration/itemCount.md

@@ -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 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)
+- [showPageSizeSelector](/Documentation/ApiReference/UI_Components/dxPagination/Configuration/#showPageSizeSelector)
+
+[/note]
 
 #include btn-open-demo with {
     href: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/Pagination/Overview/"

api-reference/10 UI Components/dxPagination/1 Configuration/pageSize.md

@@ -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/"
 }

api-reference/10 UI Components/dxPagination/1 Configuration/showPageSizeSelector.md

@@ -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`.

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`.