# Pager

**Path:** Components/Data Display

[Back to Documentation Index](http://rubicblazor.skyconis.com/docs.md)

---

Pager

 RbPager is a compact paging navigator for lists, tables, cards, and other paged data views.
 It shows the current paging summary and exposes first, previous, next, and last navigation actions.

 Basic Usage

 A simple pager controlled by local page state and an OnClick callback.

 Show code

 Employee Directory 
 Current page: 3 / 10 
 Visible rows: 51-75 

 Page 3/10 (Total 240) 

 Status Format

 Customize the summary text with FormatInfo when you want a more task-oriented message.

 Show code

 Approval Queue 
 Summary text is produced by FormatInfo . 

 Showing 13-24 of 53 items (2/5) 

 Colors

 Use the Color parameter to align the pager shell with surrounding UI emphasis.

 Show code

 Default 
 Page 1/5 (Total 42) 

 Primary 
 Page 2/5 (Total 42) 

 Warning 
 Page 4/5 (Total 42) 

 Empty State

 When there are no items or page size is zero, the pager disables navigation and reports an empty state.

 Show code

 No Items 
 No records to page. 

 PageSize = 0 
 Page size must be greater than zero. 

 RTL Support

 Local RTL containers keep the surrounding content right-aligned while the pager shell stays left-aligned.

 Show code

 RTL 
 الصفحة 2/5 - الإجمالي 42 

 API

 RbPager

 A paging navigator that renders a summary line together with first, previous, next, and last actions.

 Paging State

 These parameters define the current position and total available page count.

 Parameters

 int PageSize 

 Number of items in a single page. Used together with TotalItemsCount to calculate page count.

 int TotalItemsCount 

 Total item count across all pages.

 int CurrentPage 

 Current 1-based page index. The component normalizes out-of-range values.

 OnClick

 Raised when the user requests a different page.

 Parameters

 EventCallback<int> OnClick 

 Receives the normalized page number selected by the user.

 Summary and Labels

 Customize the visible summary and the button titles used for accessibility and tooltips.

 Parameters

 Func<int, int, int, string> FormatInfo 

 Builds the summary text from current page, total page count, and total item count.

 string FirstPageText = "First"

 Accessible label and tooltip text for the first-page action.

 string PreviousPageText = "Previous"

 Accessible label and tooltip text for the previous-page action.

 string NextPageText = "Next"

 Accessible label and tooltip text for the next-page action.

 string LastPageText = "Last"

 Accessible label and tooltip text for the last-page action.

 Color

 Applies the selected Rubic color theme to the pager shell.

 Parameters

 RbColor Color = RbColor.Default

 Useful when the pager should visually match a card, panel, or highlighted region.

 ✕

 Contents