15 KiB
Bygg en bankapp Del 1: HTML-mallar och rutter i en webbapplikation
Förföreläsningsquiz
Introduktion
Sedan JavaScript introducerades i webbläsare har webbplatser blivit mer interaktiva och komplexa än någonsin. Webbteknologier används nu ofta för att skapa fullt fungerande applikationer som körs direkt i en webbläsare, vilket vi kallar webbapplikationer. Eftersom webbapplikationer är mycket interaktiva vill användare inte vänta på att hela sidan ska laddas om varje gång en åtgärd utförs. Därför används JavaScript för att uppdatera HTML direkt via DOM, vilket ger en smidigare användarupplevelse.
I denna lektion ska vi lägga grunden för att skapa en bankapplikation, med HTML-mallar för att skapa flera skärmar som kan visas och uppdateras utan att hela HTML-sidan behöver laddas om.
Förkunskaper
Du behöver en lokal webbserver för att testa webbapplikationen vi ska bygga i denna lektion. Om du inte har en, kan du installera Node.js och använda kommandot npx lite-server från din projektmapp. Det skapar en lokal webbserver och öppnar din app i en webbläsare.
Förberedelse
På din dator, skapa en mapp som heter bank med en fil som heter index.html inuti. Vi börjar med denna HTML grundstruktur:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Bank App</title>
</head>
<body>
<!-- This is where you'll work -->
</body>
</html>
HTML-mallar
Om du vill skapa flera skärmar för en webbsida kan en lösning vara att skapa en HTML-fil för varje skärm du vill visa. Men denna lösning har vissa nackdelar:
- Du måste ladda om hela HTML-filen när du byter skärm, vilket kan vara långsamt.
- Det är svårt att dela data mellan de olika skärmarna.
Ett annat tillvägagångssätt är att ha endast en HTML-fil och definiera flera HTML-mallar med hjälp av <template>-elementet. En mall är ett återanvändbart HTML-block som inte visas av webbläsaren och måste instansieras vid körning med JavaScript.
Uppgift
Vi ska skapa en bankapplikation med två skärmar: inloggningssidan och instrumentpanelen. Först lägger vi till ett platshållarelement i HTML-kroppen som vi ska använda för att instansiera de olika skärmarna i vår app:
<div id="app">Loading...</div>
Vi ger det ett id för att göra det enklare att hitta det med JavaScript senare.
Tips: Eftersom innehållet i detta element kommer att ersättas kan vi lägga till ett laddningsmeddelande eller indikator som visas medan appen laddas.
Därefter lägger vi till HTML-mallen för inloggningssidan. För tillfället lägger vi bara till en titel och en sektion som innehåller en länk som vi ska använda för navigering.
<template id="login">
<h1>Bank App</h1>
<section>
<a href="/dashboard">Login</a>
</section>
</template>
Sedan lägger vi till en annan HTML-mall för instrumentpanelsidan. Denna sida kommer att innehålla olika sektioner:
- En header med en titel och en utloggningslänk
- Det aktuella saldot på bankkontot
- En lista över transaktioner, visade i en tabell
<template id="dashboard">
<header>
<h1>Bank App</h1>
<a href="/login">Logout</a>
</header>
<section>
Balance: 100$
</section>
<section>
<h2>Transactions</h2>
<table>
<thead>
<tr>
<th>Date</th>
<th>Object</th>
<th>Amount</th>
</tr>
</thead>
<tbody></tbody>
</table>
</section>
</template>
Tips: När du skapar HTML-mallar, om du vill se hur de kommer att se ut, kan du kommentera ut
<template>och</template>-raderna genom att omsluta dem med<!-- -->.
✅ Varför tror du att vi använder id-attribut på mallarna? Skulle vi kunna använda något annat, som klasser?
Visa mallar med JavaScript
Om du testar din nuvarande HTML-fil i en webbläsare kommer du att se att den fastnar på att visa Loading.... Det beror på att vi behöver lägga till lite JavaScript-kod för att instansiera och visa HTML-mallarna.
Att instansiera en mall görs vanligtvis i tre steg:
- Hämta mallelementet i DOM, till exempel med
document.getElementById. - Klona mallelementet med
cloneNode. - Fästa det i DOM under ett synligt element, till exempel med
appendChild.
✅ Varför behöver vi klona mallen innan vi fäster den i DOM? Vad tror du skulle hända om vi hoppade över detta steg?
Uppgift
Skapa en ny fil som heter app.js i din projektmapp och importera den filen i <head>-sektionen av din HTML:
<script src="app.js" defer></script>
Nu i app.js ska vi skapa en ny funktion updateRoute:
function updateRoute(templateId) {
const template = document.getElementById(templateId);
const view = template.content.cloneNode(true);
const app = document.getElementById('app');
app.innerHTML = '';
app.appendChild(view);
}
Det vi gör här är exakt de tre stegen som beskrivs ovan. Vi instansierar mallen med id templateId och placerar dess klonade innehåll inom vår app-platshållare. Observera att vi behöver använda cloneNode(true) för att kopiera hela underträdet av mallen.
Anropa nu denna funktion med en av mallarna och titta på resultatet.
updateRoute('login');
✅ Vad är syftet med denna kod app.innerHTML = '';? Vad händer utan den?
Skapa rutter
När vi pratar om en webbapplikation kallar vi Routing för avsikten att koppla URL:er till specifika skärmar som ska visas. På en webbplats med flera HTML-filer görs detta automatiskt eftersom filvägarna återspeglas i URL:en. Till exempel, med dessa filer i din projektmapp:
mywebsite/index.html
mywebsite/login.html
mywebsite/admin/index.html
Om du skapar en webbserver med mywebsite som rot kommer URL-mappningen att vara:
https://site.com --> mywebsite/index.html
https://site.com/login.html --> mywebsite/login.html
https://site.com/admin/ --> mywebsite/admin/index.html
Men för vår webbapplikation använder vi en enda HTML-fil som innehåller alla skärmar, så detta standardbeteende hjälper oss inte. Vi måste skapa denna karta manuellt och uppdatera den visade mallen med JavaScript.
Uppgift
Vi ska använda ett enkelt objekt för att implementera en karta mellan URL-vägar och våra mallar. Lägg till detta objekt högst upp i din app.js-fil.
const routes = {
'/login': { templateId: 'login' },
'/dashboard': { templateId: 'dashboard' },
};
Nu ska vi modifiera funktionen updateRoute lite. Istället för att direkt skicka templateId som ett argument vill vi hämta det genom att först titta på den aktuella URL:en och sedan använda vår karta för att få motsvarande templateId-värde. Vi kan använda window.location.pathname för att endast få sökvägsdelen från URL:en.
function updateRoute() {
const path = window.location.pathname;
const route = routes[path];
const template = document.getElementById(route.templateId);
const view = template.content.cloneNode(true);
const app = document.getElementById('app');
app.innerHTML = '';
app.appendChild(view);
}
Här har vi kopplat de deklarerade rutterna till motsvarande mall. Du kan testa att det fungerar korrekt genom att ändra URL:en manuellt i din webbläsare.
✅ Vad händer om du anger en okänd sökväg i URL:en? Hur skulle vi kunna lösa detta?
Lägga till navigering
Nästa steg för vår app är att lägga till möjligheten att navigera mellan sidor utan att behöva ändra URL:en manuellt. Detta innebär två saker:
- Uppdatera den aktuella URL:en
- Uppdatera den visade mallen baserat på den nya URL:en
Vi har redan tagit hand om den andra delen med funktionen updateRoute, så vi måste lista ut hur vi ska uppdatera den aktuella URL:en.
Vi måste använda JavaScript och mer specifikt history.pushState, som tillåter att uppdatera URL:en och skapa en ny post i webbläsarens historik utan att ladda om HTML.
Obs: Även om HTML-ankarelementet
<a href>kan användas på egen hand för att skapa hyperlänkar till olika URL:er, kommer det som standard att få webbläsaren att ladda om HTML. Det är nödvändigt att förhindra detta beteende när man hanterar routing med anpassad JavaScript, genom att använda funktionenpreventDefault()på klickhändelsen.
Uppgift
Låt oss skapa en ny funktion som vi kan använda för att navigera i vår app:
function navigate(path) {
window.history.pushState({}, path, path);
updateRoute();
}
Denna metod uppdaterar först den aktuella URL:en baserat på den angivna sökvägen och uppdaterar sedan mallen. Egenskapen window.location.origin returnerar URL-roten, vilket gör att vi kan återskapa en komplett URL från en given sökväg.
Nu när vi har denna funktion kan vi ta hand om problemet vi har om en sökväg inte matchar någon definierad rutt. Vi ska modifiera funktionen updateRoute genom att lägga till en fallback till en av de befintliga rutterna om vi inte kan hitta en matchning.
function updateRoute() {
const path = window.location.pathname;
const route = routes[path];
if (!route) {
return navigate('/login');
}
...
Om en rutt inte kan hittas kommer vi nu att omdirigera till inloggningssidan.
Nu ska vi skapa en funktion för att få URL:en när en länk klickas och för att förhindra webbläsarens standardbeteende för länkar:
function onLinkClick(event) {
event.preventDefault();
navigate(event.target.href);
}
Låt oss slutföra navigeringssystemet genom att lägga till bindningar till våra Login- och Logout-länkar i HTML.
<a href="/dashboard" onclick="onLinkClick(event)">Login</a>
...
<a href="/login" onclick="onLinkClick(event)">Logout</a>
Objektet event ovan fångar klickhändelsen och skickar den till vår funktion onLinkClick.
Använd attributet onclick för att binda klickhändelsen till JavaScript-kod, här anropet till funktionen navigate().
Testa att klicka på dessa länkar, du bör nu kunna navigera mellan de olika skärmarna i din app.
✅ Metoden history.pushState är en del av HTML5-standarden och implementerad i alla moderna webbläsare. Om du bygger en webbapplikation för äldre webbläsare finns det ett knep du kan använda istället för detta API: genom att använda en hash (#) före sökvägen kan du implementera routing som fungerar med vanliga ankarnavigeringar och inte laddar om sidan, eftersom dess syfte var att skapa interna länkar inom en sida.
Hantera webbläsarens bakåt- och framåtknappar
Att använda history.pushState skapar nya poster i webbläsarens navigeringshistorik. Du kan kontrollera det genom att hålla ned bakåtknappen i din webbläsare, det bör visa något liknande detta:
Om du försöker klicka på bakåtknappen några gånger kommer du att se att den aktuella URL:en ändras och historiken uppdateras, men samma mall fortsätter att visas.
Det beror på att applikationen inte vet att vi behöver anropa updateRoute() varje gång historiken ändras. Om du tittar på dokumentationen för history.pushState kan du se att om tillståndet ändras - vilket innebär att vi flyttade till en annan URL - triggas händelsen popstate. Vi ska använda det för att åtgärda detta problem.
Uppgift
För att säkerställa att den visade mallen uppdateras när webbläsarens historik ändras ska vi bifoga en ny funktion som anropar updateRoute(). Vi gör det längst ner i vår app.js-fil:
window.onpopstate = () => updateRoute();
updateRoute();
Obs: Vi använde en arrow function här för att deklarera vår
popstate-händelsehanterare för korthet, men en vanlig funktion skulle fungera lika bra.
Här är en uppfriskningsvideo om arrow functions:
🎥 Klicka på bilden ovan för en video om arrow functions.
Testa nu att använda bakåt- och framåtknapparna i din webbläsare och kontrollera att den visade rutten uppdateras korrekt denna gång.
🚀 Utmaning
Lägg till en ny mall och rutt för en tredje sida som visar krediter för denna app.
Efterföreläsningsquiz
Granskning & Självstudier
Routing är en av de överraskande knepiga delarna av webbutveckling, särskilt när webben går från siduppdateringsbeteenden till Single Page Application-uppdateringar. Läs lite om hur Azure Static Web App-tjänsten hanterar routing. Kan du förklara varför några av de beslut som beskrivs i det dokumentet är nödvändiga?
Uppgift
Ansvarsfriskrivning:
Detta dokument har översatts med hjälp av AI-översättningstjänsten Co-op Translator. Även om vi strävar efter noggrannhet, vänligen notera att automatiska översättningar kan innehålla fel eller felaktigheter. Det ursprungliga dokumentet på dess originalspråk bör betraktas som den auktoritativa källan. För kritisk information rekommenderas professionell mänsklig översättning. Vi ansvarar inte för eventuella missförstånd eller feltolkningar som uppstår vid användning av denna översättning.