إضافة التصفح مع HTMX و ASP.NET Core مع TagHelper (العربية (Arabic))

إضافة التصفح مع HTMX و ASP.NET Core مع TagHelper

Friday, 09 August 2024

//

3 minute read

المقدمة

الآن بما أن لدي مجموعة من المدونات الإلكترونية، كانت الصفحة الرئيسية تصبح أطول إلى حد ما لذا قررت إضافة آلية تصفح للمدونات

هذا يذهب مع إضافة كتشيف كامل لposts للدونات لجعل هذا موقع سريع وفعال.

أنظر إلى مصدر خدمات المدونة لكيف يتم تنفيذ هذا

مُساعد العلامات

قررت أن أستخدم "TagHelper" لتطبيق آلية التصفح. هذا يستخدم المساعد في كتابة الصفحات من داريل O'Neill هذا مضمن في المشروع كحزمة نوجات.

ثم يضيف هذا إلى _ViewImports.cshtml file so it is available to all views.

@addTagHelper *,PaginationTagHelper.AspNetCore

مُساعد العلامات

في _BlogSummaryList.cshtml نظرة جزئية قمت بإضافة الرمز التالي لتحويل آلية الإرسال

<pager link-url="@Model.LinkUrl"
       hx-boost="true"
       hx-push-url="true"
       hx-target="#content"
       hx-swap="show:none"
       page="@Model.Page"
       page-size="@Model.PageSize"
       total-items="@Model.TotalItems" ></pager>

بعض الأشياء المميزة هنا:

  1. link-url هذا يسمح للمساعد على صنع العنوان الصحيح للروابط المتصفحة. في طريقة homecontroller index هذا مضبط لتلك الحركة.
   var posts = blogService.GetPostsForFiles(page, pageSize);
   posts.LinkUrl= Url.Action("Index", "Home");
   if (Request.IsHtmx())
   {
      return PartialView("_BlogSummaryList", posts);
   }

وفي تحكم المدونة

    public IActionResult Index(int page = 1, int pageSize = 5)
    {
        var posts = blogService.GetPostsForFiles(page, pageSize);
        if(Request.IsHtmx())
        {
            return PartialView("_BlogSummaryList", posts);
        }
        posts.LinkUrl = Url.Action("Index", "Blog");
        return View("Index", posts);
    }

هذا محدد لتلك URl. هذا يضمن أن مساعد الصفحات يستطيع العمل على أي طريقة أعلى مستوى.

خصائص HTMX

hx-boost, hx-push-url, hx-target, hx-swap هذه كلها خصائص HTMX تسمح للاتصال للعمل مع HT MX.

     hx-boost="true"
       hx-push-url="true"
       hx-target="#content"
       hx-swap="show:none"

هنا نستخدم hx-boost="true" هذا يسمح للمساعد على كتابة الصفحات بأن لا يحتاج إلى أي تعديلات عن طريق التقاطه من URL العادي لـ ' واستعمال URL الحالي .

hx-push-url="true" للتأكد من تبادل URL في المتصفح'تاريخ URL M SK1 الذي يسمح بالروابط المباشرة إلى الصفحات).

hx-target="#content" هذا هو الهدف الذي سوف يحل محله المحتوى الجديد.

hx-swap="show:none" هذا هو تأثير التبديل الذي سيستخدم عندما يتم استبدال المحتوى.

CSS

لقد قمت أيضاً بإضافة الأنماط إلى मुख्य .css في مجلدي /src مما يسمح لي باستعمال دروس CSS "Tailwind" لروابط الصفحات

.pagination {
    @apply py-2 flex list-none p-0 m-0 justify-center items-center;
}

.page-item {
    @apply mx-1 text-black  dark:text-white rounded;
}

.page-item a {
    @apply block rounded-md transition duration-300 ease-in-out;
}

.page-item a:hover {
    @apply bg-blue-dark text-white;
}

.page-item.disabled a {
    @apply text-blue-dark pointer-events-none cursor-not-allowed;
}

المتحكم

page, page-size, total-items هي خصائص التي يستخدمها مساعد الصفحات لخلق روابط التدوير. يتم نقلها إلى المشهد الجزئي من جهاز التحكم.

 public IActionResult Index(int page = 1, int pageSize = 5)

خدمة المدونات

هنا يتم نقل الصفحة والصفحة الحجم من موقع الكتروني و تحسب جميع الصفحات من خدمة المدونات

    public PostListViewModel GetPostsForFiles(int page=1, int pageSize=10)
    {
        var model = new PostListViewModel();
        var posts = GetPageCache().Values.Select(GetListModel).ToList();
        model.Posts = posts.OrderByDescending(x => x.PublishedDate).Skip((page - 1) * pageSize).Take(pageSize).ToList();
        model.TotalItems = posts.Count();
        model.PageSize = pageSize;
        model.Page = page;
        return model;
    }

هنا نحصل ببساطة على الملاحظات من المخزن , نظمها حسب التاريخ ومن ثم تخطي وأخذ عدد الملاحظة الصحيحة للصفحة .

الاستنتاجات

كان هذا إضافة بسيطة للموقع لكنه يجعله أكثر قابلية للاستخدام. دمجHTMX يجعل الموقع يشعر بالتفاعل أكثر بينما لا يضيف المزيد من JavaScript للموقع.

Finding related posts...
logo

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