|
3 weeks ago | |
---|---|---|
.. | ||
README.md | 3 weeks ago | |
assignment.md | 4 weeks ago |
README.md
Bygg en bankapp Del 1: HTML-mallar och rutter i en webbapp
Förhandsquiz
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 webbappar är mycket interaktiva vill användare inte vänta på att hela sidan 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 den här lektionen ska vi lägga grunden för att skapa en bankwebbapp, genom att använda 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 webbappen vi bygger i den här lektionen. 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-mall:
<!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. Denna lösning har dock 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 som måste instansieras vid körning med JavaScript.
Uppgift
Vi ska skapa en bankapp med två skärmar: inloggningssidan och instrumentpanelen. Först lägger vi till ett platshållarelement i HTML-kroppen som vi kommer att 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 in ett laddningsmeddelande eller en indikator som visas medan appen laddas.
Därefter lägger vi till HTML-mallen för inloggningssidan nedanför. För tillfället lägger vi bara till en titel och en sektion som innehåller en länk som vi kommer att 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, visad 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 omge 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
skapar vi 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 i 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 koden app.innerHTML = '';
? Vad händer utan den?
Skapa rutter
När vi pratar om en webbapp 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 webbapp 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 mappning manuellt och uppdatera den visade mallen med JavaScript.
Uppgift
Vi använder ett enkelt objekt för att implementera en mappning 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 mappning för att få motsvarande mall-ID-värde. Vi kan använda window.location.pathname
för att få endast 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 mappade vi de rutter vi deklarerade 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 uppdaterar den aktuella URL:en.
Vi måste använda JavaScript och mer specifikt history.pushState
, som gör det möjligt 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-rot, 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 itu med problemet vi har om en sökväg inte matchar någon definierad rutt. Vi modifierar funktionen updateRoute
genom att lägga till en fallback till en av de befintliga rutterna om vi inte hittar en matchning.
function updateRoute() {
const path = window.location.pathname;
const route = routes[path];
if (!route) {
return navigate('/login');
}
...
Om en rutt inte kan hittas omdirigerar vi nu till login
-sidan.
Låt oss nu 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 click
-händelsen och skickar den till vår funktion onLinkClick
.
Genom att använda attributet onclick
binder vi click
-händelsen till JavaScript-kod, här anropet till funktionen navigate()
.
Prova 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 webbapp 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 fram- och bakåtknappar
Användning av 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.
Detta 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 betyder att vi flyttade till en annan URL - triggas händelsen popstate
. Vi kommer att använda detta för att lösa problemet.
Uppgift
För att säkerställa att den visade mallen uppdateras när webbläsarens historik ändras, kommer vi att bifoga en ny funktion som anropar updateRoute()
. Vi gör detta längst ner i vår app.js
-fil:
window.onpopstate = () => updateRoute();
updateRoute();
Obs: Vi använde en pilsfunktion här för att deklarera vår
popstate
-händelsehanterare för korthetens skull, men en vanlig funktion skulle fungera lika bra.
Här är en uppfräschande video om pilsfunktioner:
🎥 Klicka på bilden ovan för en video om pilsfunktioner.
Prova 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 krediterna för denna app.
Efterföreläsningsquiz
Granskning och 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, bör det noteras att automatiska översättningar kan innehålla fel eller inexaktheter. 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.