HTML5-Tutorium: Canvas: Hello World 01

aus GlossarWiki, der Glossar-Datenbank der Fachhochschule Augsburg

Dieser Artikel erfüllt die GlossarWiki-Qualitätsanforderungen:

Korrektheit: 4
(großteils überprüft) 		Umfang: 4
(unwichtige Fakten fehlen) 		Quellenangaben: 5
(vollständig vorhanden) 		Quellenarten: 5
(ausgezeichnet) 		Konformität: 4
(sehr gut)

HTML-Tutorium Hello World: JavaScript | Canvas | SVG

Inhalt | Teil 1 | Teil 2

Musterlösung: hallo.html (SVN-Repository)

Ziel: Ausgabe von „Hallo Welt!“ auf einem HTML5-Canvas

Es soll eine einfache HTML5/JavaScript-Anwendung erstellt werden, die „Hallo Welt!“ auf einer HTML5-Bühne (Canvas) als Pixelgrafik ausgibt.

Eclipse vorbereiten

Zur Erstellung der Anwendung wird Eclipse eingesetzt.

Beim ersten Start von Eclipse werden Sie nach einem Workspace gefragt. Wählen Sie einen geeigneten Ordner aus:

  • Privater Rechner: z.B. C:\web\mmprog
  • HSA-Rechner: z.B. Z:\mmprog\workspace (Wichtig ist, dass Sie das Laufwerk Z, das ist Ihr persönliches Benutzerverzeichnis, benutzen.)

Zum Testen wird der Browser Firefox mit dem Firebug-Plugin verendet.

Unter Eclipse kann der Testbrowser folgendermaßen festgelegt werden:

  • Fenster → Benutzervorgaben → Allgemein aufklappen → Webbrowser selektieren → Verwende externen Web-Browser selektieren → Häckchen vor Firefox → OK

