Pager Blazor API

Pager Properties

NameTypeDefaultDescription
AutoEllipsisPagerAutoEllipsisPagerAutoEllipsis.None

"Manages the display of ellipsis ("...") within the pagination component. Ellipsis buttons appear when there are too many pages to show at once, serving as visual indicators that more pages are available. These buttons help users quickly navigate to distant pages by indicating page ranges that are not currently displayed."
DisabledboolfalseControls whether the pager functionality is active. When enabled, the pager allows navigation through paginated content; when disabled, all content may be displayed at once without pagination.
UnlockKeystring""Retrieves or assigns the unlockKey, a unique code required to activate and access the product's full features.
Localestring"en"Sets or retrieves the current language code (e.g., 'en', 'fr', 'es'). This property determines which set of messages from the messages object will be used for localization or internationalization purposes. Update this property to change the active language displayed to users.
MessagesobjectN/ADefines or retrieves an object containing localized strings used within the widget interface. This property enables the customization of widget text for different languages and regions, allowing for internationalization. It is typically used alongside the locale property to display the appropriate language-specific text based on the user's locale setting.
NavigationButtonsPositionLayoutPositionLayoutPosition.NearManages the placement and alignment of navigation buttons within the user interface, determining their exact position (e.g., top, bottom, left, or right) to ensure optimal usability and layout consistency.
PageIndexint0Retrieves or updates the index of the currently active page. This value indicates which page is currently being displayed, where the index is zero-based (i.e., the first page has an index of 0). Setting this property changes the current page to the specified index.
PageIndexSelectorsint0Specifies the total number of page index selectors (such as page numbers or navigation dots) displayed in the pagination component, allowing users to navigate between different pages of content.
PageSizeint10Retrieves or updates the maximum number of items displayed per page. This determines how many items are visible to the user on a single page of results, commonly used for pagination controls.
PageSizeSelectorDataSourceint[]new int[]{}Specifies the data source that populates the options available in the element’s page size selector dropdown menu. This determines which page size choices are presented to the user for selection.
PagesCountint100Specifies the total count of pages contained within the element, typically used for pagination or indicating how many discrete sections or views are available.
ReadonlyboolfalseWhen the element is set to readonly, users can view its content but cannot modify or input any data. Interaction such as typing, editing, or changing the value is disabled, although users may still be able to highlight and copy the text.
RightToLeftboolfalseSets or retrieves a value that specifies whether the element’s layout is aligned to support right-to-left (RTL) languages, such as Arabic or Hebrew, by enabling RTL text direction and alignment based on the specified locale.
ShowFirstLastNavigationButtonsboolfalseControls the visibility of the 'First' and 'Last' navigation buttons, allowing you to show or hide these buttons in the navigation component.
ShowNavigationButtonLabelsboolfalseReplaces the default icon-based navigation buttons with buttons that display descriptive text labels, making navigation options clearer and more accessible to users.
ShowNavigationInputboolfalseControls the visibility of the navigation input, specifying whether the navigation input component should be shown or hidden in the user interface.
ShowPageIndexSelectorsboolfalseSpecifies whether the page index selectors (such as numbered page buttons or links that allow users to navigate between pages) are visible in the user interface. If set to true, the page index selectors will be displayed; if set to false, they will be hidden.
ShowPageSizeSelectorboolfalseSpecifies whether the page size selector control is visible to the user, allowing them to choose the number of items displayed per page.
ShowPrevNextNavigationButtonsboolfalseControls the visibility of the 'Previous' and 'Next' navigation buttons, determining whether users can navigate backward or forward through the content.
ShowSummaryboolfalseSpecifies whether the page summary section is visible to users. If set to true, the summary will be displayed at the top of the page; if false, the summary section will be hidden.
Themestring""Specifies the theme to be applied to the element. The theme setting controls the overall appearance—including colors, fonts, and visual styles—ensuring a consistent look and feel across the component.
UnfocusableboolfalseWhen set to true, this property prevents the element from receiving keyboard focus, meaning users will be unable to select the element using the Tab key or other keyboard navigation methods.
TotalRecordsintN/AGets or sets the total number of records available for pagination, which determines how many pages the Pager will display and manage. This property is particularly useful when the Pager is integrated into a larger component or application that handles data fetching, as it allows the Pager to correctly calculate page counts and navigation based on the overall dataset size.

Pager Methods

NameTypeArgumentsDescription
FirstvoidN/ASelects the first item in the list or array. This operation targets the element at index 0, retrieving or highlighting it as the initially chosen value.
GetPageIndexAsync()Task<int>'N/A'Gets the &quot;PageIndex&quot; property as Task&lt;int&gt;.
LastvoidN/ASelects the last item in the list or array. This operation retrieves the final element from a collection, regardless of its length. If the list is empty, no item will be selected.
NavigateTovoidobject pageIndexNavigates to a specified item within the collection, allowing direct access based on a unique identifier or index.Args: object pageIndex -
NextvoidN/AAdvances the pagination control to the next available page, allowing users to view additional content.
PrevvoidN/ANavigates to the previous page in a paginated list or component by selecting the preceding pager item.
Refreshvoid'N/A'Refreshes the Blazor Component. Performs a layout of the HTML Elements and recalculates the measurements.
Rendervoid'N/A'Re-renders the Blazor Component. This method will make a full re-render.
StateHasChangedvoid'N/A'Refreshes the state and Re-renders the Blazor Component, if necessary.

Pager Events

NameTypeDescriptionEvent Detail
OnChangeEventCallback<Event>This event is triggered whenever the user selects a different item from the list or dropdown menu. It fires only when the selected item changes, allowing your application to respond to user selection updates, such as displaying additional information, updating content, or triggering related actions based on the newly selected item.N/A
Changedevent PagerChangedEventHandlerThis event is triggered whenever the user selects a different item from the list or dropdown menu. It fires only when the selected item changes, allowing your application to respond to user selection updates, such as displaying additional information, updating content, or triggering related actions based on the newly selected item.PagerChangedEventArgs
OnPageSizeChangedEventCallback<Event>This event is triggered whenever the page size is modified, such as when a user selects a different number of items to display per page. It allows you to respond to changes in the pagination settings, for example by updating the displayed data or adjusting the layout based on the new page size.N/A
PageSizeChangedevent PagerPageSizeChangedEventHandlerThis event is triggered whenever the page size is modified, such as when a user selects a different number of items to display per page. It allows you to respond to changes in the pagination settings, for example by updating the displayed data or adjusting the layout based on the new page size.PagerPageSizeChangedEventArgs

Enums

PagerAutoEllipsis

PagerAutoEllipsis.None
PagerAutoEllipsis.Before
PagerAutoEllipsis.After
PagerAutoEllipsis.Both

LayoutPosition

LayoutPosition.Near
LayoutPosition.Far
LayoutPosition.Both