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
Yksinkertainen haku HTMX & EF Coren avulla ASP.NET Corelle
Tuesday, 17 September 2024
Esitys
Tämä on vain lyhyt artikkeli, koska se perustuu muihin tekstien hakusarjaan, kuten typeahead dropdown ja Postgresin täydellinen tekstitutkimus. Esitän teille, miten HTMX:tä ja EF Corea käyttäen toteutetaan yksinkertainen hakusivu ASP:ssä
Don't Olen jo tehnyt hakua
No, kyllä, sivuston otsikossa minulla on hakufunktion, joka tarjoaa typeahead (kuten kääntäessään tulokset tulevat reaaliaikaisestiM SK2kutenkin peittelen sen matkaviestintämodessa ja halusin myös voida liittää hakutulokset (kuisin /searchM SK1umami) osoitettuun hakusivuon . Tämä parantaa käyttäjäkokemusta ja parantaa myös matkapuhelinlaitteiden käyttöä
hakupalvelu
Tätä varten olen muuttanut tapaani tehdä hakujani. Olen luonut BlogSearchService, tämä perustuu kahteen Full Textin hakumenetelmääni, jotka minun on valitettavasti jaettava kahteen menetelmään, koska kysymykset rakentuvat Postgresin Full Text-tutkimuksen laajennusten avulla. EF.Functions.WebSearchToTsQuery("english", processedQuery) ja EF.Functions.ToTsQuery("english", query + ":*").
Ensimmäinen edellyttää asianmukaisia hakuehtoja ja toinen villikorttitarkastuksia.
private IQueryable<BlogPostEntity> QueryForSpaces(string processedQuery)
{
return context.BlogPosts
.Include(x => x.Categories)
.Include(x => x.LanguageEntity)
.AsNoTrackingWithIdentityResolution()
.Where(x =>
// Search using the precomputed SearchVector
(x.SearchVector.Matches(EF.Functions.WebSearchToTsQuery("english",
processedQuery)) // Use precomputed SearchVector for title and content
|| x.Categories.Any(c =>
EF.Functions.ToTsVector("english", c.Name)
.Matches(EF.Functions.WebSearchToTsQuery("english", processedQuery)))) // Search in categories
&& x.LanguageEntity.Name == "en") // Filter by language
.OrderByDescending(x =>
// Rank based on the precomputed SearchVector
x.SearchVector.Rank(EF.Functions.WebSearchToTsQuery("english",
processedQuery)));
}
private IQueryable<BlogPostEntity> QueryForWildCard(string query)
{
return context.BlogPosts
.Include(x => x.Categories)
.Include(x => x.LanguageEntity)
.AsNoTrackingWithIdentityResolution()
.Where(x =>
// Search using the precomputed SearchVector
(x.SearchVector.Matches(EF.Functions.ToTsQuery("english",
query + ":*")) // Use precomputed SearchVector for title and content
|| x.Categories.Any(c =>
EF.Functions.ToTsVector("english", c.Name)
.Matches(EF.Functions.ToTsQuery("english", query + ":*")))) // Search in categories
&& x.LanguageEntity.Name == "en") // Filter by language
.OrderByDescending(x =>
// Rank based on the precomputed SearchVector
x.SearchVector.Rank(EF.Functions.ToTsQuery("english",
query + ":*"))); // Use precomputed SearchVector for ranking
}
Jälleen kerran ne käyttävät ennalta arvattuani SearchVector pilari, joka on ajantasaistettu post luomisen ja ajantasaistamisen osalta. Tämä on luotu minun DbContext käyttämällä OnModelCreating menetelmä.
entity.Property(b => b.SearchVector)
.HasComputedColumnSql("to_tsvector('english', coalesce(\"Title\", '') || ' ' || coalesce(\"PlainTextContent\", ''))", stored: true);
entity.HasIndex(b => b.SearchVector)
.HasMethod("GIN");
Jälleen kerran tämän lähestymistavan haittapuoli on se, että se toimii vain englannin kielellä, koska olisin tarvinnut perustaa uudelleen perusteellisesti tietokanta, jotta se toimisi myös muilla kielillä.
Sitten käytän näitä menetelmiä BlogSearchService tulosten palauttaminen hakutulosten perusteella.
public async Task<PostListViewModel> GetPosts(string? query, int page = 1, int pageSize = 10)
{
if(string.IsNullOrEmpty(query))
{
return new PostListViewModel();
}
IQueryable<BlogPostEntity> blogPostQuery = query.Contains(" ") ? QueryForSpaces(query) : QueryForWildCard(query);
var totalPosts = await blogPostQuery.CountAsync();
var results = await blogPostQuery
.Select(x => x.ToListModel())
.Skip((page - 1) * pageSize)
.Take(pageSize)
.ToListAsync();
return new PostListViewModel()
{
Posts = results,
TotalItems = totalPosts,
Page = page,
PageSize = pageSize
};
}
Käytän yksinkertaista tarkistusta siitä, onko kysymyksessä tilaa määrittääkseni, mitä menetelmää kutsua.
hakuvalvoja
hakukone noudattaa mallia, jota olen käyttänyt useimmissa valvontakoneissani ja jossa se tunnistaa, tuleeko puhelu HTMX:stä vai ei, jotta voidaan lähettää joko osittainen tai täydellinen layout-sivu.
[Route("search")]
public class SearchController(
BaseControllerService baseControllerService,
BlogSearchService searchService,
ILogger<SearchController> logger)
: BaseController(baseControllerService, logger)
{
[HttpGet]
[Route("{query?}")]
public async Task<IActionResult> Search([FromRoute] string? query)
{
var searchResults = await searchService.GetPosts(query);
var searchModel = new SearchResultsModel
{
Query = query,
SearchResults = searchResults
};
searchModel = await PopulateBaseModel(searchModel);
searchModel.SearchResults.LinkUrl = Url.Action("SearchResults", "Search");
if (Request.IsHtmx()) return PartialView("SearchResults", searchModel);
return View("SearchResults", searchModel);
}
[HttpGet]
[Route("results")]
public async Task<IActionResult> SearchResults([Required] string query, int page = 1, int pageSize = 10)
{
var searchResults = await searchService.GetPosts(query, page, pageSize);
var searchModel = new SearchResultsModel
{
Query = query,
SearchResults = searchResults
};
searchModel = await PopulateBaseModel(searchModel);
searchModel.SearchResults.LinkUrl = Url.Action("SearchResults", "Search");
if (Request.IsHtmx()) return PartialView("_SearchResultsPartial", searchModel.SearchResults);
return View("SearchResults", searchModel);
}
}
Tämä on koko valvontakone, voitte nähdä, että minulla on kaksi toimenpidettä , yksi, joka palauttaa sivun M SK2 valinnaisesti täytetty tulosten kanssa) ja toinen, joka palauttaa vain HTMX-pyyntöjen tulokset
if (Request.IsHtmx()) return PartialView("_SearchResultsPartial", searchModel.SearchResults);
hakutulokset osittain
Voitte nähdä, että tämä palauttaa valinnaisesti _SearchResultsPartial katsoa, onko pyyntö tulosten HTMX-pyynnöstä.
Tämä on varsin yksinkertainen alustava katsaus, jossa on hakubit ja tulokset.
@model Mostlylucid.Models.Blog.PostListViewModel
<div class="pt-2" id="content">
@if (Model.Posts?.Any() is true)
{
<div class="inline-flex w-full items-center justify-center print:!hidden">
@if (Model.TotalItems > Model.PageSize)
{
<pager
x-ref="pager"
link-url="@Model.LinkUrl"
hx-boost="true"
hx-target="#content"
hx-swap="show:none"
page="@Model.Page"
page-size="@Model.PageSize"
total-items="@Model.TotalItems"
hx-headers='{"pagerequest": "true"}'>
</pager>
}
<partial name="_Pager" model="Model"/>
</div>
@foreach (var post in Model.Posts)
{
<partial name="_ListPost" model="post"/>
}
}
</div>
Luettelo Postin osittainen katsaus
Käytän samaa _ListPost osittainen näkemys siellä, missä minun on lueteltava työpaikat.
@model Mostlylucid.Models.Blog.PostListModel
<div class="border-b border-grey-lighter pb-8 mb-8">
<a asp-controller="Blog" asp-action="Show" hx-boost="true" hx-swap="show:window:top" hx-target="#contentcontainer" asp-route-slug="@Model.Slug"
class="block font-body text-lg font-semibold transition-colors hover:text-green text-blue-dark dark:text-white dark:hover:text-secondary">@Model.Title</a>
<div class="flex flex-wrap space-x-2 items-center py-4 print:!hidden">
@foreach (var category in Model.Categories)
{
<partial name="_Category" model="category"/>
}
@{ var languageModel = (Model.Slug, Model.Languages, Model.Language); }
<partial name="_LanguageList" model="languageModel"/>
</div>
<div class="block font-body text-black dark:text-white">@Model.Summary</div>
<div class="flex items-center pt-4">
<p class="pr-2 font-body font-light text-primary light:text-black dark:text-white">
@Model.PublishedDate.ToString("f")
</p>
<span class="font-body text-grey dark:text-white">//</span>
<p class="pl-2 font-body font-light text-primary light:text-black dark:text-white">
@Model.ReadingTime
</p>
</div>
</div>
HTMX ja hakusivu
HTMX:n käyttö on jälleen kerran varsin yksinkertaista. liitän yksinkertaisesti pisteeseen ( tällä kertaa päätin, etten muuta input-merkintää \ / vaihtaa URL-osoitteita \ ) ja lähetän pyynnön \ when the button is clicked
Sisällytän kysymyksen pyyntöön käyttäen hx-include ja kohdennetaan #content div tulosten korvaamiseksi.
<div class="flex items-center gap-2 bg-neutral-500 bg-opacity-10 p-2 rounded-lg">
<button
hx-get="@Url.Action("SearchResults", "Search")"
hx-target="#content"
hx-include="[name='query']"
hx-swap="outerHTML"
class="btn btn-outline btn-sm flex items-center gap-2 text-black dark:text-white">
Search
<i class="bx bx-search text-lg"></i>
</button>
<input
type="text"
placeholder="Search..."
value="@Model.Query"
name="query"
class="input input-sm border-0 grow text-black dark:text-white bg-transparent focus:outline-none"/>
</div>
Tarkistukset
Joten seuraavat muutamat kommentit Khalid Päätin parantaa tätä functionaliteettia, jotta haku olisi :
- Enter -kysymyksen painaminen herättää häiriötä
- (mahdollistetaan yli kahteen kirjaimeen liittymisen jälkeen, joten siitä tulee vapaa lukuotsikko
Tulevaisuudessa minun on lisättävä sivun kokoa koskevat toimenpiteet takaisin; se ' on murhenäytelmä ja tarvitsee tukea uusia vaatimuksia
Tarkistettu hakulomake
Tätä varten kätkein ensiksi merkinnän lomakkeessa ja käytin Alpine.js-järjestelmää lomakkeen toimittamiseen, kun käyttäjä kirjoittaa
Voitte nähdä, että käytän x-data luoda kysymykseen reagoiva muuttuja ja sitten tarkistan kysymyksen pituuden määrittelemiseksi, onko esitettävä lomake.
<form
x-data="{ query: '@Model.Query', checkSubmit() { if (this.query.length > 2) { $refs.searchButton.click(); } } }"
class="flex items-center gap-2 bg-neutral-500 bg-opacity-10 p-2 rounded-lg"
action="@Url.Action("Search", "Search")"
hx-push-url="true"
hx-boost="true"
hx-target="#content"
hx-swap="outerHTML show:window:top"
hx-headers='{"pagerequest": "true"}'>
<button
type="submit"
x-ref="searchButton"
class="btn btn-outline btn-sm flex items-center gap-2 text-black dark:text-white">
Search
<i class="bx bx-search text-lg"></i>
</button>
<input
type="text"
placeholder="Search..."
name="query"
value="@Model.Query"
x-model="query"
x-on:input.debounce.200ms="checkSubmit"
x-on:keydown.enter.prevent="$refs.searchButton.click()"
class="input input-sm border-0 grow text-black dark:text-white bg-transparent focus:outline-none"
/>
</form>
Jotta samaa valvontatoimenpidettä voitaisiin käyttää uudelleen, olen myös asettanut pagerequest otsikko osoittaa, että tämä on sivuttu pyyntö.
Käytän myös Alpine.js x-on:keydown.enter.prevent liiallisten pyyntöjen ehkäisemiseksi..
Valvontajärjestelmän ajantasaistaminen
Järjestelmässä poistin SearchResults -toimenpiteen ja lisäsin sen sijaan enemmän 'intelligenceM SK1 pääomaan. Search toimenpide, jolla käsitellään sekä alkuperäistä hakua että sivutettuja vaatimuksia.
Tässä voitte nähdä, että lisään ylimääräisen parametrin, joka kutsutaan pagerequest määrittää, onko tämä sivuttu pyyntö vai ei, ja ilmoittaa, että se on populaoitava header-kokonaisuudesta.
[HttpGet]
[Route("")]
public async Task<IActionResult> Search(string? query, int page = 1, int pageSize = 10,[FromHeader] bool pagerequest=false)
{
var searchResults = await searchService.GetPosts(query, page, pageSize);
var searchModel = new SearchResultsModel
{
Query = query,
SearchResults = searchResults
};
searchModel = await PopulateBaseModel(searchModel);
var linkUrl = Url.Action("Search", "Search");
searchModel.SearchResults.LinkUrl = linkUrl;
if(pagerequest && Request.IsHtmx()) return PartialView("_SearchResultsPartial", searchModel.SearchResults);
if (Request.IsHtmx()) return PartialView("SearchResults", searchModel);
return View("SearchResults", searchModel);
}
Saan sen jälkeen tulokset ja havaitsen tämän otsikon määrittääkseni, minkä näkökohdan / osittainen näkökohta palauttaa
Lisäksi lisäsin erilliselle eläkkeelle jääneelle toiminnalle /search/umami siirretään takaisin pää hakusivulle kysymyksen kanssa.
[HttpGet]
[Route("{query}")]
public IActionResult InitialSearch([FromRoute] string query)
{
return RedirectToAction("Search", new { query });
}
Päätelmissä
Näin ollen, melko yksinkertainen oikea? Tämä on suora kädellinen täytäntöönpano hakusivusta, jossa käytetään HTMX- ja EF Corea ASP:n ohjelmistossa.