P.Pager

佩格

這是什麼？

P.Pager 是輕量級包，可以輕鬆地對任何 IEnumerable/IQueryable 進行分頁，將其分成“頁面”，並透過索引抓取特定的“頁面”。它支援Web專案、Winforms、WPF、Window Phone、Silverlight和其他.NET專案。預設配置為> Bootstrap 3.3.1 。

我該如何使用它？

安裝

.Net框架（> 4.5.2）

透過 NuGet 安裝 P.Pager.Mvc。這將自動安裝 P.Pager。

 Install-Package P.Pager.Mvc -Version 3.0.0

.Net核心3到5

透過 NuGet 安裝 P.Pager.Mvc.Core。這將自動安裝 P.Pager。

 Install-Package P.Pager.Mvc.Core -Version 3.0.0

.Net Core 6以上

透過 NuGet 安裝 P.Pager.Mvc.Core。這將自動安裝 P.Pager。

 Install-Package P.Pager.Mvc.Core

在那之後

1. 在控制器程式碼中，從 IEnumerable/IQueryable 呼叫ToPagerList並傳入頁面大小。

 public class HomeController : Controller
{
    readonly DemoData _data ;
    public HomeController ( )
    {
        _data = new DemoData ( ) ;
    }

    public ActionResult Index ( int page = 1 , int pageSize = 10 )
    {
        var pager = _data . GetMembers ( ) . ToPagerList ( page , pageSize ) ;
        // will only contain 10 members max because of the pageSize.
        return View ( pager ) ;
    }
}

2. 將ToPagerList的結果傳遞到您的視圖，您可以在其中列舉它 - 它仍然是 IEnumerable，但僅包含原始資料的子層級。

3. 呼叫Html.Pager ，傳入 Pager 的實例和函數，該函數將為每個頁面產生 URL 以查看分頁控制項。

 //Default Pager options
@Html . Pager ( ( IPager ) Model , page => Url . Action ( "Index" , new { page } ) ) 

呼叫器選項

渲染分頁的預設選項。

特性

選項	類型	概括	預設
顯示第一頁	呼叫器顯示模式	如果設定為“始終”，則呈現指向清單中第一頁的超連結。如果設定為 IfNeeded，則僅當第一頁在分頁控制項中不可見時才呈現超連結。	如果需要的話
顯示最後一頁	呼叫器顯示模式	如果設定為“始終”，則呈現指向清單中最後一頁的超連結。如果設定為 IfNeeded，則僅當最後一頁在分頁控制項中不可見時才呈現超連結。	如果需要的話
顯示上一頁	呼叫器顯示模式	如果設定為“始終”，則呈現指向清單上一頁的超連結。如果設定為 IfNeeded，則僅當清單中存在上一頁時才呈現超連結。	如果需要的話
顯示下一頁	呼叫器顯示模式	如果設定為“始終”，則呈現指向清單下一頁的超連結。如果設定為 IfNeeded，則僅當清單中存在下一頁時才呈現超連結。	如果需要的話
顯示頁數	整數？	分頁顯示多少頁碼，預設為5。	5
有單獨的頁面	布林值	顯示頁碼。	真的
文字到各頁面	細繩	若要在超連結內顯示的格式化文字。使用 {0} 引用頁碼，預設為 {0}	{0}
分隔符號文字	細繩	這將出現在每個頁碼之間。如果為空或空白，則不會顯示分隔符號。	無效的
有橢圓	布林值	當所有頁碼未顯示時加上省略號，預設為 true。	真的
省略號格式	細繩	當所有頁面未顯示時顯示格式化文本，預設情況下...	……
文字到首頁	細繩	顯示首頁連結的格式化文本，預設為 <<。	<<
文字到上一頁	細繩	顯示上一頁連結的格式化文本，預設為 <。	<
文字到下一頁	細繩	顯示下一頁連結的格式化文本，預設為 >。	>
文字到最後一頁	細繩	最後一頁連結顯示的格式化文本，預設為 >>。	>>
類別到Pager容器	細繩	用於附加到分頁內容中的 元素的 Css 類，預設將其設定為分頁器容器。	容器
類別ToU	細繩	附加到分頁內容中的 元素的 css 類，預設為分頁。	分頁
托利類	細繩	附加到分頁內容中 元素的CSS類，預設為page-item。	頁面項目
頁面類	細繩	附加到分頁內容中的 / 元素的 CSS 類，預設為 page-link。	頁面連結
類別到ActiveLi	細繩	如果在分頁內容中處於活動狀態，則附加到 元素的 Css 類，預設將其設定為活動狀態。	積極的
有分頁文本	布林值	在尋呼機中顯示目前頁碼和總頁數，預設為 false。	錯誤的
呼叫器文字格式	細繩	如果 HasPagerText 為 true，則會顯示文字格式。使用 {0} 引用目前頁，使用 {0} 引用總頁數，預設為第 {0} 頁，共 {1} 頁。	第 {0} 頁，共 {1} 頁。
有條目文本	布林值	在分頁器中顯示起始項、最後一項和總條目，預設為 false。	錯誤的
條目文字格式	細繩	如果 HasEntriesText 為 true，則會顯示文字格式。 {0} 指頁面上的第一個條目，{1} 指頁面上的最後一個條目，{2} 指條目總數，預設為顯示{0} 到{1} 個條目，共{2} 個條目。	顯示 {0} 到 {1} 個條目，共 {2} 個條目。