Zunächst sollte man die „richtige“ Oberfläche auswählen:

  • Fenster → Perspektive öffnen → Web (evtl. unter dem Punkt Andere... zu finden;

Beachten Sie, es gibt zwei Web-Perspektiven. Wählen Sie diejenige, die die Weltkugel mit Stift als Icon hat.

Außerdem muss der Character Code korrekt eingestellt werden:

  • Fenster → Benutzervorgaben → Allgemein aufklappen → Arbeitsbereich selektieren
  • Sonstige selektieren → UTF-8 im Drop-Down-Menü selektieren
  • OK

Musterlösung herunterladen

Laden Sie die Musterlösung in Eclipse:

  • Klick auf Reiter Datei → Importieren
  • SVN aufklappen → Klick auf Checkout Projects from SVN → Weiter
  • Entweder
  • Weiter
  • Nachden der Dateibaum aufgegangen ist: html5_canvas aufklappen → hello_world aufklappen → html5_canvas_hello_world_01 selektieren
  • Fertigstellen

Anmerkung

Auf dieselbe Weise können Sie auch Ihre eigenen Projekte aus Ihrem eigenen Repository auf beliebige Rechner laden.

Wenn Sie mit der Bearbeitung Ihres Projektes auf einem Rechner aufhören, sollten Sie stets den aktuellen Stand in Ihrem Repository sichern:

  • Im Projektexplorer: Rechtsklick auf das aktuelle Projekt → Klick auf Team → Click auf Commit

Wenn Sie danach auf einem anderen Rechner an diesem Projekt weiterarbeiten wollen, müssen sie beim ersten MAl das Projekt in der oben beschriebenen Weise aus dem Repository auf Ihren Rechner laden. Wenn Sie dies einmal gemacht haben, reicht es wen Sie künftig die lokale Version auf dem Rechner aktualisieren, bevor Sie mit der Arbeit beginnen:

  • Im Projektexplorer: Rechtsklick auf das aktuelle Projekt → Klick auf Team → Click auf Update to HEAD

Anwendung „HelloWorldCanvas01“

Neues Projekt anlegen

  • Datei → Neu → Statisches Web-Projekt
  • Project name: HelloWorldCanvas01 → Fertigstellen
  • Eventuell: Web-Perspektive wählen

Speichern Sie nun Ihr Projekt in Ihrem Repository:

  • Projektexplorer: Rechtsklick auf HelloWorldCanvas01 → Team → Projekt gemeinsam nutzen
  • SVN → Weiter
  • Create a new repository location selektieren
  • URL: https://praktikum.multimedia.hs-augsburg.de/svn/ACCOUNT (ACCOUNT durch eigenen RZ-Account ersetzen) → Weiter
  • Use specified folder name: mmprog/tutorium/HelloWorldCanvas01 → Fertigstellen
  • Beim ersten Mal: Klick auf Accept permanently
  • Beim ersten Mal: Passwort eingeben → Häckchen bei Passwort merken (sonst muss man künftig für jede hozuladende Datei das Passwort eingeben) → OK
  • Eventuell: Häckchen bei Entscheidung merken → Nein (Nicht Ja!!!!)

Projekt im Repository sichern

Das neu angelegte Projekt wird gleich mal im Repository gesichert:

  • Im Projektexplorer: Rechtsklick auf HelloWorldCanvas01 → Team → Commit
  • Enter a comment for the commit operation: Neues Projekt angelegt.
  • OK

Neue HTML-Datei anlegen

  • Im Projektexplorer (linkes Fenster): HelloWorldCanvas01 aufklappen
  • Rechtsklick auf Ordner WebContent → Neu → HTML file
  • Dateiname: hallo.html → Weiter → Templates: New HTML File (5) → Fertigstellen

HTML-Datei bearbeiten

Erfassen Sie nun folgenden Code in der HTML-Seite: 

<!DOCTYPE html>
<html>
  <head>

    <!-- Titel der HTML-Seite; wird i. Allg. im Browser im Reiter angezeigt -->
    <title>HTML5-Tutorium: Canvas: Hello World 01</title>

    <!-- Als HTML-Encoding sollte man stets UTF-8 verwenden. -->
    <meta charset="UTF-8">

    <!-- Korrektes Skalieren der Seite auf einem mobilen Endgerät -->
    <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
 
    <!-- Zeichnen von "Hallo Welt!" auf der Bühne
    	  (nachdem die Seite geladen wurde). -->
    <script type="text/javascript">
      function init()
      { var l_canvas = document.getElementById("d_canvas");
 
        l_canvas.width  = 300;
        l_canvas.height =  27;
 
        var l_context = l_canvas.getContext("2d");
        
        l_context.font = "bold 20px 'Times New Roman', Times, serif";
        l_context.fillText("Hallo Welt!", 5, 20);
      }
    </script>

  </head>

  <body onload="init()">

    <!-- Die Bühne (Canvas) -->
    <canvas id="d_canvas">
      Ihr Browser unterstützt HTML5 leider nicht!
    </canvas>

  </body>
</html>

Anmerkung 1

Auf das Canvas-Element wird ausschließlich von JavaScript aus zugegriffen. Sollte ein Browser dieses Element nicht unterstützen, so wird der alternative HTML-Code innerhalb des Canvas-Element gerendert und ausgegeben. Hier könnte beispielsweise eine Flash-Anwendung ausgeführt werden.

Anmerkung 2

Die Meta-Anweisung 

<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">

dient dazu, dass der Inhalt der Seite auf einem Smartphone in der richtigen Größe angezeigt wird.

Anmerkung 3

Es gibt auch einen WYSIWYG-Editor, den Sie folgendermaßen öffnen können:

  • Rechtklick in das Editor-Fenster → Öffnen mit → Web Page Editor

Allerdings unterstützt dieser WYSIWYG-Editor die HTML5-Zeichenbühne Canvas nicht und ist daher für dieses Tutorium nicht sonderlich nützlich.

HTML-Seite testen

  • hallo.html speichern: Strg-s
  • Wichtig: Im Projektexplorer jeweils vor dem Server-Aufruf hallo.html selektieren, sonst erhalten Sie eine Fehlermeldung.
  • In der Icon-Zeile: Klick auf Icon „grüner Kreis mit weißen Dreieck“ → Serverziel auswählen: JavaScript Web Application
  • OK

Anmerkungen zum Firefox auf den Rechnern des MM-Labors

Defaultmäßig kann der Firefox im MM-Labor nicht auf lokale Webserver (wie z.B. den Aptana-Server) zugreifen.

Grund: In diesem Firefox ist eine unpassende Proxy-Konfiguration voreingestellt. Diese Einstellung verhindert den Zugriff auf localhost.

Lösung des Problems:

  • Firefox starten
  • Einstellungen → Erweitert → Netzwerk → Einstellungen
  • Haken von Proxy-Einstellungen des Systems verwenden auf Manuelle Proxy-Konfiguration setzen und als Ausnahme localhost und 127.0.0.1 einstellen.

Anmerkungen zum Test-Sever

Solange Sie nur HTML-Seiten, die JavaScript-Code enthalten, testen wollen, ist das Serverziel JavaScript Web Application die beste Wahl.

Sie können allerdings auch andere Web-Server verwenden:

  • Den HTTP-Preview-Server, der in Eclipse integriert ist (probieren Sie diesen ruhig einmal an Stelle des JavaScript-Web-Application-Servers aus)
  • Tomcat (hier muss Tomcat installiert und mit Eclipse verknüpft werden)
  • Apache (hier muss Apache installiert und mit Eclipse verknüpft werden; siehe Teil 2 des Tutoriums)
  • etc.

In allen diesen Fällen müssten Sie Run on Server an Stelle von JavaScript Web Application auswählen:

  • In der Icon-Zeile: Klick auf Icon „grüner Kreis mit weißen Dreieck“ → Serverziel auswählen: Run on Server
  • OK

Den HTTP-Preview-Server wählen Sie folgendermaßen:

  1. HTTP Preview → Fertigstellen

Beachten Sie, dass beim HTTP-Preview-Server mit jedem Klick des Debug-Icons (grüner Kreis mit weißen Dreieck) ein neues Browserfenster in Eclipse geöffnet wird. Daher ist es sinnvoller, im bestehenden Browserfenster das Reload-Icon (zwei kreiförmig angeordnete Pfeile) anzuklicken, um Änderungen an einer der Web-Dateien sichtbar zu machen.

Für komplexere Web-Seiten mit PHP-Code, JSP-Code etc. muss man einen echten Server (wie Apache oder Tomcat) installieren und mit Eclipse verknüpfen.

Wenn der von Ihnen gewählte Test-Web-Server Probleme hat, die neuen HTML-Seiten darzustellen, kann es notwendig sein, den Server neu zu starten:

  • Reiter Server im unteren Fenster selektieren
  • Klick auf Icon „rotes Recheck“ (Server stoppen)
  • Klick auf Icon „grüner Kreis mit weißem Dreieck“ (Server starten)

Projekt im Repository sichern

Jedes funktionierende Zwischenergebnis eines Projektes sollte im Repository gespeichert werden:

  • Im Projektexplorer: Rechtsklick auf HelloWorldCanvas01 → Team → Commit
  • Enter a comment for the commit operation: hallo.html, ein HTML5-JavaScript-Moloch wurde erstellt.
  • OK

JavaScript-Code auslagern

Man sollte i. Allg. vermeiden, Javascript-Code direkt in eine HTML-Seite einzufügen. Diese Verknüpfung von View und Control bringt nur Nachteile mit sich:

  • Der Code wird unübersichtlicher, da zwei unterschiedliche Sprachen gemischt werden (Impedance Mismatch).
  • Der JavaScript-Code kann nicht in mehreren HTML-Dateien eingesetzt werden (Don't Repeat Yourself).
  • Die Ladezeiten der einzelnen Seiten werden länger, wenn derselbe JavaScript-Code in unterschiedlichen Seinten eingebaut ist und für jede dieser Seiten erneut geladen werden muss.

Aus diesen Gründen sollte man den JavaScript-Code in eigene Dateien auslagern:

  • Rechtsklick auf Ordner WebContent → Neu → Ordner → Ordnername: js → Fertigstellen
  • Rechtsklick auf Ordner js → Neu → Datei → Dateiname: main.js → Fertigstellen

Inhalt der Datei main.js

Wie bei HTML-Dateien können Sie auch für JavaScript eine alternativen Editor verwenden: JavaScript Source Editor 

"use strict"; /* Warne vor unsauberem JavaScript-Code! */

function init()
{
  // Erzeugung und Initialisierung der Bühne (Canvas)
  var l_canvas = document.getElementById("d_canvas"); 

  l_canvas.width  = 300;
  l_canvas.height =  27;

  // Textausgabe (auf der Bühne)
  var l_context = l_canvas.getContext("2d");

  l_context.font = "bold 20px 'Times New Roman', Times, serif";
  l_context.fillText("Hallo Welt!", 5, 20);
}

Geänderter Inhalt der Datei hallo.html

<!DOCTYPE html>
<html>
  <head>

    <!-- Titel der HTML-Seite; wird i. Allg. im Browser im Reiter angezeigt -->
    <title>HTML5-Tutorium: Canvas: Hello World 01</title>

    <!-- Als HTML-Encoding sollte man stets UTF-8 verwenden. -->
    <meta charset="UTF-8">

    <!-- Korrektes Skalieren der Seite auf einem mobilen Endgerät -->
    <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">

    <!-- Laden aller JavaScript-Dateien -->
    <script type="text/javascript" src="js/main.js"></script>

  </head>

  <body onload="init()">

    <!-- Die Bühne (Canvas) -->
    <canvas id="d_canvas">
      Ihr Browser unterstützt HTML5 leider nicht!
    </canvas>

  </body>
</html>

Tipp

Benutzen Sie am Besten die Code-Vervollständigung (Strg-Leerzeichen bzw. Ctrl-Space).

Beispiel:

  • Klicken Sie testweise im Editor-Fenster der Datei main.js in die leere Zeile 5 der Funktion init.
  • Drücken Sie Strg-Leerzeichen und wählen Sie z.B. l_canvas.
  • Geben Sie einen Punkt (.) ein und drücken Sie erneut Strg-Leerzeichen.* Löschen Sie den eben erfassten Inhalt wieder. (Ihre Datei main.js sollte ja schon fertiggestellt gewesen sein.)

Projekt testen

Testen Sie Ihr Projekt wieder, indem Sie es im Firefox öffen.

Häufig ist der JavaScript-Code bei den ersten Tests fehlerhaft. In diesen Fällen hilft einem die JavaScript-Konsole, die z.B. über das Firefox-Plugin Firebug zugänglich ist, häufig weiter.

Fügen Sie folgenden Code am Ende des Rumpfes der init-Funktion ein: 

  console.log(  "Canvas wurde erstellt: " 
              + l_canvas.width + "*" + l_canvas.height + " Pixel."
             );

Wenn Sie nun die Anwendung erneut im Firefox ausführen, sehen Sie zunächst keine Veränderung.

Überprüfen Sie, ob Firebug im Firefox aktiviert wurde (Drop-Down-Menü beim Icon mit dem Bug (= Käfer) in der rechten oberen Ecke von Firefox).

Öffnen Sie nun das Firebug-Fenster (Icon mit dem Bug) und laden Sie die JavaScript-Anwendung erneut (Reload im Firefox).

Nun sollten Sie im Konsolen-Fenster von Firebug einen Kommentar lesen können.

Wenn alle Tests erfolgreich verlaufen sind, ist es sinnvoll, die Konsolenausgaben mittels // oder /* ... */ auszukommentieren.

Projekt im Repository sichern

Auch das Endergebnis des Projektes sollte im Repository gespeichert werden:

  • Im Projektexplorer: Rechtsklick auf HelloWorldCanvas01 → Team → Commit
  • Enter a comment for the commit operation: main.js wurde erstellt, zur Auslagerung des JS-Codes aus hallo.html.
  • OK

Repostitory begutachten

Nun können Sie den Inhalt in Ihrem Repository betrachten.

Hier sehen Sie zunächst den Inhalt des von Ihnen gespeicherten Projektes. Das Repository kann aber noch mehr. Sie können sich alle gespeicherten Versionen Ihres Projektes ansehen:

  1. Rechtsklick auf HelloWorldCanvas01 aufklappen → Show History

Nun sehen Sie im Protokoll-Fester die verschiedenen Versionen des Projektes, mit Revisionsnummer, Author (ein Repository kann von mehreren Autoren gelichzeitig benutzt werden), sowie die von Ihnen eingegebenen Kommentare.

Als Letztes sollten Sie sich die Entwicklung der Datei hallo.html einmal näher ansehen:

  1. Im Dateibaum WebContent aufklappen → Rechtsklick auf hallo.html → Show Revision Graph

Hier sehen Sie, dass es von dieser Datei zwei Versionen gibt. Diese können wir auch miteinander vergleichen:

  1. Im Dateibaum Rechtsklick auf hallo.html → Compare → OK

In Vergleich der beiden Versionen erkennt mann, dass der JavaScript-Code durch einen Zugriff auf die Datei js/main.js ersetzt wurde.

Kehren Sie nun in die normale Arbeitsumgebung zurück:

  1. In der Icon-Leiste oben rechts auf das Icon der Arbeitsumgebung (Perspektive) Web klicken.

Neben den Icon Web finden Sie jetzt auch ein Icon für die Arbeitsumgebung SVN Repository Exploring, damit Sie künftig schneller in diese Perspektive wechseln können.

Quellen

Siehe auch

Fortsetzung des Tutoriums

Sie sollten nun Teil 2 des Tutoriums bearbeiten.

Abgerufen von „https://glossar.hs-augsburg.de/w/index.php?title=HTML5-Tutorium:_Canvas:_Hello_World_01&oldid=27084“