Прогрес стрічки фильтра (А діапазон дати ШенанigansM SK1
Введение
Протягом останніх кількох днів я "'" відштовхував на новому фільтровому столбці блогу МСК1 , вибрав мову, МСК2 замовив, МКС3 і вдало намагався бути розумним . МКС4 , іноді занадто розумним. МКС5 Цей пост показує, що я створив МСК6 , чому кілька речей пішло вбік: Ми не поводились з датами , СМСК8 , які не обновлювалися, ВМСК9 , і як я їх виправив MSК10 , багато вихідного коду та декілька діаграм морської дівчини, які показують те, що відбувається .
пам 'ятайте, що ця веб-страна - це робота в процесі розробки.
Що змінилося?
Тут – МСК0 – найвищий рівень, МSK1 – рівень, : – я додав до блогового індексу правильну фільтровану панель, яка включає в себе:
- Виберите мову, яка зберігає ваші теперішні фільтри і запросить список через HTMX
- Вибрати порядок сортування: (date/title ascM SK2desc ) що також зберігає контекст
- Датовий відбірник діапазону (Flatpickr в режимі діапазона ) з сервером МSK2за керованими деталями дня
- Статуація URL завжди синхронізується. (взадM SK1передбачувані роботи, робота з глибокими зв 'язкамиMSC3
- Зараз кэшування сервера залежить від параметрів фильтра
Новое в цій обновленні (The Big Fix!)
- Фильтры видимості: Посты тепер можуть бути приховані , заплановані на майбутню публікування МSK2 або прив 'язані до верхньої частини
- Кінець діапазону: Нова
/blog/date-rangeAPI returns min/max dates for sensible picker bounds - Виczyść допоміжник ярлики param: Легкий спосіб очищувати фильтры за допомогою
<clear-param>допомічник теги з Alpine.js
Під час перегляду я отримав декілька помилок: відхилення строків на мові / зміна порядків МSK2 виділення календарів, які не поновлюваються при переміщених , і веселою, коли темний режим змусив календар виглядати зламаним, тому що Flatpickr не був
Фильтр Bar в DOM
Це нерівна структура, яку очікує сценарій:
<div id="filters" hx-target="#content">
<select id="languageSelect">…</select>
<select id="orderSelect">
<option value="date_desc">Newest first</option>
<option value="date_asc">Oldest first</option>
<option value="title_asc">Title A–Z</option>
<option value="title_desc">Title Z–A</option>
</select>
<input id="dateRange" type="text" placeholder="YYYY-MM-DD → YYYY-MM-DD" />
<button id="clearDateFilter">Clear</button>
<div id="filterSummary"></div>
</div>
<div id="content"><!-- HTMX swaps blog list here --></div>
Клієнт: HTMX + Телеграфні кабелі Flatpickr
Корінь поведінки живе в Mostlylucid/src/js/blog-index.js. Декілька важливих речейM SK1
- Утримка URL та навігація HTMX
function applyNavigation(u){
const target = document.querySelector('#content');
try{ window.history.pushState({}, '', u.toString()); }catch{}
if(window.htmx && target){
window.htmx.ajax('GET', u.toString(), {
target: '#content',
swap: 'outerHTML show:none',
headers: {'pagerequest': 'true'}
});
} else {
window.location.href = u.toString();
}
}
- Початкованість, за замовчанням від URL, і підтримання резюме інтерфейсу в синхронності
const url = new URL(window.location.href);
const existingStart = url.searchParams.get('startDate');
const existingEnd = url.searchParams.get('endDate');
const existingLang = url.searchParams.get('language') || 'en';
const existingOrderBy = (url.searchParams.get('orderBy') || 'date').toLowerCase();
const existingOrderDir = (url.searchParams.get('orderDir') || 'desc').toLowerCase();
langSelect.value = existingLang;
orderSelect.value = `${existingOrderBy}_${existingOrderDir}`;
updateSummary();
- Різниця Flatpickr з сервером‑за керованими днями
async function fetchMonth(year, month, language){
const res = await fetch(`/blog/calendar-days?year=${year}&month=${month}&language=${encodeURIComponent(language||'en')}`);
if(!res.ok) return new Set();
const j = await res.json();
return new Set(j.dates || []);
}
function formatYMD(d){ return d.toISOString().substring(0,10); }
let highlightDates = new Set();
const fp = window.flatpickr(input, {
mode: 'range',
dateFormat: 'Y-m-d',
defaultDate: [existingStart, existingEnd].filter(Boolean),
onDayCreate: function(_dObj,_dStr,fpInstance,dayElem){
const ymd = formatYMD(dayElem.dateObj);
if(highlightDates.has(ymd)){
dayElem.classList.add('has-post');
dayElem.style.background = 'rgba(76,175,80,0.35)';
dayElem.style.borderRadius = '6px';
}
},
onMonthChange: async function(_sd,_ds,fpInstance){
highlightDates = await fetchMonth(fpInstance.currentYear, fpInstance.currentMonth+1, langSelect.value);
fpInstance.redraw();
},
onOpen: async function(_sd,_ds,fpInstance){
highlightDates = await fetchMonth(fpInstance.currentYear, fpInstance.currentMonth+1, langSelect.value);
fpInstance.redraw();
},
onChange: function(selectedDates){
if(selectedDates.length === 2){
const [start,end] = selectedDates;
const u = new URL(window.location.href);
u.searchParams.set('startDate', formatYMD(start));
u.searchParams.set('endDate', formatYMD(end));
u.searchParams.set('page','1');
u.searchParams.set('language', langSelect.value);
const [ob,od] = orderSelect.value.split('_');
u.searchParams.set('orderBy', ob);
u.searchParams.set('orderDir', od);
updateSummary();
applyNavigation(u);
}
}
});
- Запам 'ятайте дати, коли змінює мову або порядок
langSelect.addEventListener('change', async function(){
const u = new URL(window.location.href);
u.searchParams.set('language', langSelect.value);
u.searchParams.set('page', '1');
const [ob,od] = (orderSelect.value||'date_desc').split('_');
u.searchParams.set('orderBy', ob);
u.searchParams.set('orderDir', od);
if(input._flatpickr && input._flatpickr.selectedDates.length===2){
const [s,e] = input._flatpickr.selectedDates;
u.searchParams.set('startDate', formatYMD(s));
u.searchParams.set('endDate', formatYMD(e));
}
// refresh calendar highlights for new language
if(input._flatpickr){
const fp = input._flatpickr;
highlightDates = await fetchMonth(fp.currentYear, fp.currentMonth+1, langSelect.value);
fp.redraw();
}
updateSummary();
applyNavigation(u);
});
- Знову-креслити календар, коли тема вмикає M SK1 темний/ світлий ) так що Flatpickr відображає
const obs = new MutationObserver(() => {
const dr = root.querySelector('#dateRange');
const fp = dr && dr._flatpickr;
if(fp && typeof fp.redraw === 'function') fp.redraw();
});
obs.observe(document.documentElement, { attributes:true, attributeFilter:['class'] });
Кондитори сервера: та Caching
Три кінцеві точки підштовхують сторінку:
- Індекс сам по собі,, який приймає сторінкуM SK1 розмір сторінки , початокdatum МSK3 закінченийdatum M SK4 мова , і порядок*
- А
calendar-daysкінцевий пункт, що повертає набір днів в даному місяці, які мають записи ( для висвітленьM SK1 - А
date-rangeкінцевий пункт, що повертає min/max дати по всіх постах ( моваM SK2 усвідомлення )
// GET /blog
[HttpGet]
[ResponseCache(Duration = 300, VaryByHeader = "hx-request",
VaryByQueryKeys = new[] { "page", "pageSize", nameof(startDate), nameof(endDate), nameof(language), nameof(orderBy), nameof(orderDir) },
Location = ResponseCacheLocation.Any)]
[OutputCache(Duration = 3600, VaryByHeaderNames = new[] { "hx-request" },
VaryByQueryKeys = new[] { nameof(page), nameof(pageSize), nameof(startDate), nameof(endDate), nameof(language), nameof(orderBy), nameof(orderDir) })]
public async Task<IActionResult> Index(int page = 1, int pageSize = 20, DateTime? startDate = null, DateTime? endDate = null,
string language = MarkdownBaseService.EnglishLanguage, string orderBy = "date", string orderDir = "desc")
{
var posts = await blogViewService.GetPagedPosts(page, pageSize, language: language, startDate: startDate, endDate: endDate);
posts.LinkUrl = Url.Action("Index", "Blog", new { startDate, endDate, language, orderBy, orderDir });
if (Request.IsHtmx()) return PartialView("_BlogSummaryList", posts);
return View("Index", posts);
}
// GET /blog/calendar-days?year=2025&month=11&language=en
[HttpGet("calendar-days")]
[ResponseCache(Duration = 300, VaryByHeader = "hx-request", VaryByQueryKeys = new[] { nameof(year), nameof(month), nameof(language) }, Location = ResponseCacheLocation.Any)]
[OutputCache(Duration = 1800, VaryByHeaderNames = new[] { "hx-request" }, VaryByQueryKeys = new[] { nameof(year), nameof(month), nameof(language) })]
public async Task<IActionResult> CalendarDays(int year, int month, string language = MarkdownBaseService.EnglishLanguage)
{
if (year < 2000 || month < 1 || month > 12) return BadRequest("Invalid year or month");
var start = new DateTime(year, month, 1);
var end = start.AddMonths(1).AddDays(-1);
var posts = await blogViewService.GetPostsForRange(start, end, language: language);
if (posts is null) return Json("");
var dates = posts.Select(p => p.PublishedDate.Date).Distinct().OrderBy(d => d).Select(d => d.ToString("yyyy-MM-dd")).ToList();
return Json(new { dates });
}
// GET /blog/date-range?language=en
[HttpGet("date-range")]
[ResponseCache(Duration = 3600, VaryByHeader = "hx-request", VaryByQueryKeys = new[] { nameof(language) }, Location = ResponseCacheLocation.Any)]
[OutputCache(Duration = 7200, VaryByHeaderNames = new[] { "hx-request" }, VaryByQueryKeys = new[] { nameof(language) })]
public async Task<IActionResult> DateRange(string language = MarkdownBaseService.EnglishLanguage)
{
var allPosts = await blogViewService.GetAllPosts();
if (allPosts is null || !allPosts.Any())
{
return Json(new
{
minDate = DateTime.UtcNow.AddYears(-1).ToString("yyyy-MM-dd"),
maxDate = DateTime.UtcNow.ToString("yyyy-MM-dd")
});
}
var posts = allPosts;
if (!string.IsNullOrEmpty(language) && language != MarkdownBaseService.EnglishLanguage)
{
posts = allPosts.Where(p => p.Language.Equals(language, StringComparison.OrdinalIgnoreCase)).ToList();
}
if (!posts.Any()) posts = allPosts;
var minDate = posts.Min(p => p.PublishedDate.Date);
var maxDate = posts.Max(p => p.PublishedDate.Date);
return Json(new
{
minDate = minDate.ToString("yyyy-MM-dd"),
maxDate = maxDate.ToString("yyyy-MM-dd")
});
}
Незабаром - МСК0 - у моделі плагуна LinkUrl так, що сторінка зберігає теперішній контекст фильтра при відтворенні сервера‑sideM SK1
public class BasePagingModel<T> : Interfaces.IPagingModel<T> where T : class
{
public int Page { get; set; }
public int TotalItems { get; set; } = 0;
public int PageSize { get; set; }
public ViewType ViewType { get; set; } = ViewType.TailwindAndDaisy;
public string LinkUrl { get; set; }
public List<T> Data { get; set; }
}
послідовність: як рухається зміна фільтру
sequenceDiagram
participant U as User
participant FP as Flatpickr
participant JS as blog-index.js
participant HT as HTMX
participant C as BlogController
U->>FP: Selects 2025-11-01 → 2025-11-10
FP-->>JS: onChange([start,end])
JS->>JS: Update URLSearchParams (startDate, endDate, language, order)
JS->>HT: htmx.ajax('GET', /blog?...)
HT->>C: GET /blog with query
C-->>HT: Partial _BlogSummaryList
HT-->>U: Swap #content
JS->>FP: (after swap) ensure highlights + redraw
Флоу: календарні висвітлення
flowchart TD A[Open calendar / Month change] --> B[Fetch /blog/calendar-days] B -->|JSON dates: yyyy-mm-dd array| C[Set highlightDates] C --> D[flatpickr redraw] D --> E[onDayCreate adds .has-post]
Нові характеристики: Прозорість та контроль контенту
Filtrи оточення постів
Найвизначнішим досягненням в цій обновленні є proper post visibility management. Три нові поля були добавлені до BlogPostEntity:
public class BlogPostEntity
{
// ... existing fields ...
public bool IsPinned { get; set; }
public bool IsHidden { get; set; }
public DateTimeOffset? ScheduledPublishDate { get; set; }
}
І BlogService тепер надлежащим чином відфільтровує пости:
// Filter out hidden posts and posts scheduled for the future
var now = DateTimeOffset.UtcNow;
postQuery = postQuery.Where(x =>
!x.IsHidden &&
(x.ScheduledPublishDate == null || x.ScheduledPublishDate <= now));
// For page 1, prioritize pinned posts
var isFirstPage = page == null || page.Value == 1;
if (isFirstPage)
{
postQuery = postQuery.OrderByDescending(x => x.IsPinned)
.ThenByDescending(x => x.PublishedDate.DateTime);
}
Це означає:
- Скриті пости (
IsHidden = true) ніколи не з 'являється в списку - Заплановані місця лише після їхнього
ScheduledPublishDate - Скріплені пости (
IsPinned = true) завжди з 'являються першими на сторінці
Виczyść допоміжник ярлики Парам
Нова ASP.NET Core tag helper дає змогу легко розібратися в параметрах запиту
[HtmlTargetElement("clear-param")]
public class ClearParamTagHelper : TagHelper
{
[HtmlAttributeName("name")]
public string? Name { get; set; }
[HtmlAttributeName("all")]
public bool All { get; set; } = false;
[HtmlAttributeName("exclude")]
public string Exclude { get; set; } = "";
// ... styling and Alpine.js integration ...
}
Використовування в Просмотрах Razor:
<!-- Clear a specific parameter -->
<clear-param name="startDate">Clear Date</clear-param>
<!-- Clear all parameters except language -->
<clear-param all="true" exclude="language">Clear All Filters</clear-param>
Помічник міток інтегрується з Alpine.jsM SK1s window.queryParamClearer компонент, який відповідає за маніпуляцію URL та обміни HTMX.
Примітка: Подібно до погрібне глибше дослідження і вказівника на тегні, і указівник на параметри запиту. МSK1 Я МSK2 розповім про повні деталі застосування МСК3 включно з альпіальним компонентом М СК4 js компонентами та шаблонами вказовника на теги M СК5 у майбутній статті про побудову повторюваних HTMXМ СК6 альпійських компонентів М SК7
Ошибки, на які я потрапив: ( і виправлення
Розмах日ні втрачений при зміні мови/ряду
- Причина: Я збудував новий URL з нуля, не з теперішньогоM SK2 втратив
startDate/endDate. - Поправити: Почати завжди з
new URL(window.location.href)і змінювати лише ті частини, які змінилися; або читати даті з Flatpickr, якщо вони єlanguage/orderЗмінюємо регулятори вище.
- Причина: Я збудував новий URL з нуля, не з теперішньогоM SK2 втратив
Освітлення календаря не обновлювалося після обміну HTMX
- Причина:实ка Flatpickr жила на старому DOM і померла на swapі.
- Установити: На входіM SK1 зруйнувати будь-яку існуючу instanцію , відновитиМSK3 створити, потім завантажити висвітлення для видимого місяця
Темний режим зробив календар виглядати розбитим
- Причина:: класи стилю змінилися, але Flatpickr не зробивM SK1 не перемалював намальованих днів.
- Обстежність
<html class>зміни та викликиfp.redraw().
Ссылки на веб-сторінку потрапили в контекст filtra
- Причина:
LinkUrlне було’ не влаштовано для того, щоб включити запит у деяких випадкахM SK1 - Установити: На сервері, набір
posts.LinkUrl = Url.Action("Index","Blog", new { startDate, endDate, language, orderBy, orderDir })так що пейджер правильно створює URL.
- Причина:
Безпека Swap HTMX: reM SK1init по запиту
Якщо ви користуєтесь частинними обмінами, ваш ДС має бути idemпотентним. У моєму випадку я обгортаю все і переM SK2 запускаю ініт після обміну :
(function(){
function initFromRoot(root){ /* …the big function shown above… */ }
if(window.htmx){
document.body.addEventListener('htmx:afterSwap', function(ev){
const tgt = ev.detail.target;
// re-init if the content swapped includes the filters/content area
if(tgt && (tgt.id === 'content' || tgt.querySelector?.('#filters'))){
initFromRoot(document);
}
});
}
// also run on first load
initFromRoot(document);
})();
Що буде далі?
- Додайте швидкі пресети (Пізніше МSK1 дні МSK2 30 дні
- Persist language in localStorage to seed the page
- Навігації на клавіатуру для діапазону дати
Якщо ви помітили щось дивне з цими фільтрами, будь ласка, залиште свій коментар у своєму браузері M SK1 кроки . Дякую за те, що їсте собаку разом зі мною!