Прогрес стрічки фильтра (А діапазон дати ШенанigansM SK1 (Українська (Ukrainian))

Прогрес стрічки фильтра (А діапазон дати ШенанigansM SK1

Monday, 10 November 2025

//

11 minute read

Введение

Протягом останніх кількох днів я "'" відштовхував на новому фільтровому столбці блогу МСК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-range API 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 Змінюємо регулятори вище.
  • Освітлення календаря не обновлювалося після обміну 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 кроки . Дякую за те, що їсте собаку разом зі мною!

Finding related posts...
logo

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