Anche se Blazor ci permette di usare C# per realizzare la parte client di un'applicazione web, avremo ancora la necessità di interoperare con librerie scritte in JavaScript: mappe, grafici, caroselli e player video sono solo alcune delle funzionalità avanzate che possiamo implementare usando una di queste librerie.
Man mano che l'ecosistema di Blazor matura, interagire con tali librerie JavaScript diventerà più semplice grazie a pacchetti NuGet che agiscono da wrapper e che perciò ci permettono di usarle scrivendo unicamente codice C#. Questo sta già succedendo: si veda ad esempio Awesome Blazor, un repository GitHub che censisce svariati di questi wrapper. Alcuni sono pronti per l'uso in produzione, mentre altri sono solo in versione alpha.
[url]https://github.com/AdrienTorris/awesome-blazor#libraries--extensions[/url]
Tuttavia, ad oggi, Blazor Server è un prodotto ancora giovane e quindi in alcune situazioni potrebbe capitarci di dover interoperare con JavaScript. Vediamo come fare.
Un semplice esempio di interoperabilità con JavaScript
Iniziamo creando una funzione JavaScript molto semplice, che poi andremo a invocare da codice C#.Per prima cosa creiamo un nuovo file .js, ad esempio /wwwroot/js/app.js, in cui definiamo la seguente funzione JavaScript. A scopo puramente esemplificativo, la funzione si limiterà a porre il focus su un elemento HTML il cui id viene fornito come argomento.
function focusElement(elementId) { document.getElementById(elementId).focus(); }
Ora andiamo a referenziare il file /wwwroot/js/app.js dalla Razor Page che ospita la nostra applicazione Blazor Server, ad esempio la /Pages/_Host.cshtml. Aggiungiamo la riga seguente subito prima della chiusura del tag body.
<script src="~/js/app.js"></script>
Usare un file JavaScript esterno come questo è essenziale, perché le funzioni JavaScript non possono essere definite nei Razor Component, cioè nei file con estensione .razor. Infatti, se lo facessimo, otterremmo questo errore all'atto della compilazione.
error RZ9992: Script tags should not be placed inside components because they cannot be updated dynamically.
Invocare la funzione JavaScript da un Razor Component
Ora che abbiamo creato la nostra funzione chiamata focusElement la possiamo invocare da un Razor Component grazie al servizio IJSRuntime che riceviamo con la direttiva @inject. Andiamo a porre quanto segue nel file /Pages/Index.razor o in un qualsiasi altro Razor Component.@page "/" @inject IJSRuntime jsRuntime <input type="search" id="searchBox" placeholder="Cerca..." /> @code { protected override async Task OnAfterRenderAsync(bool firstRender) { if (firstRender) { //Il Razor component è stato appena renderizzato per la prima volta //quindi posso invocare la funzione JavaScript usando il servizio IJSRuntime //Passiamo come argomenti il nome della funzione e l'id dell'elemento su cui dev'essere posto il focus await jsRuntime.InvokeVoidAsync("focusElement", "searchBox"); } } }
Se avviamo l'applicazione, noteremo che il focus viene posto automaticamente nella casella ogni volta che visitiamo il Razor Component. Questa è la riprova che il nostro codice sta funzionando.
Commenti
Per inserire un commento, devi avere un account.
Fai il login e torna a questa pagina, oppure registrati alla nostra community.
Approfondimenti
Supportare il sorting di dati tabellari in Blazor con QuickGrid
Recuperare un elemento inserito nella cache del browser tramite API JavaScript
Generare file per il download da Blazor WebAssembly
Utilizzare gli snapshot con Azure File shares
Usare un KeyedService di default in ASP.NET Core 8
Sfruttare i KeyedService in un'applicazione Blazor in .NET 8
Utilizzare domini personalizzati gestiti automaticamente con Azure Container Apps
Evitare la script injection nelle GitHub Actions
Effettuare lo stream della risposta in ASP.NET Core tramite IAsyncEnumerable
Utilizzare la versione generica di EntityTypeConfiguration in Entity Framework Core
Ottimizzazione dei block template in Angular 17
Creare alias per tipi generici e tuple in C#