# HTMX ( ja pieni alppilainenM SK1js) SPA-tyyppisen kokemuksen aikaansaamiseksi ASP:ssa .NET Coressa

# Esitys

Tässä sivustossa käytän [HTMX](https://htmx.org/) laajasti, tämä on super helppo tapa tehdä sivustonne vaikuttavammaksi ja sujuvammaksi ilman, että tarvitsee kirjoittaa paljon JavaScriptia.

**PANEE MERKILLE: En ole vielä täysin tyytyväinen tähänM SK2 HTMX:ssä on joitakin seikkoja, jotka tekevät tämän hankalaksi**

<datetime class="hidden">2024-09-15T06:45</datetime>

<!--category-- ASP.NET, HTMX, Alpine.js -->
[TOC]

# HTMX ja ASP.NET Core

HTMX-järjestelmän käyttö ASP:n kanssa [Tämä ilmoitus](/blog/htmxwithaspnetcore). On todellakin melko helppoa 'HTMXify' siteenne, ja se on suuri tapa lisätä siteenne responsivenesstä.

## Tavalliset yhteydet

Osana viimeisintä matkaani käyttämällä HTMX:tä päätin tehdä mahdollisimman monta linkkiä tällä sivustolla käyttäen HT MX:tä.. Niinpä esimerkiksi, jos \' \Home \ ' \ sivun sisältöä laadittaessa käytetään nyt HTX:tä

Saavutan tämän vain lisäämällä joitakin ominaisuuksia linkkimerkintään, kuten tämäM SK1

```razor
    <a asp-action="IndexPartial" asp-controller="Home" hx-swap="show:window:top"  hx-target="#contentcontainer" hx-boost="true" class="mr-auto sm:mr-6">
     <div class="svg-container">
        <img src="/img/logo.svg" asp-append-version="true"  width="180px" height="30px"  alt="logo"  :class="{ 'img-filter-dark': isDarkMode }"/>
     </div>
    </a>
```

Tässä voitte nähdä, että lisään `hx-swap` attribute, tämä kertoo HTMX:lle vaihtaa kohdeelementin sisältöä serveristä palautetun sisällön kanssa

**PANEE MERKILLE: Älkää käyttäkö hx -pushurl, koska se johtaa siihen, että sivu laaditaan uudelleen takapuitteella kahdesti**

Euroopan unionin `hx-target` tunnus kertoo HTMX:lle, missä sijoittaa sisällön, joka palaa palvelimelta. Tässä tapauksessa se `#contentcontainer` elementti (jolle kaikki sivun sisältö on laadittu

Lisäisin myös `hx-swap="show:window:top` , joka tekee ikkunan liikkuvan sivun yläpuolelle, kun sisältö vaihdetaan.

C# osa tästä on varsin yksinkertainen , se vain toistaa tavanomaisen indeksimenetelmäni, mutta sen sijaan laaditaan osittainen näkökanta. [HTMX.NET](https://github.com/khalidabuhakmeh/Htmx.Net) havaitsemaan `hx-request` header ja palauttaa osittainen näkökanta. Siihen's on myös kattoM SK2out palauttaa tavallinen näkemys, jos pyyntö ei ole HTMX-pyynnön mukainen

```csharp
    [Route("/IndexPartial")]
    [OutputCache(Duration = 3600, VaryByHeaderNames = new[] { "hx-request" })]
    [ResponseCache(Duration = 300, VaryByHeader = "hx-request",
        Location = ResponseCacheLocation.Any)]
    [HttpGet]
    public async Task<IActionResult> IndexPartial()
    {
        ViewBag.Title = "mostlylucid";
        if(!Request.IsHtmx()) return RedirectToAction("Index");
        var authenticateResult = await GetUserInfo();
        var posts = await BlogService.GetPagedPosts(1, 5);
        posts.LinkUrl = Url.Action("Index", "Home");
     
        var indexPageViewModel = new IndexPageViewModel
        {
            Posts = posts, Authenticated = authenticateResult.LoggedIn, Name = authenticateResult.Name,
            AvatarUrl = authenticateResult.AvatarUrl
        };
        return PartialView("_HomePartial", indexPageViewModel);
    }
```

Tästä seuraa, että tämä linki ( ja muut käyttävät samaa tekniikkaa) laaditaan kuin 'AJAX\' pyynnöt ja sisältö vaihdetaan pois ilman koko sivun uudelleenlaadusta.

## blogilinkit ( yksinkertaisempi tapa)

Näin ollen jäljempänä oleva menetelmä voidaan tehdä toimivaksi, olipa se miten tahansa.
HTMX haluaa todellakin työskennellä attribute-perusteisella lähestymistavalla. käyttämällä `htmx.ajax` on eräänlainen ', jos kaikki muu epäonnistuu ' menetelmä ja merkitsee sitä, että tarvitsette sotkeutua borwser-historiaan
Valitettavasti käyttämällä matkapuhelin historiaa `pushState` `replaceState` ja `popstate` (, mutta se voi olla erittäin tehokas etusuojakeinoilleM SK1

Sen sijaan, mitä minä nyt teen on vain lisätä `hx-boost` tagiin, joka sisältää blogin sisältöä.

```html
   <div class="prose prose max-w-none border-b py-2 text-black dark:prose-dark sm:py-2" hx-boost="true"  hx-target="#contentcontainer">
        @Html.Raw(Model.HtmlContent)
    </div>
```

Tämä vaikuttaa toimivalta hyvin `hx-boost` voidaan sijoittaa vanhempiin menetelmiin ja soveltaa kaikkiin lapsilinkkeihin. Se ' on myös standardisempi HTMX ilman historian sekoittamista jne.

Harvoissa tapauksissa, joissa DON'T ei halua käyttää HTMX:tä tietyissä yhteyksissä, voit vain lisätä `hx-boost="false"` [linkkiin](https://htmx.org/attributes/hx-boost/).

## Blog Links (NOTEM SK1 Olen luopunut tästä lähestymistavasta, mutta pidän sen täällä viitenä.

Tämän lähestymistavan ongelmana oli kuitenkin blogin linkit, kuten tämä. [HTMX SPAn kaltaiselle kokemukselle](/blog/htmxtomakeyoursitemorespalike) linkit, jotka eivät ole 'normaalisiaM SK1linkit. Nämä linkit on luonut merkdown-parsaattorin ;, kun taas voisin kirjoittaa MarkDig-liitteen liittääkseen linkeihin HTMX-attribuut.

Sen sijaan lisäsin JavaScript-toimia, jotka etsivät kaikkia näitä linkejä, ja käyttävät `htmx.ajax` vaihtaa. Tämä on pohjimmiltaan se, mitä HTMX tekee joka tapauksessa vain

Kuten näette, tämä on vain yksinkertainen funktsiooni, joka etsii kaikki linkit `div.prose` elementti, joka alkaa `/` ja sitten liittää niihin tapahtuman kuuntelijan. Kun linkki on klikattu tapahtuma estetäänM SK1 URL-osoite vedetään pois, ja sen jälkeen `htmx.ajax` Funktio kutsutaan URL:n ja kohdeelementin kanssa ajantasaistamiseen.

```javascript
(function(window) {
   
    window.blogswitcher =() =>  {
        const blogLinks = document.querySelectorAll('div.prose  a[href^="/"]');

        // Iterate through all the selected blog links
        blogLinks.forEach(link => {
            link.addEventListener('click', function(event) {
               event.preventDefault();
                let link = event.currentTarget;
                let url = link.href;
                htmx.ajax('get', url, {
                    target: '#contentcontainer',  // The container to update
                    swap: 'innerHTML',            // Replace the content inside the target


                }).then(function() {
                    history.pushState(null, '', url);
                  
                        window.scrollTo({
                            top: 0,
                            behavior: 'smooth' // For a smooth scrolling effect
                        });
                    
                });
            });
        });
        
    };
})(window);
```

Lisäksi kun vaihto on tehty, nostan uuden URL:n sivun historiaan ja scrollin sivun yläpuolelle.. Käytän tätä lähestymistapaa muutamassa paikassa.

## Tappi taakse (Tämä on hankala saada toimimaanM SK1

Tällaisessa sovellussa takapusken käyttö voi olla ongelmallista; MYÖNTEINEN M SK1 asianmukainen' SPA-järjestelmät joko lopettavat takapuskin tai hyväksyvät tämän virheellisen käytännön . Halusin kuitenkin varmistaa, että takapuski toimi odotetulla tavalla
Huomautus: Jotta takapuskuri toimisi odotetusti, meidän on myös kuunneltava `popState` tapahtuma. Tämä tapahtuma käynnistetään, kun käyttäjä navigoi takaisin tai eteenpäin hakukoneen historiassa.

```javascript
window.addEventListener("popstate",   (event) => {
 // When the user navigates back, reload the content for the current URL
 event.preventDefault();
 let url = window.location.href;
 // Perform the HTMX AJAX request to load the content for the current state
 htmx.ajax('get', url, {
  target: '#contentcontainer',
  swap: 'innerHTML'
 }).then(function () {
  // Scroll to the top of the page
  window.scrollTo({
   top: 0,
   behavior: 'smooth'
  });
 });
});
```

Tässä koodissa estetään default-browser popstate -käytös `event.preventDefault()` call. Saamme sen jälkeen nykyisen URL:n `window.location.href` property ja toteuttaa HTMX AJAX-pyynnön sisällön laadinnasta nykyiseen tilanteeseen.. Kun sisältö on laadittu, etenemme sivun yläpuolelle.

Kuten aiemmin mainittiin, ette voi myöskään käyttää `hx-pushurl` koska tämä johtaa siihen, että sivu laaditaan takaisin kaksi kertaa..

# HTMX yleisesti ottaen ( ja alppimaalaiset

Kuten ehkä olette arvannut, olen jonkin verran HTMX:n kannattaja. Se yhdistetään ASP:n ja Alpinen Coren kanssa. Se antaa käyttäjille mahdollisuuden luoda todella mukavaa käyttäjäkokemusta vähäisin ponnisteluin.
Tärkein asia, jota pidän parempana kuin React-tyyppisiä enemmän 'muodotettuja'client side frameworkeja, kuten / Angular jne.
Alpine.js mahdollistaa yksinkertaisen asiakkaiden osapuolten vuorovaikutuksen, hyvin yksinkertainen näkökohta, jonka lisäsin äskettäin ja joka oli luokitteluni M SK2varmaantunut ' mutta laajennetaan yhdellä klikkiksellä

Alpinen käyttäminen.js merkitsee sitä, että ei tarvita lisäJavaScriptiaM SK1

```razor
        <div class="mb-8 mt-6 border-neutral-400 dark:border-neutral-600 border rounded-lg" x-data="{ showCategories: false }">
            <h4 
                class="px-5 py-1 bg-neutral-500  bg-opacity-10 rounded-lg  font-body text-primary dark:text-white w-full flex justify-between items-center cursor-pointer"
                x-on:click="showCategories = !showCategories"
            >
                Categories
                <span>
                    <i
                        class="bx text-2xl"
                        :class="showCategories ? 'bx-chevron-up' : 'bx-chevron-down'"
                    ></i>
                </span>
            </h4>
            <div 
                class="flex flex-wrap gap-2 pt-2 pl-5 pr-5 pb-2"
                x-show="showCategories" 
                x-cloak
                x-transition:enter="max-h-0 opacity-0"
                x-transition:enter-end="max-h-screen opacity-100"
                x-transition:leave="max-h-screen opacity-100"
                x-transition:leave-end="max-h-0 opacity-0"
            >
                @foreach (var category in ViewBag.Categories)
                {
                    <partial name="_Category" model="category"/>
                }
           
            </div>
        </div>

```

Tässä voitte nähdä, että käytän `x-data` 属性, jolla luodaan uusi Alpine.js data objectM SK1 tässä tapauksessa `showCategories`. Tämä on Boolean, joka käännetään, kun `h4` element on klikattu. `x-on:click` ominaisuuksia käytetään liittääkseen klikin tapahtuman käännettäviin toimintoihin.

Kategorioiden luettelossa käytän sitten `x-show` ominaisuuksia, joilla kuvataan tai peitetään kategorioiden luettelon arvo `showCategories`. Käytän myös `x-transition` ominaisuuksia, joilla lisätään hieno slide down -vaikutus, kun otsakkeita kuvataan tai peitetään.
Euroopan unionin `x-cloak` [luonne](https://alpinejs.dev/directives/cloak) estää sellaisten kategorioiden 'flicker' osoittamisen, jotka ovat jo ennen JavaScriptin käyttöönottoa
Minulla on tämän osalta määritelty pieni CSS-luokka:

```css
[x-cloak] { display: none !important; }
```

# Päätelmissä

Näin ollen, että's se, lyhyt artikkeli siitä, miten käyttää HTMX-järjestelmää ja Alpine'n paikkaa .js tehdä verkkosivustanne tuntuvan reagoivammaksi ja M SK3SPAMST4kutenMSC5 Toivon, että olette löytäneet tämän hyödyllisen, jos teillä on kysymyksiä tai huomautuksia, olkaa hyvä ja jättäkää ne jäljempänä.