# Компонент Paging View ASP.NET Core Tag Helper M SK1Part 1.1, kinda sorta...A Flippy Tag HelpersMSC4

<datetime class="hidden">2025-03-17T22:12</datetime>

<!--category-- ASP.NET Core, TagHelper, PagingTagHelper -->
# Введение

Отже, під час розробки проекту я спочатку збудував [допомічник із тегами для відсилання ](https://www.mostlylucid.net/blog/category/PagingTagHelper) Я також долучусь до іншої потреби. Спосіб легко побудувати функцію сортування для таблиці результатів з підтримкою HtMX.

Отже, я представляю вам Flippy Table Header helper thingy
Це просто швидка стаття з великою кількістю коду. Ви завжди можете бачити [зразки тут](https://taghelpersample.mostlylucid.net/). І вихідний код як завжди [ось тут](https://github.com/scottgal/mostlylucid.pagingtaghelper).

Я - жахливі приклади будівлі. МSK1, МSK2 - це нелегка справа, але я - МSK3 - намагаюся додати все більше і більше, поки рухаюсь далі
Щоб заinstalувати:

```bash
dotnet add package mostlylucid.pagingtaghelper
```

![Вказівник тагов Flippy](flippyheaders.png?width=1000&format=webp)

[TOC]

# Справка з Flippy Tag

Отже, що це за штука? МСК0. Коротко кажучи, МСК1 - це спосіб генерувати табличну заголовку: МСК2, або будь-де інше. МСК3, що дозволить сортувати таблицю результатів

На ньому найпростіший ' і без інтеграції HTMX ) він дозволяє вам зробити це

```html
    <sortable-header column="@nameof(FakeDataModel.CompanyCity)"
                             current-order-by="@Model.OrderBy"
                             descending="@Model.Descending"
                             controller="Home"
                             use-htmx="false"
                             action="PageSortTagHelperNoHtmx"
                       >@Html.DisplayNameFor(x => x.Data.First().CompanyCity)
</sortable-header>
```

Тут ви можете побачити, що ви визначаєте ім 'я столбца, тест для заголовка і місце для публікації назад M SK1дякую [JetBrains.Примітки](https://www.nuget.org/packages/Jetbrains.Annotations) що серед багатьох інших речей,, які яM SK1 ледь пошкодила поверхнею дати intellisense для назви Контролера і Действия ).

Це створить посилання, яке повернеться до `PageSortTagHelperNoHtmx` дія на `Home` контролер з ім 'ям столбца і поточним порядком сортування, а також будь-якими іншими параметрами в URL (контролований `auto-append-querystring` атрибут. Це дає вам змогу легко отримати корисний зворотній зв 'язок , виM SK2 погляньте ось сюди Я зробив його досить гнучким, де ви можете визначити href / дію МSK4 контроллера і отримати зворотний зв' язок з прикріпленими параметрами строку запиту МSK5

```csharp
    private void AddQueryStringParameters(TagHelperOutput output, bool newDescending)
    {
        string? href = "";

        // If Controller and Action are provided, generate URL dynamically
        if (!string.IsNullOrEmpty(Controller) && !string.IsNullOrEmpty(Action))
        {
            href = Url.ActionLink(Action, Controller);
          
        }
        else if (output.Attributes.ContainsName("href")) // If href is manually set, use it
        {
            href = output.Attributes["href"].Value?.ToString() ?? "";
        }
        if(string.IsNullOrEmpty(href)) throw new ArgumentException("No href was provided or could be generated");
        
        // If AutoAppend is false or href is still empty, don't modify anything
        if (!AutoAppend && !string.IsNullOrWhiteSpace(href))
        {
            output.Attributes.RemoveAll("href");
            output.Attributes.SetAttribute("href", href);
            return;
        }

        // Parse the existing URL to append query parameters
        var queryStringBuilder = QueryString.Empty
            .Add("orderBy", Column)
            .Add("descending", newDescending.ToString().ToLowerInvariant());

        // Preserve existing query parameters from the current request
        foreach (var key in ViewContext.HttpContext.Request.Query.Keys)
        {
            var keyLower = key.ToLowerInvariant();
            if (keyLower != "orderby" && keyLower != "descending") // Avoid duplicating orderBy params
            {
             queryStringBuilder=   queryStringBuilder.Add(key, ViewContext.HttpContext.Request.Query[key]!);
            }
        }
href+= queryStringBuilder.ToString();
        
        // Remove old href and set the new one with the appended parameters
        output.Attributes.RemoveAll("href");
        output.Attributes.SetAttribute("href", href);
    }

```

Це метод, який додає параметри строку запиту до URL. `Controller` і `Action` атрибутів, або якщо ви `href` атрибут, він використовуватиме те, що `AutoAppend` для брехні він просто використовуватиме `href` властивість як (направду, ви можете ввести власні для певного призначення

## Безумний конфіг

Для того, щоб зробити це якомога більш корисним з / без HTMX. з ♫ / без Tailwind ♫& DaisyUI і т.д. Я ♫ МSK4 ♫ даю вам BUNCH властивостей для конфігурації цієї відносно простої системи управління

```csharp
    [HtmlAttributeName("hx-controller")]
    [AspMvcController] // Enables IntelliSense for controller names
    public string? HXController { get; set; }

    [HtmlAttributeName("hx-action")]
    [AspMvcAction] // Enables IntelliSense for action names
    public string? HXAction { get; set; }
    
    
    [HtmlAttributeName("action")]
    [AspMvcAction]
    public string? Action { get; set; }
    
    [HtmlAttributeName("controller")]
    [AspMvcController]
    public string? Controller { get; set; }
    
    [ViewContext]
    [HtmlAttributeNotBound]
    public ViewContext ViewContext { get; set; }
    /// <summary>
    /// The column to sort by
    /// </summary>

    [HtmlAttributeName("column")] public string Column { get; set; } = string.Empty;

    /// <summary>
    /// Whether to auto-append any query string parameters
    /// </summary>

    [HtmlAttributeName("auto-append-querystring")] public bool AutoAppend { get; set; } = true;
    
    // <summary>
    /// Whether to use htmx ; specifcally used to set hx-vals
    /// </summary>

    [HtmlAttributeName("use-htmx")] public bool UseHtmx { get; set; } = true;

    /// <summary>
    /// The currently set order by column
    /// </summary>

    [HtmlAttributeName("current-order-by")]
    public string? CurrentOrderBy { get; set; }

    /// <summary>
    /// Sort direction, true for descending, false for ascending
    /// </summary>

    [HtmlAttributeName("descending")] public bool Descending { get; set; }

    
    /// <summary>
    ///  CSS class for the chevron up icon
    /// </summary>

    [HtmlAttributeName("chevron-up-class")]
    public string? ChevronUpClass { get; set; }
    
    /// <summary>
    ///  CSS class for the chevron down icon
    /// </summary>


    [HtmlAttributeName("chevron-down-class")]
    public string? ChevronDownClass { get; set; }
    
    /// <summary>
    /// The CSS class for the chevron when unsorted
    /// </summary>

    
    [HtmlAttributeName("chevron-unsorted-class")]
    public string? ChevronUnsortedClass { get; set; }

    /// <summary>
    /// The CSS class to use for the tag.
    /// </summary>

    [HtmlAttributeName("tag-class")] public string? TagClass { get; set; }
```

Тут ви бачите, що у мене є властивості для дуже багато всього в контролі (IM SK1 я не збираюся пройти через все це тут вони повинні бути досить самосвідомими- пояснюючиMSC3

# З HTMX

Як ви, можливо, зрозуміли, я - HTMX-ноут, тож, як зазвичай, він досить гнучки підтверджує HT MX.
Вона НЕ Здатна `use-htmx` true, що заповнює `hx-vals` атрибут. разом з цим я використовую[ Допоможці HTMX](https://github.com/khalidabuhakmeh/Htmx.Net/tree/bbc9de911a723bff7cd0884aa566ed68502fa94b) зробити код якомога простишим.

```html
            <sortable-header column="Name"
                             current-order-by="@Model.OrderBy"
                             descending="@Model.Descending"
                             hx-get
                             hx-route-pagesize="@Model.PageSize"
                             hx-route-page="@Model.Page"
                             hx-route-search="@Model.SearchTerm"
                             hx-controller="Home"
                             hx-action="PageSortTagHelper"
                             hx-indicator="#loading-modal"
                             hx-target="#list"
                             hx-push-url="true">@Html.DisplayNameFor(x => x.Data.First().Name)
            </sortable-header>

```

І так, що МСК насправді *роботи* з HTMX безшовно.

# Контролер MVC

Потім я повертаю це до простого контроллера MVC, який генерує певні зразки даних:

```csharp
    [Route("PageSortTagHelper")]
    public async Task<IActionResult> PageSortTagHelper(string? search, int pageSize = 10, int page = 1, string? orderBy = "", bool descending = false)
    {
        var pagingModel = await SortResults(search, pageSize, page, orderBy, descending);

        if (Request.IsHtmxBoosted() || Request.IsHtmx())
        {
            return PartialView("_PageSortTagHelper", pagingModel);
        }
        return View("PageSortTagHelper", pagingModel);
    }
    
     private async Task<OrderedPagingViewModel> SortResults(string? search, int pageSize, int page, string? orderBy, bool descending)
    {
        search = search?.Trim().ToLowerInvariant();
        var fakeModel = await dataFakerService.GenerateData(1000);
        var results = new List<FakeDataModel>();

        if (!string.IsNullOrEmpty(search))
            results = fakeModel.Where(x => x.Name.ToLowerInvariant().Contains(search)
                                           || x.Description.ToLowerInvariant().Contains(search) ||
                                           x.CompanyAddress.ToLowerInvariant().Contains(search)
                                           || x.CompanyEmail.ToLowerInvariant().Contains(search)
                                           || x.CompanyCity.ToLowerInvariant().Contains(search)
                                           || x.CompanyCountry.ToLowerInvariant().Contains(search)
                                           || x.CompanyPhone.ToLowerInvariant().Contains(search)).ToList();
        else
        {
            results = fakeModel.ToList();
        }

        if (!string.IsNullOrWhiteSpace(orderBy))
        {
            results = results.OrderByField(orderBy, descending).ToList();
        }

        var pagingModel = new OrderedPagingViewModel();
        pagingModel.TotalItems = results.Count();
        pagingModel.Page = page;
        pagingModel.SearchTerm = search;
        pagingModel.PageSize = pageSize;
        pagingModel.Data = results.Skip((page - 1) * pageSize).Take(pageSize).ToList();
        pagingModel.OrderBy = orderBy;
        pagingModel.Descending = descending;
        return pagingModel;
    }

```

## І `OrderByField` Metodа розширення

О, і у мене є маленький метод розширення, в якому застосовується назване поле замовлення для даних ( або `IQueryable` і т.д.). ТM SK1 весь метод розширення є нижче . Ви бачите, що це має MSC3 методи, один для сильного надрукованого назви столбівMST5 один dla IQueryable зразків стрічки і один для IEnumerables

```csharp
using System.Linq.Expressions;
using System.Reflection;

namespace mostlylucid.pagingtaghelper.Extensions;

public static class QueryableExtensions
{
    public static IQueryable<T> OrderByField<T, TKey>(
        this IQueryable<T> source,
        Expression<Func<T, TKey>> keySelector,
        bool descending = false)
    {
        return descending ? source.OrderByDescending(keySelector) : source.OrderBy(keySelector);
    }


    public static IQueryable<T> OrderByField<T>(
        this IQueryable<T> source,
        string sortBy,
        bool descending = false)
    {
        if (string.IsNullOrWhiteSpace(sortBy))
            return source; // No sorting applied

        var property =
            typeof(T).GetProperty(sortBy, BindingFlags.IgnoreCase | BindingFlags.Public | BindingFlags.Instance);
        if (property == null)
            throw new ArgumentException($"Property '{sortBy}' not found on type '{typeof(T)}'.");

        var param = Expression.Parameter(typeof(T), "x");
        var propertyAccess = Expression.MakeMemberAccess(param, property);
        var lambda = Expression.Lambda(propertyAccess, param);

        var methodName = descending ? "OrderByDescending" : "OrderBy";

        var resultExpression = Expression.Call(
            typeof(Queryable),
            methodName,
            new[] { typeof(T), property.PropertyType },
            source.Expression,
            Expression.Quote(lambda)
        );

        return source.Provider.CreateQuery<T>(resultExpression);
    }
    
    public static IEnumerable<T> OrderByField<T>(
        this IEnumerable<T> source,
        string sortBy,
        bool descending = false)
    {
        var property = typeof(T).GetProperty(sortPropertyName(sortBy), BindingFlags.IgnoreCase | BindingFlags.Public | BindingFlags.Instance);
        if (property == null)
            throw new ArgumentException($"Property '{sortBy}' not found on type '{typeof(T)}'.");

        return descending
            ? source.OrderByDescending(x => property.GetValue(x, null))
            : source.OrderBy(x => property.GetValue(x, null));
    }

    // Helper methods for readability (optional)
    private static string sortPropertyName(string sortBy) => sortBy.Trim();
    private static string methodName(bool descending) => descending ? "OrderByDescending" : "OrderBy";
}
```

# На завершення

Це - те, що я потребував, тому я збудував його і закріпив у пакеті nukетів.