HTML5-Tutorium: Canvas: Hello World 04

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)

Voraussetzung

Sie sollten die Inhalte des Tutoriums HTML5-Tutorium: Canvas: Hello World 03 kennen.

Ziel: Browser-Unhabhängigkeit mittels jQuery

Leider weichen die JavaScript-Implementierungen der einzelnen Browser ziemlich voneinander ab. Daher ist es fast immer sinnvoll, JavaScript-Bibliotheken einzusetzen, deren Hauptzweck es ist, diese Unterschiede auszugleichen. Daneben stellen sie im Allgemeinen auch noch viele sehr nützliche JavaScript-Erweiterungen zur Verfügung.

In diesem Tutorium soll die JavaScript-Bibliothek jQuery eingesetzt werden. Außerdem sollen alle Konstanten aus der JavaScript-Datei main.js in eine eigene Datei CONSTANT.js ausgelagert werden. Dies hat den Vorteil, dass die Konfiguration des Projekts (Bühnenbreite, Font-Wahl etc.) an einer zentralen Stelle erfolgen kann.

Anwendung „HelloWorldCanvas04“

Neues Projekt anlegen

Legen Sie ein neues „Statisches Web-Projekt“ mit dem Namen HelloWorldCanvas04 an.

Speichern Sie dieses Projekt wie üblich in Ihrem Repository.

Daten übernehmen und modifizieren

Legen Sie die Ordner js und css an und kopieren Sie die Dateien main.js, main.css und hello.html aus HelloWorldCanvas03 in die entsprechenden Ordner WebContent des neuen Projekts. Passen Sie das title-Element in der Datei hello.html an.

Ändern Sie den Haeder der HTML-Datei hallo.html so ba, dass Sie die unkomprimierten CSS- und JavaScript-Dateien einbinden.

    <!-- Laden aller CSS-Dateien -->
<!--<link rel="stylesheet" href="css/all.min.css" />-->
    <link rel="stylesheet" href="css/main.css"    />

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

Anderenfalls müssten Sie vor jedem Test zunächst das Komprimierungsskript build.xml ausführen. Dies vergisst man recht schnell und testet dann eine alte Version, bei der aktuelle Änderungen an den CSS- und JavaScript-Dateien nicht berücksichtigt werden.

Einbinden von jQuery

Laden Sie die komprimierte Version von jQuery herunter und speichern Sie diese unter dem Namen jquery.min.js irgendwo auf Ihrer Festplatte. Binden Sie nun jQuery in Ihr Projekt ein:

• Projektexplorer: Rechtsklick auf WebContent im Ordner HelloWorldCanvas04 → Klick auf Neu → Klick auf Ordner
• Ordnername: lib → Fertigstellen
• Rechtsklick auf den neu erstellen Ordner lib → Klick auf Importieren
• Allgemein aufklappen → Klick auf Dateisystem → Klick auf Weiter → Aus Verzeichnis: <Verzeichnis, in dem jQuery liegt> → Häckchen vor jquery.min.js → Fertigstellen (Beachten Sie, im Projektexplorer wird für ihr Projekt nun anagezeigt, dass es nicht frei von Syntaxfehlern sein soll.)
• Projektexplorer: Rechtsklick auf HelloWorldCanvas04 → Klick auf Eigenschaften → Klick auf JavaScript aufklappen → Klick auf IncludePath
• Klick auf Reiter Quelle → HelloWorldCanvas04/WebContent aufklappen → Klick auf Ausgeschlossen: (Kein) → Klick auf Bearbeiten ...
• Klick auf Hinzufügen unter „Ausschlussmuster“ (= zweiter Buton mit diesem Label!) → Eingabe von lib/** ins Textfeld
• OK → Fertigstellen → OK

Anmerkungen

Externe, d.h. nicht von Ihnen geschrieben JavaScript-Bibliotheken, sollten nicht im Ordner js liegen, da diese im allgemeinen schon komprimiert wurden und vom build nicht noch einmal komprimiert werden sollten. Daher wurde der neue Ordner lib angelegt.

Für diesen Ordner wurde außerdem das Syntax-Checking deaktiviert, da bei komprimierten JavaScript-Bibliotheken von Eclipse häufig Syntaxfehler gemeldet werden, obwohl überhaupt keine Fehler darinnen enthalten sind. Bei jquery.min.js ist dies beispielsweise der Fall. Nach dem Ausschluss des Ordners lib vom Syntaxchecking, sind die Fehlermarkierungen im Projektexplorer wieder verschwunden. Außerdem wird der Benutzer beim Speichern des Projekts im Repositorys nicht dauern mit einer Warnmeldung, dass im Projekt noch Fehler enthalten seien, genervt.

JavaScript-Code auf jQuery umstellen

Bevor Sie jqeury.min.js verwenden können, müssen Sie diese Datei in der HTML-Datei hallo.html laden. Erweitern Sie also den entsprechenden Abschnitt im HTML-Header:

    <!-- Laden aller JavaScript-Dateien -->
    <script type="text/javascript" src="lib/jquery.min.js"></script>
<!--<script type="text/javascript" src="js/all.min.js"    ></script>-->
    <script type="text/javascript" src="js/CONSTANT.js"   ></script>
    <script type="text/javascript" src="js/main.js"       ></script>

Die JavaScript-Datei CONSTANT.js enthält folgende Konstanten-Definitionen:

"use strict"; /* Warne vor unsauberem JavaScript-Code! */
 
