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
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 оновлення з зворотньою комп 'ютерністю
Давайте подивимось на кожну з цих характеристик і побачимо, як вони працюють разом для створення справді гнучкої сторінкиного рішення.
Продолження Загортання символа {#продолження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¤tPage=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" />
Найважливіші відмінності від інших типів зору:
- Навігація використовує прив 'язки, не кнопки
<a href="/Products?page=2" class="pager-button">Next ›</a>
- Вибірник розміру сторінки - це форма:
<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¤tPage=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 для дослідження:
- Базова веб-сторінація з моделью - Традиційне плагинування за допомогою SQL
- Інтеграція HTMX - Динамічні оновлення сторінки без перезавантаження всієї сторінки
- Поиск за допомогою HTMX - Поєднання пошуку та відображання
- Прості CSS - Немає залежності від фреймворка
- Чистий вітер - TailwindCSS без DaisyUI
- Без Javaskrip - Полнефункціональне нуль - Позиційування JS
- Моди JavaScript - Всі п 'ять режимів JS продемонстровані на стороні
- Спорядження сторінок - Швидкі заголовки з HMX
- Упорядковувати сторінки Ні HTMX - Спорядковуючі заголовки з повним навантаженням сторінки
- Розмір сторінки з HTMX - Динамічні зміни розміру сторінки
- Розмір сторінки - не HTMX - Розмір сторінки з поданням бланку
- Пагер Kontinuації - NoSQL - стильного символу МSK2 базується на веб-сторінках
- 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