Abschnitt 20 · Lektion 5
Deine erste eigene Datei
Der Schritt auf den eigenen Rechner wirkt größer, als er ist. Zwanzig Abschnitte lang lief alles in einem Editor, der schon eingerichtet war, und der fehlt jetzt plötzlich. Die kurze Antwort ist beruhigend unspektakulär. Ein Ordner, drei Dateien, ein Editor.
Der Ordner
Irgendwo liegt ein Ordner, benannt wie das Projekt. Darin liegen drei Dateien, index.html, styles.css und app.js.
index.html heißt so, weil die üblichen Server diese Datei ausliefern, wenn niemand einen Dateinamen angibt. Die anderen beiden Namen sind Gewohnheit und keine Vorschrift. Ich halte mich trotzdem daran, denn wer den Ordner öffnet, weiß dann sofort, wo er nachsehen muss.
Wie die drei zusammenkommen
<!DOCTYPE html>
<html lang="de">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Mein Projekt</title>
<link rel="stylesheet" href="styles.css">
<script src="app.js" defer></script>
</head>
<body>
<h1>Mein Projekt</h1>
<p id="ausgabe"></p>
<script>
// Nur für dieses Beispiel: styles.css und app.js gibt es
// hier nicht, die beiden Verweise laufen ins Leere. Auf
// deinem Rechner liegen sie neben der index.html.
document.getElementById("ausgabe").textContent =
"Die Seite läuft.";
</script>
</body>
</html> Das ist das Gerüst, und daran ändert sich in den nächsten Jahren nichts mehr. Fünf Zeilen im head, mehr ist es nicht.
lang="de"sagt, in welcher Sprache die Seite ist. Das braucht der Screenreader für die Aussprache und die Suchmaschine für die Einordnung.<meta charset="utf-8">gehört als erstes in denhead, weil der Browser nur in den ersten 1024 Bytes danach sucht. Fehlt die Angabe, rät der Browser, sobald die Seite von einem Server kommt, und aus „Grüße“ wird „Grüße“. Beim Doppelklick rät er meistens richtig. Deshalb fällt die fehlende Zeile erst im Netz auf.- Mit
<meta name="viewport" …>kommt die Seite auf dem Handy in der richtigen Größe an. Ohne die Zeile zoomt das Telefon eine Desktop-Seite heraus, und alles ist winzig. <link rel="stylesheet" href="styles.css">holt das Aussehen,<script src="app.js" defer>das Verhalten. Dasdeferstammt aus dem ersten Abschnitt. Es lädt sofort und führt aus, wenn das Dokument steht.
<h1>Mein Projekt</h1>
<p><button id="button" type="button">Zählen</button></p>
<p id="ausgabe">Noch nicht gedrückt.</p> body {
font-family: system-ui, sans-serif;
padding: 1rem;
}
#button {
font: inherit;
padding: 6px 12px;
} const button = document.getElementById("button");
const ausgabe = document.getElementById("ausgabe");
let stand = 0;
button.addEventListener("click", () => {
stand = stand + 1;
ausgabe.textContent = `${stand} mal gedrückt.`;
}); Im zweiten Beispiel siehst du, was in die beiden anderen Dateien kommt, und es läuft hier wirklich. So sieht ein kleines Projekt aus.
Warum der Doppelklick nicht reicht
Ein Doppelklick auf index.html öffnet sie im Browser, und für die ersten Schritte reicht das. In der Adresszeile steht dann file:///… statt https://…, und damit fangen die Probleme an. Zwei Dinge funktionieren dort nicht, und der Browser sagt beides deutlich.
- Module werden abgelehnt, mit
Access to script at 'file:///…' from origin 'null' has been blocked(Firefox:… (Reason: CORS request not http)). Für diese Frage hat die Seite also gar keinen Origin. Und ohne Origin kann der Browser nicht entscheiden, ob die Datei nebenan zur selben Seite gehört. fetchwird abgelehnt, mitFetch API cannot load file:///… URL scheme "file" is not supported(Firefox:… (Reason: CORS request not http)). Hier ist der Grund noch einfacher.fetchspricht HTTP, undfileist kein HTTP.
Mit dem Origin ist es verzwickter, als es aussieht. window.isSecureContext antwortet auf einer file://-Seite mit true, location.origin in Chrome mit "file://" und in Firefox mit "null". Was eine Erlaubnis braucht, etwa die Zwischenablage aus Lektion 19.4, hängt dort vom Browser ab. Ein sicherer Kontext ist eben die Voraussetzung und nicht die Zusage.
Für die ersten Schritte mit HTML und CSS reicht der Doppelklick also. Sobald Module, fetch oder eine Erlaubnis dazukommen, brauchst du den Server aus dem nächsten Abschnitt, und dann ist die Frage ein für alle Mal erledigt.
<!DOCTYPE html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Mit Modulen</title>
<!-- type="module" wartet automatisch auf das fertige
Dokument, ein defer ist hier überflüssig. -->
<script type="module" src="app.js"></script>
</head>
<body>
<h1>Mit Modulen</h1>
<p id="ausgabe"></p>
<script>
document.getElementById("ausgabe").textContent =
"Diese Seite braucht einen Server, siehe Text.";
</script>
</body>
</html> // Datei: app.js. Zum Lesen, nicht zum Ausführen.
// Sie läuft erst, wenn die Seite über einen Server kommt.
import { grossAnfang } from "./werkzeuge.js";
document.getElementById("ausgabe").textContent =
grossAnfang("es läuft.");
// Und daneben liegt werkzeuge.js:
//
// export function grossAnfang(text) {
// return text.charAt(0).toUpperCase() + text.slice(1);
// } Das dritte Beispiel ist der Fall, für den Lektion 18.4 hierher verwiesen hat. Der Modulcode ist echt und läuft hier nicht, weil hinter der Seite kein Dateiserver steht. Auf dem eigenen Rechner läuft er, sobald die Seite über einen Server kommt.
Der lokale Server
Klingt nach Aufwand, ist aber keiner. Es geht nur darum, dass die Dateien über http://localhost:… ausgeliefert werden statt über file://.
Für fast jeden Editor gibt es das als Erweiterung. In VS Code heißt sie „Live Server“ und startet mit einem Klick. Hast du Node installiert, kommst du mit npx serve im Projektordner ans selbe Ziel, und mit Python geht es über python3 -m http.server. Alle drei liefern den Ordner unter einer http-Adresse aus.
Ein Live Server lädt die Seite außerdem bei jedem Speichern neu. Du siehst die Änderung, ohne den Browser anzufassen.
Die Entwicklerwerkzeuge des Browsers
F12 öffnet sie, ebenso ein Rechtsklick auf die Seite und „Untersuchen“. Am Anfang reichen vier Reiter, und drei davon gibt es in der Lektionsansicht schon. Je nach Sprache des Browsers heißen sie dort englisch oder deutsch. In einem deutschen Chrome sind es Konsole, Elemente, Netzwerk und Quellcode, in Firefox Konsole, Inspektor, Netzwerkanalyse und Debugger. Hier stehen die englischen Namen aus Chrome.
- Console ist der Reiter Console von hier, samt Eingabezeile, mit Fehlern, eigenen Ausgaben und einem Feld für Ausdrücke.
- Elements ist der Inspector von hier. Er zeigt dasselbe, nur zusätzlich als Baum, also das DOM, wie es gerade wirklich aussieht, mit allem, was dein Code eingefügt hat. Rechts daneben stehen die geltenden CSS-Regeln. Das ist der Reiter Regeln im Auskunftsstreifen, und „Computed“ daneben ist der Reiter Werte.
- Network ist der Reiter Netzwerk, jede Anfrage mit Status, Größe und Antwort. Dorthin geht es, wenn ein
fetchnicht das liefert, was du erwartest. - Sources ist neu, und für ihn lohnt sich der Weg. Der Reiter Debug zeigt hinterher, was in den Variablen stand, Sources zeigt es währenddessen. Ein Haltepunkt auf einer Zeilennummer hält das Programm dort an, und du siehst dich in Ruhe um, bevor es weitergeht. Dazu liegen die Dateien dort unter ihren echten Namen und nicht in einem zusammengebauten Dokument.
Die übrigen Reiter kommen, wenn sie gebraucht werden. Für drei der vier gilt schon, was du hier geübt hast.
Ins Netz damit
Auch das ist einfacher geworden. Ein Ordner mit statischen Dateien braucht keine Werkzeugkette und keinen eigenen Server.
Der Ordner kommt in ein Git-Repository, und das wird mit einem Anbieter wie GitHub Pages, Netlify oder Vercel verbunden. Ab da veröffentlicht jeder Push die neue Fassung. Alle drei sind für kleine Projekte kostenlos und liefern gleich ein https mit, also ist auch der sichere Kontext da.
Klein anfangen
Der Weg vom Kurs zum eigenen Projekt ist kürzer, als er sich anfühlt. Am leichtesten fängst du nicht mit der App an, die du eigentlich bauen willst, sondern mit einer der Aufgaben aus diesem Kurs, die du in einen eigenen Ordner kopierst und dort zum Laufen bringst. Das dauert zehn Minuten, und danach ist die Hürde weg.
In der Aufgabe entsteht das Gerüst in index.html. styles.css und app.js liegen daneben im Dateibaum, wie in einem eigenen Projektordner.
Zum Mitnehmen
Mehr als einen Ordner mit index.html, styles.css und app.js braucht eine eigene Seite nicht. Sobald Module oder fetch dazukommen, muss sie über einen kleinen lokalen Server laufen, weil eine Seite von file:// beides nicht darf. Console, Inspector und Netzwerk haben in den Entwicklerwerkzeugen des Browsers ein Gegenstück, nur Sources ist neu.
Jetzt du
Basis Konto, kostenlosZu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.
Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.
Was in dieser Lektion steckt
-
Artikel mit 3 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe im Editor, direkt im Browser geprüft
Öffnet sich mit dem Basis Konto.