Back to "PagingTagHelper v1.0.0: Enterprise-Ready Pagination for Modern ASPM SK2NET Core"

This is a viewer only at the moment see the article on how this works.

To update the preview hit Ctrl-Alt-R (or ⌘-Alt-R on Mac) or Enter to refresh. The Save icon lets you save the markdown file to disk

This is a preview from the server running through my markdig pipeline

Alpine.js ASP.NET Core HTMX Javascript Nuget PagingTagHelper TagHelper

PagingTagHelper v1.0.0: Enterprise-Ready Pagination for Modern ASPM SK2NET Core

Friday, 07 November 2025

Зверніть увагу: Зробимо це незабаром , просто закінчимо Погляньте на GitHub! .

Це тільки для того, щоб показати вам, що я роблю прогрес з цим контролем.

Введение

Після місяців еволюції та цінного зворотнього зв 'язку від спільноти (5.7kM SK1 завантаження!), Я ' з нетерпінням повідомляю, що Бібліотека PagingTagHelper дійшла до версії МSK4 Це не просто МSK5 стрибок номерів MSC6 це повне вирощування бібліотеки з функціями, які роблять її підходящою для реального МСК7 світу М СК8 виробничих програм МSК9

Якщо ви' слідкували за цією серией(МSK1), то пам 'ятаєте, що ми почали з bare-bones Paging, додався заголовки, які можна сортувати, і видалено контроль розміру сторінки. Версия 1.0.0 бере все, що ми вивчили МSK2 і додає вирішальні корпоративні характеристики

  • Розподіл символу Kontinuації для баз даних NoSQL (Cosmos DBM SK1 DynamoDB, Azure Table StorageMSC3
  • Мультиязычна локалізація підтримуючи мови 8 з коробки
  • Гибкі JavaScript-моди від HTMX до нуля-JavaScript
  • Чистий вітер для перегляду без залежності від DaisyUI
  • Спостереження параметрів розумного URL через всю навігацію
  • HTMX 2.0.4 оновлення з зворотньою комп 'ютерністю

Давайте подивимось на кожну з цих характеристик і побачимо, як вони працюють разом для створення справді гнучкої сторінкиного рішення.

NuGet NuGet

Продолження Загортання символа {#продолженняM SK1tokenМSK2загортавання}

Традиційне відображання прекрасно працює з базами даних SQL, де можна легко SKIP і TAKE записи. Але що трапляється, коли виM SK1 працюєте з базами даних NoSQL, такими як Cosmos DB , DynamoDB M SK3 або Azure Table Storage ? Ці бази даних не підтримують अफсету MSC6 базову पेजацію МSK7 натомість символи тривалості.

Усвідомлення टोकена-На основі веб-сторінки МSK1УсвідомленняM SK2tokен-на основі

Тут ' показує, як розкладання символів для продовження відрізняється від традиційного плагуна :

graph TD
    A[Traditional Paging] --> B[Page 1: OFFSET 0 LIMIT 10]
    A --> C[Page 2: OFFSET 10 LIMIT 10]
    A --> D[Page 3: OFFSET 20 LIMIT 10]

    E[Token-Based Paging] --> F[Page 1: No token]
    F --> G[Returns: Data + Token_A]
    G --> H[Page 2: Token_A]
    H --> I[Returns: Data + Token_B]
    I --> J[Page 3: Token_B]

    style A stroke:#0ea5e9,stroke-width:3px
    style E stroke:#ec4899,stroke-width:3px

Традиційне плагування:

  • Ви точно вказуєте, які записи треба отримати: (OFFSETM SK1LIMIT)
  • Ви можете перейти на будь-яку сторінку
  • База даних повинна сканувати всі попередні записи

Торгівля-На основі плагуванняM SK1

  • База даних returns an opaque token representing "where to continue
  • Формат токенів є базою даних- специфічним і недоступним для клієнта
  • Навігація вперед - природна, навігації назад потребують історії टोकена

Продолження Implementation Pager

Нова <continuation-pager> вказівник теги робить застосування символу-подібне pagination простоюM SK1 Перше, створити модель, яка застосовує IContinuationPagingModel:

public class ProductPagingViewModel : IContinuationPagingModel
{
    public string? NextPageToken { get; set; }
    public bool HasMoreResults { get; set; }
    public int PageSize { get; set; } = 25;
    public int CurrentPage { get; set; } = 1;
    public Dictionary<int, string>? PageTokenHistory { get; set; }
    public ViewType ViewType { get; set; } = ViewType.TailwindAndDaisy;

    // Your actual data
    public List<Product> Products { get; set; } = new();
}

Интерфейс мінімальний, але потужний. ДозвольтеM SK1 подивитися на те, що робить кожна властивість

  • NextPageToken: Токен для отримання наступної сторінки ( наданий вашою базою даних
  • HasMoreResults: Булеан, що вказує, чи є більше сторінок
  • PageSize: Поміщи на сторінку
  • CurrentPage: Дісプレイ МSK1только номер сторінки для інтерфейсу
  • PageTokenHistory: Позначення номерів сторінок словника на символи для зворотньої навігації
  • ViewType: Який інтерфейс CSS використовувати для рендеринга

Тепер дозвольте's реалізувати дію контроллера, яка симулує космічний DB

[Route("Products")]
public async Task<IActionResult> Products(
    int currentPage = 1,
    int pageSize = 25,
    string? pageToken = null,
    string? tokenHistory = null)
{
    // Simulate fetching from Cosmos DB
    var cosmosResults = await _cosmosService.GetProductsAsync(
        pageSize: pageSize,
        continuationToken: pageToken
    );

    // Deserialize token history for backward navigation
    var history = string.IsNullOrEmpty(tokenHistory)
        ? new Dictionary<int, string>()
        : JsonSerializer.Deserialize<Dictionary<int, string>>(tokenHistory)
          ?? new Dictionary<int, string>();

    // Store current token in history
    if (!string.IsNullOrEmpty(pageToken))
    {
        history[currentPage] = pageToken;
    }

    var viewModel = new ProductPagingViewModel
    {
        CurrentPage = currentPage,
        PageSize = pageSize,
        NextPageToken = cosmosResults.ContinuationToken,
        HasMoreResults = cosmosResults.HasMoreResults,
        PageTokenHistory = history,
        Products = cosmosResults.Items
    };

    if (Request.IsHtmx())
    {
        return PartialView("_ProductList", viewModel);
    }

    return View(viewModel);
}

Ця інсталяція показує, як історія токенів дозволяє зворотньому навігації. Без неїM SK1 продовження веб-сторінування токенами підтримало б лише "NextMSC3 кнопкиMska4 Утримуючи словник сторінкиMske5 доMске6картеографію токеновM Ska7 ми можемо підтримувати як "PreviousMsek9, так і МSK10Next

Тут ' ви бачите те, що відбувається з акумулюванням टोकенів :

sequenceDiagram
    participant User
    participant Controller
    participant Database
    participant TokenHistory

    User->>Controller: Request Page 1 (no token)
    Controller->>Database: Query with no token
    Database-->>Controller: Data + Token_A
    Controller->>TokenHistory: Store Token_A for page 1
    Controller-->>User: Display Page 1

    User->>Controller: Request Page 2 (Token_A)
    Controller->>Database: Query with Token_A
    Database-->>Controller: Data + Token_B
    Controller->>TokenHistory: Add Token_B for page 2
    Controller-->>User: Display Page 2

    User->>Controller: Request Page 1 (retrieve from history)
    Controller->>TokenHistory: Get Token for Page 1
    Controller->>Database: Query with Token_A
    Database-->>Controller: Data + Token_A
    Controller-->>User: Display Page 1

У вашому зображенні Razor, використовуючи безперервний पेजер є простимM SK1

@model ProductPagingViewModel

<div id="product-container">
    <table class="table">
        <thead>
            <tr>
                <th>Product</th>
                <th>Company</th>
                <th>Price</th>
            </tr>
        </thead>
        <tbody>
            @foreach (var product in Model.Products)
            {
                <tr>
                    <td>@product.Name</td>
                    <td>@product.CompanyName</td>
                    <td>[email protected]("N2")</td>
                </tr>
            }
        </tbody>
    </table>

    <continuation-pager
        model="Model"
        htmx-target="#product-container"
        show-page-number="true"
        show-pagesize="true" />
</div>

Помощник теги автоматично:

  • Serializes the token history into query parameters
  • Збудовує веб-адреси навігації з відповідними символами
  • Загнічує "PreviousM SK1, коли на сторінці 1
  • Загнічує "NextM SK1, коли HasMoreResults неправильна
  • Захищає всі інші параметри запиту ( пошук , фильтрыM SK2 і т.д.

Історія टोकена для зворотнього навігації

Генія підходу до історії токенів полягає в тому, що це

<continuation-pager
    model="Model"
    enable-token-accumulation="false"
    show-page-number="false" />

Це означає, що лише кнопка "NextM SK1 не має жодних вказівників сторінок чи управління історією.

Для повної навігації

/Products?currentPage=3&pageSize=25&pageToken=abc123&tokenHistory=%7B%221%22%3A%22xyz789%22%2C%222%22%3A%22abc123%22%7D

І tokenHistory параметр містить кодований словник, що робить зворотню навігацію безшовноюM SK1

Навігація номерованих сторінок {#номерованаM SK1страна-навігаціїMSC3

Однією з найважливіших усовершенствовань UX у папері Kontinuації є кнопки номерованих сторінок. Коли ви рухаєтесь впередM SK1, папер показує навігабельні номери сторінок для всіх відвіданих сторінок :

Initial page 1:    [Next →]
After next click:  [← Prev] [1] [2 active] [3 disabled] [Next →]
After next click:  [← Prev] [1] [2] [3 active] [4 disabled] [Next →]
Click page 2:      [← Prev] [1] [2 active] [3] [4 disabled] (no next - not visited yet)

Це надає традиційний інтерфейс веб-сторінування, підтримуючи символи.-Archітектура зворотнього ґатунку на основі. . Втілення зберігає символи для кожної відвідуваної сторінки. МSK2, що дозволяє прямій навігації до будь-якої попередньо посещованої сторінки.

Лімінація розвитку історії:

Щоб уникнути використання необмеженої пам 'яті max-history-pages (по замовчуваннюM SK1 20):

<continuation-pager
    model="Model"
    max-history-pages="50"
    show-page-number="true" />

Коли досягається межа, найстаріші символи сторінки автоматично зрізаютьсяM SK1

Критичний: Захорона параметрів запиту M SK1запитуМSK2параметру-захорону МSK4

Це найголовніша риса програмного забезпечення для безперервного плаєру.

Токени тривалості є ефективними лише в тому ж контексті запиту. (фільтриM SK1 сортуванняМSK2 пошуки МSK3 які їх генерували. Використовуючи токен з різними параметрами запиту, ви отримаєте неправильні дані або повністю зазнаєте невдачі

Повідник для продовження автоматично зберігає всі параметри пошуку за винятком власного:

<!-- URL with filters -->
/Products?category=electronics&brand=acme&minPrice=100

<!-- After clicking Next -->
/Products?category=electronics&brand=acme&minPrice=100&currentPage=2&pageToken=xyz123&tokenHistory={...}

<!-- All filters preserved! Token is valid because query context matches. -->

Ви можете вимкнути це, якщо потрібно:

<continuation-pager
    model="Model"
    preserve-query-parameters="false" />

Але це сильно відчаровані якщо ви не впевнені, що ваші टोकони не залежать від контексту запиту

Чому це важливо:

Наприклад, Космос DB:

// Page 1 with filter
var query = container.GetItemQueryIterator<Product>(
    "SELECT * FROM c WHERE c.category = 'electronics'",
    continuationToken: null
);
var response = await query.ReadNextAsync();
// Returns: Products + Token_A

// Page 2 with SAME filter - Token_A is valid
var query2 = container.GetItemQueryIterator<Product>(
    "SELECT * FROM c WHERE c.category = 'electronics'",
    continuationToken: Token_A  // ✅ Works!
);

// Page 2 with DIFFERENT filter - Token_A is invalid
var query3 = container.GetItemQueryIterator<Product>(
    "SELECT * FROM c WHERE c.category = 'computers'",
    continuationToken: Token_A  // ❌ Wrong results or error!
);

Автоматичне збереження параметрів папера Kontinuації' гарантує, що टोकони завжди будуть використані з їхнім оригінальним контекстом запиту.


Поддержка локалізації {#localization-supportM SK2

Сучасні додатки допомагають світовій аудиторії, і панелі управління веб-сторінками мають говорити з вашими користувачами МSK1 мова . Версия МСК3 включає в себе комплексну підтримку локалізації, побудовану прямо у бібліотеці М СК4

Вбудована-в мові {#вбудована

Бібліотека працює з перекладами для мов 8

Код МSK1 Язик МSK2
en Англійська
de МSK0 Немецкий (DeutschM SK2
es МSK0 Іспанська (EspañolM SK2
fr МSK0 Французький (Français
it МSK0 італійський (італьянськийM SK2 МSK3
pt МSK0 Португальська (PortuguêsM SK2
ja Японська (日本語M SK2 МSK3
zh-Hans Китайська упрощена

Усі тексти локалізовані,, включно зM SK1

  • Поprzedні/NastępніМSK1ПервійM SK2Последні літери кнопок
  • Краткий текст сторінки ("Показує від X до Y elementów ZM SK1
  • Наклейки ARIA для доступності
  • Наклейка розміру сторінки ("Елементи за сторінкуM SK1

Система локалізації заsilaна .resx ресурсні файли, що дає змогу легко додати власні мови mostlylucid.pagingtaghelper/Resources/.

Використовування локалізації {#localization-usageM SK2

Використовуючи локалізацію це просто. Просто додайте language атрибут:

<paging
    model="Model"
    language="de"
    show-summary="true"
    first-last-navigation="true" />

Це перетворює весь текст на німецьку:

<!-- Previous button -->
<button>‹ Vorherige</button>

<!-- Summary -->
<div class="text-sm text-gray-600">
    Zeige 1 bis 10 von 256 Einträgen
</div>

<!-- Next button -->
<button>Nächste ›</button>

Для динамічного переключення мови на основі особистих прав користувача, встановіть мову у контроллеріM SK1

public async Task<IActionResult> Products(
    int page = 1,
    int pageSize = 10,
    string language = "en")
{
    var pagingModel = await GenerateModel(page, pageSize);
    ViewBag.SelectedLanguage = language;
    return View(pagingModel);
}

Тоді у вашому списку, створюйте мовний відбірникM SK1

@{
    var selectedLanguage = ViewBag.SelectedLanguage as string ?? "en";
    var languages = new Dictionary<string, string>
    {
        { "en", "English" },
        { "de", "German" },
        { "es", "Spanish" },
        { "fr", "French" },
        { "it", "Italian" },
        { "pt", "Portuguese" },
        { "ja", "Japanese" },
        { "zh-Hans", "Chinese" }
    };
}

<select onchange="window.location.href='/Products?language=' + this.value">
    @foreach (var lang in languages)
    {
        <option value="@lang.Key" selected="@(lang.Key == selectedLanguage)">
            @lang.Value
        </option>
    }
</select>

<paging
    model="Model"
    language="@selectedLanguage"
    link-url="/Products" />

Ви також можете переписати окремі текстові стрічки, водночас користуючись локалізацією для інших елементів:

<paging
    model="Model"
    language="ja"
    previous-page-text="戻る"
    next-page-text="次へ"
    summary-template="全{TotalItems}件中 {StartItem}~{EndItem}件を表示" />

І PagingLocalizer послуга управляє культурою-автоматичне форматування конкретних речейМSK1 Якщо ви передаєте неправильний код мови МSK2 він граційно повертається до англійської .

Для інтеграції HTMX, ви' хочете зберегти мову на всіх рівнях

<script>
    htmx.on('htmx:configRequest', function(event) {
        if (event.detail.path.includes('/Products')) {
            event.detail.parameters.language = '@selectedLanguage';
        }
    });
</script>

Це гарантує, що HTMX відобновляє частину зору, зберігає виbraний język.


Моди JavaScript {#javascript-modesM SK2

Однією з найвизначніших покращень в v1.0.0 є введення гнучних JavaScript-модулів . Раніше МSK2 у вас був boolовий вибір use-htmx="true" або use-htmx="false". Тепер ви маєте п 'ять різних режимів , кожен оптимізований для різних сценаріїв

Доступні режими {#доступні-модиM SK2

Тут' є повним розкладом режимів JavaScriptM SK1

graph TD
    A[JavaScript Modes] --> B[HTMX]
    A --> C[HTMXWithAlpine]
    A --> D[Alpine]
    A --> E[PlainJS]
    A --> F[NoJS]

    B --> B1[Uses HTMX for partial updates]
    B --> B2[hx-get, hx-target, hx-swap]

    C --> C1[HTMX + Alpine.js directives]
    C --> C2[Enhanced interactivity]

    D --> D1[Pure Alpine.js]
    D --> D2[x-data, @click handlers]

    E --> E1[Vanilla JavaScript]
    E --> E2[onclick handlers]

    F --> F1[Zero JavaScript]
    F --> F2[Standard anchor links & forms]

Дозвольте побачити кожен режим в дії

1. HTMX Modus Default

<paging
    model="Model"
    js-mode="HTMX"
    htmx-target="#results-container" />

Рендери:

<button hx-get="/Products?page=2" hx-target="#results-container" hx-swap="outerHTML">
    Next ›
</button>

Чудово для динамічних оновлень сторінок без перезавантаження цілої сторінки. Це zalecaний режим для сучасних ASP .NET Core Applications.

2. HTMXWithAlpine Mode

<paging
    model="Model"
    js-mode="HTMXWithAlpine"
    htmx-target="#results-container" />

Рендери:

<button
    x-data
    hx-get="/Products?page=2"
    hx-target="#results-container"
    hx-swap="outerHTML">
    Next ›
</button>

Об 'єднує HTMX для навігації з Alpine.js для додаткового клієнта -залежна інтерактивністьM SK2 Використовуйте це, коли вам потрібні реактивні інтерфейси інтерфейсу разом із веб-сторінкою MSC3 індикатори завантаження, анімації

3. Альпійський режим

<paging
    model="Model"
    js-mode="Alpine" />

Рендери:

<button
    x-data
    @click="window.location.href = '/Products?page=2'">
    Next ›
</button>

Чистий Альпіний.js без HTMX. Полезний, коли виM SK2 ви вже користуєтесь АльпіаномМSK3js, але не хочете HT MX залежностейMSC5

4. PlainJS Mod

<paging
    model="Model"
    js-mode="PlainJS" />

Рендери:

<button onclick="window.location.href = '/Products?page=2'">
    Next ›
</button>

Жодних залежностей від фреймворка, лише ванили JavaScriptM SK1 Цей режим також включає в себе допомічник для зміни розміру сторінки:

@Html.PageSizeOnchangeSnippet()

Це вводить Java-скрипт, який необхідний для подолання змін розміру сторінки без HTMX.

5. Modus NoJS

<paging
    model="Model"
    js-mode="NoJS" />

Рендери:

<!-- Navigation uses standard anchor links -->
<a href="/Products?page=2">Next ›</a>

<!-- Page size uses a form with submit button -->
<form method="get" action="/Products">
    <input type="hidden" name="page" value="1" />
    <select name="pageSize" onchange="this.form.submit()">
        <option value="10">10</option>
        <option value="25" selected>25</option>
        <option value="50">50</option>
    </select>
    <noscript>
        <button type="submit">Update</button>
    </noscript>
</form>

Нуль JavaScript потрібно. Чудово для:

  • Требування доступності
  • Прогресивні сценарії покращення
  • Середовища, де JavaScript не працює
  • SEO-критичні сторінки, де ви хочете crawlerM SK1навігації дружні

Краса цієї системи в тому, що всі режими зберігають ваші існуючі параметри запиту. Неважливо, чи виM SK1 відфільтровуєте według категорії , шукаєте МSK3 або сортуєте , сторінка автоматично підтримує ваше положення

Миграція з використання-htmx M SK1міграція-зMSC3використовування

Для зворотнього зв 'язку, старий use-htmx атрибут досі працює:

<!-- Old syntax (still works) -->
<paging model="Model" use-htmx="true" />
<!-- Equivalent to js-mode="HTMX" -->

<paging model="Model" use-htmx="false" />
<!-- Equivalent to js-mode="PlainJS" -->

Однак, Я рекомендую перейти до нового js-mode атрибут для чіткості:

<!-- New syntax (recommended) -->
<paging model="Model" js-mode="HTMX" />
<paging model="Model" js-mode="PlainJS" />

Поліпшення вида зору {#видунокM SK1поліпшенняМSK2

Версия 1.0.0 представляє два важливі додатки ViewType, що відповідають спільному реальному -world сценаріїв M SK2

Pure Tailwind

Раніше, якщо ви хотіли зробити стиль TailwindCSS, ви отримали TailwindAndDaisy зображення, яке використовує компоненти DaisyUI. Це чудово, якщо ви' вже користуєтесь DaisyUI

Ввести ViewType.Tailwind:

<paging
    model="Model"
    view-type="Tailwind" />

Це відображає лише стандартні класи Tailwind utility:

<div class="flex gap-2 items-center">
    <button class="px-4 py-2 text-sm font-medium rounded-md bg-blue-600 text-white hover:bg-blue-700">
        ‹ Previous
    </button>

    <div class="px-3 py-1 text-sm font-medium bg-gray-100 dark:bg-gray-700 dark:text-white rounded-md">
        Page 1
    </div>

    <button class="px-4 py-2 text-sm font-medium rounded-md bg-blue-600 text-white hover:bg-blue-700">
        Next ›
    </button>
</div>

Ні btn, badge, або join класи – тільки чистий Tailwind. Це дає вам повний контроль над дизайном без залежності від компонентної бібліотекиM SK2

Порівняння:

Видові типи Корабель CSS МSK2 Комп 'ютерна база компонентів МSK3 Застосований випадок M
TailwindAndDaisy TailwindCSS ♫ ♫ ♫ DaisyUI ♫ МSK2 ♫ Проекти, які вже користуються DaisyUI
Tailwind TailwindCSS Ніхто МSK2 Проекти Pure TailWind МSK3
Bootstrap Засадка для Bootstrap
Plain Вбудований CSS Ніхто МSK2 Жодна залежність від фреймворка МSK3
NoJS Вбудований CSS Ніхто МSK2 Нуль Java-скрипту МSK3

Моді NoJS {#nojs-modeM SK2

І NoJS ViewType об 'єднує нуль JavaScript з Plain CSS styling:

<paging
    model="Model"
    view-type="NoJS"
    show-pagesize="true" />

Найважливіші відмінності від інших типів зору:

  1. Навігація використовує прив 'язки, не кнопки
<a href="/Products?page=2" class="pager-button">Next ›</a>
  1. Вибірник розміру сторінки - це форма:
<form method="get" action="/Products" class="page-size-form">
    <!-- Preserves all current query parameters as hidden inputs -->
    <input type="hidden" name="search" value="laptop" />
    <input type="hidden" name="category" value="electronics" />

    <!-- Reset to page 1 when changing page size -->
    <input type="hidden" name="page" value="1" />

    <label for="pageSize">Items per page:</label>
    <select name="pageSize" onchange="this.form.submit()">
        <option value="10">10</option>
        <option value="25" selected>25</option>
        <option value="50">50</option>
    </select>

    <!-- Button visible when JavaScript is disabled -->
    <noscript>
        <button type="submit" class="page-size-button">Update</button>
    </noscript>
</form>

І onchange="this.form.submit()" дає перевагу, коли JavaScript доступний, але <noscript> кнопка гарантує повну функціональність, коли це


Утримка параметрів URL {#url-parameterM SK2preservationMSC3

Однією з найнесподіваніших аспектів веб-проектування є втрата ваших фільтрів, пошукових термінів , або порядку сортування, коли ви рухаєтесь між сторінкамиM SK2 Версия 1.0.0 вирішує це вишукано: автоматично зберігає всі параметри запиту за винятком контролю сторінки' власних параметрів.

Ця властивість працює однаково як звичайні, так і послідовні, і через всі режими JavaScript та типи зору.

Ось як це працює всередині

string BuildQueryString(string? token, int page)
{
    var query = new Dictionary<string, string>();

    // Define continuation pager's own parameters that should be excluded from preservation
    var pagerParams = new HashSet<string>(StringComparer.OrdinalIgnoreCase)
    {
        "pageSize", "currentPage", "pageToken", "tokenHistory"
    };

    // Add parameter prefix variants if using prefixed parameters
    if (!string.IsNullOrEmpty(Model.ParameterPrefix))
    {
        pagerParams.Add($"{Model.ParameterPrefix}_pageSize");
        pagerParams.Add($"{Model.ParameterPrefix}_currentPage");
        pagerParams.Add($"{Model.ParameterPrefix}_pageToken");
        pagerParams.Add($"{Model.ParameterPrefix}_tokenHistory");
    }

    // Preserve all existing query parameters (except pager's own) if enabled
    if (Model.PreserveQueryParameters)
    {
        foreach (var param in ViewContext.HttpContext.Request.Query)
        {
            if (!pagerParams.Contains(param.Key))
            {
                query[param.Key] = param.Value.ToString();
            }
        }
    }

    // Add continuation pager parameters (with prefix if specified)
    var pageSizeParam = Model.GetParameterName("pageSize");
    var currentPageParam = Model.GetParameterName("currentPage");
    var pageTokenParam = Model.GetParameterName("pageToken");
    var tokenHistoryParam = Model.GetParameterName("tokenHistory");

    query[pageSizeParam] = pageSize.ToString();
    query[currentPageParam] = page.ToString();

    if (!string.IsNullOrEmpty(token))
        query[pageTokenParam] = token;

    if (Model.EnableTokenAccumulation)
        query[tokenHistoryParam] = tokenHistoryJson;

    return string.Join("&", query.Select(kvp =>
        $"{Uri.EscapeDataString(kvp.Key)}={Uri.EscapeDataString(kvp.Value)}"));
}

Цей підхід означає:

Сценарій 1: Поиск МSK1 Веб-сторінація

Initial URL: /Products?search=laptop&category=electronics&page=1
Click Next: /Products?search=laptop&category=electronics&page=2
Change Page Size: /Products?search=laptop&category=electronics&page=1&pageSize=50

сценарій 2: сортування МSK1 Pagination

Initial URL: /Products?orderBy=price&descending=true&page=1
Click Page 3: /Products?orderBy=price&descending=true&page=3

Сценарій 3: Послідження Пагер з Filtrами

Initial URL: /Products?category=electronics&brand=acme
Click Next: /Products?category=electronics&brand=acme&currentPage=2&pageToken=abc123&tokenHistory={...}

Те ж саме підтримування працює в формах (Невключний режим МSK1 При відтворенні розміру сторінкиM SK2 зображення автоматично включає в себе приховані вхідні дані для усіх інших параметрів, ніж

<form method="get" action="@linkUrl" class="page-size-form">
    @* Preserve all existing query parameters except pageSize and page-related ones *@
    @foreach (var param in ViewContext.HttpContext.Request.Query)
    {
        if (!new[] { "pageSize", "currentPage", "pageToken", "tokenHistory" }
            .Contains(param.Key, StringComparer.OrdinalIgnoreCase))
        {
            <input type="hidden" name="@param.Key" value="@param.Value" />
        }
    }

    @* Reset to page 1 when changing page size *@
    <input type="hidden" name="currentPage" value="1" />

    <select name="pageSize" onchange="this.form.submit()">
        <!-- options -->
    </select>
</form>

Це працює безперервно всі режими JavaScript і всі типи зору. Вам ніколи не потрібно вручну керувати розширенням строків запитуM SK1


Руководство по міграції

Обновлення з попередніх версій -1.0 є простим ,, але є кілька змін, які потрібно знати МSK2

Зрушення змін

1. use-htmx є недоречним ( але все ще працює МSK1

Старі:

<paging model="Model" use-htmx="true" />
<paging model="Model" use-htmx="false" />

Нова (рекомендуєтьсяM SK1

<paging model="Model" js-mode="HTMX" />
<paging model="Model" js-mode="PlainJS" />

2. Видовий типM SK1TailwindAndDaisy тепер використовує повні компоненти DaisyUI

Якби ви використовували ViewType.TailwindAndDaisy і хочуть чистого вітру Tailwind без DaisyUI:

Стара поведінка (pure TailwindM SK1

<paging model="Model" view-type="TailwindAndDaisy" />

Нова ( щоб отримати стару поведінкуM SK1

<paging model="Model" view-type="Tailwind" />

продовжувати використовувати TailwindAndDaisy якщо ви користуєтесь компонентами DaisyUI:

<paging model="Model" view-type="TailwindAndDaisy" />
<!-- Uses btn, join, badge, select, etc. -->

3. HTMX оновлений до 2.0.4

Якщо ви' використовуєте HTMX в інших місцях у вашій програмі , переконайтесь, що він совпаде з HT MX МSK2 Більшість кодів Руководство по міграції HTMX 2.0 для корпусів з краями.

Миграція

Шаг 1: Обновлення пакету NuGet

dotnet add package mostlylucid.pagingtaghelper --version 1.0.0

Шаг 2: Переглянь свій існуючий код

Подивіться на базу коду use-htmx атрибути:

# PowerShell
Get-ChildItem -Recurse -Include *.cshtml | Select-String "use-htmx"

# Bash/Git Bash
grep -r "use-htmx" --include="*.cshtml" .

Шаг 3: Обновлення до jsM SK1моду (рекомендується)

Заміняти use-htmx з js-mode:

- <paging model="Model" use-htmx="true" htmx-target="#results" />
+ <paging model="Model" js-mode="HTMX" htmx-target="#results" />

- <paging model="Model" use-htmx="false" />
+ <paging model="Model" js-mode="PlainJS" />

Шаг 4: Проаналізувати використання TailwindAndDaisy

Якщо у вас не установлена програма DaisyUI, але ви використовуєте TailwindAndDaisy:

- <paging model="Model" view-type="TailwindAndDaisy" />
+ <paging model="Model" view-type="Tailwind" />

Шаг 5: Достеменно перевірити

Запускайте вашу програму і тестуйте:

  • Навігація сторінок
  • Зміна розміру сторінки
  • Часткове оновлення HTMX (в разі використання HT MX)
  • Filtr/збереження пошуку
  • Мобільна реагування

Нові характеристики для прийняття

Після міграції, подумайте над тим, щоб скористатися цими новими функціямиM SK1

Lokalізація:

<paging
    model="Model"
    language="@CultureInfo.CurrentUICulture.TwoLetterISOLanguageName" />

Пагер Kontinuації ( якщо ви використовуєте NoSQL):

<continuation-pager
    model="Model"
    htmx-target="#results-container"
    show-page-number="true" />

tryb NoJS ( для доступності):

<paging model="Model" js-mode="NoJS" />

Застосунок для демонстрації {#demo-applicationM SK2

Бібліотека містить повну демонстраційну програму, яка показує всі характеристики. Ви можете запустити її локально або завантажити її на сайт демонстрації ( скоро прийдеM SK1

Запустити демонстрацію локально:

git clone https://github.com/scottgal/mostlylucid.pagingtaghelper.git
cd mostlylucid.pagingtaghelper/mostlylucid.pagingtaghelper.sample
dotnet run

Навігати до https://localhost:5001 для дослідження:

  1. Базова веб-сторінація з моделью - Традиційне плагинування за допомогою SQL
  2. Інтеграція HTMX - Динамічні оновлення сторінки без перезавантаження всієї сторінки
  3. Поиск за допомогою HTMX - Поєднання пошуку та відображання
  4. Прості CSS - Немає залежності від фреймворка
  5. Чистий вітер - TailwindCSS без DaisyUI
  6. Без Javaskrip - Полнефункціональне нуль - Позиційування JS
  7. Моди JavaScript - Всі п 'ять режимів JS продемонстровані на стороні
  8. Спорядження сторінок - Швидкі заголовки з HMX
  9. Упорядковувати сторінки Ні HTMX - Спорядковуючі заголовки з повним навантаженням сторінки
  10. Розмір сторінки з HTMX - Динамічні зміни розміру сторінки
  11. Розмір сторінки - не HTMX - Розмір сторінки з поданням бланку
  12. Пагер Kontinuації - NoSQL - стильного символу МSK2 базується на веб-сторінках
  13. Lokalізація - Вибірник мов з мовами МSK1

Кожна демонстрація містить:

  • Працюючий вихідний код
  • Обґрунтування техніки
  • Ссылка на implementaцію GitHub
  • Взаємний контроль для експерименту

Завершення

Версия 1.0.0 є ключовим етапом для Бібліотеки PagingTagHelper . Те, що почалося як простий обов 'язок праці, переросло в комплексне МSK2 виробництво МSK3 готові сторінки рішення, яке обробляєM SK4

  • Традиційна сторінка SQL з відхиленням/limit
  • Розгортання символів NoSQL для Cosmos DB, DynamoDBM SK1 і т.д.
  • Множество- локалізація мови для глобальної аудиторії
  • Гибкі режими JavaScript від HTMX до нуля-JavaScript
  • Багато структур CSS від DaisyUI до чистого Tailwind до жодного
  • Спостереження розумних параметрів через всю навігацію
  • Полна підтримка доступності з ярликами ARIA та навігацією на клавіатуру

Бібліотека була перевірена за допомогою завантажень 1.7kM SK2 і готова до використання для виробництва . Всі тести на Units МSK4 пройшли МSK5, а комплексна демонстраційна програма демонструє реальні patternи використання в світі

Що' СледующаяM SK1

Імовірні покращення I'вважаю

  • Dodatkowе забезпечення CSS (Матеріальне інтерфейсиM SK1 Bulma)
  • Більше мов локалізації
  • Serwer-Komponentи Blazor
  • Удосконалена доступність
  • Оптимізація ефективності для великих наборів даних

Почнемо

Установити за допомогою NuGet:

dotnet add package mostlylucid.pagingtaghelper --version 1.0.0

Подивіться на документацію:

Питання, зворотній зв 'язокM SK1 або příspěvky? Відкрийте проблему на GitHub чи зверніть увагу на Twitter @scottgal.

Щасливі сторінки! M SK1

logo

© 2026 Scott Galloway — Unlicense — All content and source code on this site is free to use, copy, modify, and sell.