呼叫器顯示模式

一個三態枚舉，控制 PagerList 分頁控制項部分的可見度。

 public enum PagerDisplayMode

領域	描述
總是	始終渲染。
絕不	從不渲染。
如果需要的話	僅當存在有意義的資料時才渲染（上下文相關）。

如何使用PagerOptions？

1. 顯示自訂頁碼，假設 10 頁。

 @Html . Pager ( ( IPager ) Model , page => Url . Action ( "Index" , new { page } ) , new PagerOptions { PagesToDisplay = 10 } )

2. 帶有自訂頁面文字。

 @Html . Pager ( ( IPager ) Model , page => Url . Action ( "Index" , new { page } ) , new PagerOptions { TextToIndividualPages = "Page-{0}" } )

3. 自訂措辭。 （也可用於翻譯。 ）

 @Html . Pager ( ( IPager ) Model , page => Url . Action ( "Index" , new { page } ) , new PagerOptions { TextToPreviousPage = "Previous Page" , TextToNextPage = "Next Page" , TextToFirstPage = "First Page" , TextToLastPage = "Last Page" } )

4. 自訂選項。

 @Html . Pager ( ( IPager ) Model , page => Url . Action ( "Index" , new { page } ) , new PagerOptions { TextToPreviousPage = "last-page" , TextToNextPage = "next-page" , TextToFirstPage = "first-page" , TextToLastPage = "last-page" , ClassToUl = "list-inline" , ClassToLi = "list-inline-item" , PageClass = "nopageclass" , ClassToActiveLi = "niloclass" , TextForDelimiter = " | " } )

5. 自訂圖示選項（Fontawesome）

 @Html . Pager ( ( IPager ) Model , page => Url . Action ( "Index" , new { page } ) , new PagerOptions { TextToPreviousPage = "" , TextToNextPage = "" , TextToFirstPage = "" , TextToLastPage = "" } ) 

預尋呼選項

1. 最小尋呼機

 //Shows only the Previous and Next links.
@Html . Pager ( ( IPager ) Model , page => Url . Action ( "Index" , new { page } ) , PrePagerOptions . Minimal )

2. 具有尋呼機文字的最小尋呼機（頁數文字）

 //Shows Previous and Next links along with current page number and total number of pages in pager.
@Html . Pager ( ( IPager ) Model , page => Url . Action ( "Index" , new { page } ) , PrePagerOptions . MinimalWithPagerText )

3. 具有條目文字的最小尋呼機（項目計數文字）

 //Shows Previous and Next links along with index of start and last item and total entries in pager.
@Html . Pager ( ( IPager ) Model , page => Url . Action ( "Index" , new { page } ) , PrePagerOptions . MinimalWithEntriesText )

4. 經典尋呼機（始終顯示上一個/下一個鏈接，但有時會被停用）

 //Shows Previous and Next page always with default, 5 pages.
@Html . Pager ( ( IPager ) Model , page => Url . Action ( "Index" , new { page } ) , PrePagerOptions . ClassicPager )

6. 帶有第一個和最後一個連結的經典尋呼機（帶有第一個和最後一個連結的經典尋呼機，但有時它們被停用）

 //Shows Last, First, Previous and Next page always with default, 5 pages.
@Html . Pager ( ( IPager ) Model , page => Url . Action ( "Index" , new { page } ) , PrePagerOptions . ClassicPagerWithFirstAndLastPages ) 

執照

根據 MIT 許可證獲得許可。