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

<datetime class="hidden">2025-11-07T19:12</datetime>

<!--category-- Nuget, ASP.NET Core, HTMX, Alpine.js, Javascript, TagHelper, PagingTagHelper -->
> Зверніть увагу: Зробимо це незабаром , просто закінчимо [Погляньте на GitHub! ](https://github.com/scottgal/mostlylucid.pagingtaghelper).

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

## Введение

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

Якщо ви' слідкували за цією серией(МSK1), то пам 'ятаєте, що ми почали з [bare-bones Paging](https://www.mostlylucid.net/blog/pagingtaghelper), додався [заголовки, які можна сортувати](https://www.mostlylucid.net/blog/pagingtaghelperpt11), і видалено [контроль розміру сторінки](https://www.mostlylucid.net/blog/pagingtaghelperpt2). Версия 1.0.0 бере все, що ми вивчили МSK2 і додає вирішальні корпоративні характеристики

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

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

[![NuGet](https://img.shields.io/nuget/v/mostlylucid.pagingtaghelper.svg)](https://www.nuget.org/packages/mostlylucid.pagingtaghelper)
[![NuGet](https://img.shields.io/nuget/dt/mostlylucid.pagingtaghelper.svg)](https://www.nuget.org/packages/mostlylucid.pagingtaghelper)

[TOC]

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

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

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

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

```mermaid
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-pagerM SK2implementation }

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

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

```csharp
[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

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

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

```razor
@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>$@product.Price.ToString("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 і т.д.

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

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

```razor
<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):

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

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

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

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

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

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

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

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

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

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

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

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

```csharp
// 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` атрибут:

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

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

```html
<!-- 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

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

```razor
@{
    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" />
```

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

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

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

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

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

```mermaid
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**

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

Рендери:

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

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

**2. HTMXWithAlpine Mode**

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

Рендери:

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

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

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

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

Рендери:

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

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

**4. PlainJS Mod**

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

Рендери:

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

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

```razor
@Html.PageSizeOnchangeSnippet()
```

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

**5. Modus NoJS**

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

Рендери:

```html
<!-- 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` атрибут досі працює:

```razor
<!-- 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` атрибут для чіткості:

```razor
<!-- 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 {#pureM SK1tailwind}

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

Ввести `ViewType.Tailwind`:

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

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

```html
<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:

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

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

1. **Навігація використовує прив 'язки**, не кнопки

```html
<a href="/Products?page=2" class="pager-button">Next ›</a>
```

2. **Вибірник розміру сторінки - це форма**:

```html
<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 та типи зору**.

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

```csharp
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 зображення автоматично включає в себе приховані вхідні дані для усіх інших параметрів, ніж

```razor
<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**

Старі:

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

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

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

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

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

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

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

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

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

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

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

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

Якщо ви' використовуєте HTMX в інших місцях у вашій програмі , переконайтесь, що він совпаде з HT MX МSK2 Більшість кодів [Руководство по міграції HTMX 2.0](https://htmx.org/migration-guide-htmx-1/) для корпусів з краями.

### Миграція

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

```bash
dotnet add package mostlylucid.pagingtaghelper --version 1.0.0
```

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

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

```bash
# 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`:

```diff
- <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`:

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

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

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

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

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

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

**Lokalізація:**

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

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

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

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

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

---


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

Бібліотека містить повну демонстраційну програму, яка показує всі характеристики. Ви можете запустити її локально або завантажити її на [сайт демонстрації](https://paging-demo.mostlylucid.net) ( скоро прийдеM SK1

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

```bash
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:

```bash
dotnet add package mostlylucid.pagingtaghelper --version 1.0.0
```

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

- [Репозиторія GitHub](https://github.com/scottgal/mostlylucid.pagingtaghelper)
- [Пакет NuGet](https://www.nuget.org/packages/mostlylucid.pagingtaghelper)
- [Полна документація](https://github.com/scottgal/mostlylucid.pagingtaghelper/tree/main/docs)

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

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