This is a viewer only at the moment see the article on how this works.
To update the preview hit Ctrl-Alt-R (or ⌘-Alt-R on Mac) or Enter to refresh. The Save icon lets you save the markdown file to disk
This is a preview from the server running through my markdig pipeline
HTMX ( ja pieni alppilainenM SK1js) SPA-tyyppisen kokemuksen aikaansaamiseksi ASP:ssa .NET Coressa
Sunday, 15 September 2024
Esitys
Tässä sivustossa käytän HTMX 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
HTMX ja ASP.NET Core
HTMX-järjestelmän käyttö ASP:n kanssa Tämä ilmoitus. 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
<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 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
[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öä.
<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.
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 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.
(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.
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
<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 estää sellaisten kategorioiden 'flicker' osoittamisen, jotka ovat jo ennen JavaScriptin käyttöönottoa
Minulla on tämän osalta määritelty pieni CSS-luokka:
[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ä.