const CANVAS_WIDTH  = 300,
      CANVAS_HEIGHT =  27,

      HELLO_POS_X       =  5,
      HELLO_POS_Y       = 20,
      HELLO_FONT_FAMILY = "'Times New Roman', Times, serif",
      HELLO_FONT_SIZE   = 20,
      HELLO_FONT_WEIGHT = "bold";

Anschließend können Sie die JavaScript-Datei main.js anpassen:

  window.onload = init;

wird durch

  $(document).ready(init);

ersetzt.

In der init-Funktion werden folgende Anpassungen vorgenommen:

  g_canvas  = document.getElementById("d_canvas");
  g_canvas.width  = 300;
  g_canvas.height =  27;

  g_context = g_canvas.getContext("2d");

wird durch

  g_canvas  = $("#d_canvas")
                .attr("width",  CANVAS_WIDTH)
                .attr("height", CANVAS_HEIGHT)
                [0]  // Array-Zugriff um das Raw-Canvas-Objekt 
                     // aus dem jQuery-Objekt zu extrahieren
              ;
  g_context = g_canvas.getContext("2d");

und

  // Interaktive HTML-Formular-Elemente mit JavaScript verknüpfen.
  document.getElementById("d_button_ok").onmousedown = sayHello;

durch

  // Interaktive HTML-Formular-Elemente mit JavaScript verknüpfen.
  $("#d_button_ok").click(sayHello);

Abschließend wird der vollständige Inhalt der sayHello-Funktion durch folgenden Code ersetzt:

  g_context.clearRect(0, 0, CANVAS_WIDTH, CANVAS_HEIGHT); // clear canvas
  g_context.font =         HELLO_FONT_WEIGHT
                   + " " + HELLO_FONT_SIZE + "px"
                   + " " + HELLO_FONT_FAMILY;
  g_context.fillText("Hallo " + $("#d_name").val() + "!",
                     HELLO_POS_X, HELLO_POS_Y
                    );

Testen und speichern

Testen Sie Ihre Anwendung und speichern Sie sie in Ihrem Repository.

Wenn Sie den Ordner lib nicht von der Syntaxcheck-Behandlung ausgenommen haben, poppt eine Warnung auf, dass Ihr Code Fehler enthält. Wenn nur jquery.js oder jquery.min.js als fehlerhaft markiert wurde, können Sie Ihr Projekt trotzdem sichern.

Quellen

2. Kowarschick (MMProg): Wolfgang Kowarschick; Vorlesung „Multimedia-Programmierung“; Hochschule: Hochschule Augsburg; Adresse: Augsburg; Web-Link; 2018; Quellengüte: 3 (Vorlesung)

Fortsetzung des Tutoriums

Sie sollten nun entweder das Hello-World-SVG-Tutorium oder das Minipong-Canvas-Tutorium bearbeiten.