HTML 4.01-Spezifikation

Deutsche Übersetzung

Diese Version:

http://www.edition-w3.de/TR/1999/REC-html401-19991224

Aktuelle Version:

http://www.edition-w3c.de/TR/html4

Übersetzer:

Christine Kühnel (Übersetzung, fachliche Kommentierung) <kuehnel@screenexa.net>

Stefan Mintert (Fachlektorat und fachliche Kommentierung) <www.mintert.com/stefan/mail/>

Stefan Schumacher (Übersetzung, fachliche Kommentierung) <sts@schumacher-netz.de>

Bei diesem Dokument handelt es sich um eine Übersetzung eines W3C-Textes. Dieser Text ist urheberrechtlich geschützt; bitte beachten Sie die nachfolgenden Hinweise des Originaldokuments. Die Rechte an der Übersetzung liegen bei den Übersetzern und dem Verlag Addison-Wesley. Die Übersetzung hat keine durch das W3C legitimierte, normative Wirkung. Das einzige maßgebliche Dokument ist das englische Original.

Bitte senden Sie Fehler und Korrekturen zur deutschen Fassung an die Übersetzer.

Kommentare der Übersetzer, die als solche gekennzeichnet sind, unterliegen dem Urheberrecht der Übersetzer. Sie sind nicht Bestandteil des Ursprungsdokuments.

Diese Veröffentlichung ist eine Vorveröffentlichung. Kein Teil dieses Textes darf kopiert werden. Alle Rechte vorbehalten. Nach Abschluss der Arbeit wird das endgültige Dokument unter der oben angegebenen Adresse veröffentlicht. Die jetzige Veröffentlichung während der laufenden Arbeit dient zur Information von Interessierten und zur Prüfung durch die Fachöffentlichkeit. Sollten Sie Fehler finden oder Verbesserungsvorschläge haben, schicken Sie diese bitte per Mail an die Übersetzer.
Folgende Teile liegen noch in Englisch vor und müssen noch in deutscher Fassung generiert werden: (a) Gesamtinhaltsverzeichnis (b) Index

18 Skripte

18.1 Einführung in Skripte

Skripte bieten Autoren eine Möglichkeit, HTML-Dokumente in sehr aktiver und interaktiver Weise zu erweitern. Beispiele dafür sind:

• Skripte können evaluiert werden, wenn ein Dokument geladen wird, um den Inhalt des Dokuments dynamisch zu verändern.
• Skripte können Formularen zur Seite gestellt werden, um Eingaben zu verarbeiten, wenn sie gemacht werden. Autoren können dynamisch Teile eines Formulars ausfüllen, die auf den Werten anderer Felder basieren. Sie könnten ebenfalls sicherstellen, dass Eingabedaten vorher festgelegten Wertebereichen entsprechen, dass Felder sich nicht gegenseitig ausschließen usw.
• Skripte können von Ereignissen (events) gesteuert werden, die das Dokument betreffen, wie zum Beispiel Laden, Entladen, Elementfokus, Mausbewegung usw.
• Skripte können mit Formular-Steuerelementen verknüpft werden (zum Beispiel Schaltflächen), um graphische Elemente in der Benutzerschnittstelle zu erzeugen.

Es gibt zwei Skriptarten, die Autoren zu einem HTML-Dokument hinzufügen können:

• Diejenigen, die einmal ausgeführt werden, wenn ein Dokument vom Benutzerprogramm geladen wird. Skripte, die innerhalb eines SCRIPT-Elements stehen, werden ausgeführt, wenn das Dokument geladen wird. Benutzerprogrammen, die Skripte nicht verarbeiten können oder werden, können Autoren alternativen Inhalt über das NOSCRIPT-Element zur Verfügung stellen.
• Diejenigen, die jedesmal ausgeführt werden, wenn ein bestimmtes Ereignis eintritt. Diese Skripte können mit mehreren Elementen über die Attribute für eingebettete Ereignisse verknüpft werden.

18.2 Dokumente für Benutzerprogramme erstellen, die Skripte unterstützen

Der folgende Abschnitt behandelt Fragen, die Benutzerprogramme betreffen, die Skripte unterstützen.

18.2.1 Das Element SCRIPT

<!ELEMENT SCRIPT - - %Script;          -- script statements -->
<!ATTLIST SCRIPT
  charset     %Charset;      #IMPLIED  -- char encoding of linked resource --
  type        %ContentType;  #REQUIRED -- content type of script language --
  src         %URI;          #IMPLIED  -- URI for an external script --
  defer       (defer)        #IMPLIED  -- UA may defer execution of script --
  >

Start-Tag: erforderlich, End-Tag: erforderlich

Das Element SCRIPT platziert ein Skript innerhalb eines Dokuments. Diese Element kann beliebig oft im HEAD oder BODY eines HTML-Dokuments stehen.

Das Skript kann im Inhalt des SCRIPT-Elements definiert werden oder in einer externen Datei. Ist das src-Attribut nicht angegeben, müssen Benutzerprogramme den Inhalt des Elements als Skript interpretieren. Besitzt das src-Attribut einen URI-Wert, müssen Benutzerprogramme den Elementinhalt ignorieren und das Skript über den URI empfangen. Beachten Sie, dass sich das charset-Attribut auf die Zeichenkodierung des Skripts bezieht, das durch jenes src-Attribut angegeben ist; es bezieht sich nicht auf den Inhalt des SCRIPT-Elements.

Skripte werden durch Skript-Engines evaluiert, die dem Benutzerprogramm bekannt sein müssen.

Die Syntax von Skriptdaten ist abhängig von der Skriptsprache (siehe Abschnitt 6.14).

18.2.2 Die Skriptsprache spezifizieren

Da HTML sich nicht auf eine bestimmte Skriptsprache beschränkt, müssen Autoren dem Benutzerprogramm die Sprache jedes einzelnen Skripts explizit mitteilen. Dies kann entweder durch eine Standard-Deklaration oder durch eine lokale Deklaration geschehen.

Die Standard-Skriptsprache  

Autoren sollten die Standard-Skriptsprache für alle Skripte in einem Dokument durch Angabe der folgenden META-Deklaration im HEAD festlegen:

<META http-equiv="Content-Script-Type" content="type">

»type« ist darin der Inhaltstyp (siehe Abschnitt 6.7), der die Skriptsprache benennt. Beispiele für Werte sind »text/tcl«, »text/javascript«, »text/vbscript«.

Ohne eine META-Deklaration kann der Standard durch den HTTP-Header »Content-Script-Type« gesetzt werden:

    Content-Script-Type: type

»type« ist hier ebenfalls ein Inhaltstyp, der die Skriptsprache benennt.

Benutzerprogramme sollten die Standard-Skriptsprache für ein Dokument anhand der folgenden Schritte festlegen (von der höchsten zur niedrigsten Priorität):

1. Spezifiziert eine META-Deklaration »Content-Script-Type«, so bestimmt der letzte im Zeichenstrom die Standard-Skriptsprache.
2. Anderenfalls, wenn dein HTTP-Header »Content-Script-Type« spezifiziert, bestimmt der letzte im Zeichenstrom die Standard-Skriptsprache.

Dokumente, die keine Informationen zur Standard-Skriptsprache geben und Elemente enthalten, die Skripte für eingebettete Ereignisse spezifizieren, sind inkorrekt. Benutzerprogramme können trotzdem versuchen, inkorrekt angegebene Skripte zu interpretieren, sind jedoch nicht dazu verpflichtet. Autoren-Tools sollten die Standard-Skriptsprachen-Information erzeugen, um Autoren dabei zu unterstützen, ungültige Dokumente zu vermeiden.

Lokale Deklaration einer Skriptsprache  

Das Attribut type muss für jede SCRIPT-Elementinstanz in einem Dokument angegeben sein. Der Wert des type-Attributs für ein SCRIPT-Element überschreibt für dieses Element die Standard-Skriptsprache.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
     "http://www.w3.org/TR/html4/strict.dtd">
<HTML>
<HEAD>
<TITLE>Ein Dokument mit SCRIPT</TITLE>
<META http-equiv="Content-Script-Type" content="text/tcl">
<SCRIPT type="text/vbscript" src="http://someplace.com/progs/vbcalc">
</SCRIPT>
</HEAD>
<BODY>
<SCRIPT type="text/javascript">
...etwas JavaScript...
</SCRIPT>
</BODY>
</HTML>

Referenzen auf HTML-Elemente aus einem Skript heraus 

Jede Skriptsprache hat ihre eigenen Konventionen, HTML-Objekte aus einem Skript heraus zu referenzieren. Diese Spezifikation definiert keinen Standardmechanismus, um sich auf HTML-Objekte zu beziehen.

Jedoch sollten Skripte mit Hilfe des Elementnamens Bezug auf ein Element nehmen. Skript-Engines sollten den folgenden Ablauf beachten, wenn sie ein Element identifizieren: ein name-Attribut hat Vorrang vor einem id-Attribut, wenn beide angegeben sind. Ansonsten kann das eine oder das andere verwendet werden.

18.2.3 Eingebette Ereignisse (intrinsic events)

Es ist möglich, eine Aktion mit einer bestimmten Anzahl von Ereignissen zu verknüpfen, die auftreten, wenn ein Benutzer mit einem Benutzerprogramm interagiert. Jedes der oben aufgeführten »eingebetteten Ereignisse« nimmt einen Wert an, der ein Skript ist. Das Skipt wird immer dann ausgeführt, wenn das Ereignis für dieses Element eintritt. Die Syntax der Skriptdaten ist abhängig von der Skriptsprache.

Steuerelemente wie INPUT, SELECT, BUTTON, TEXTAREA und LABEL reagieren alle auf bestimmte eingebettete Ereignisse. Stehen diese Elemente nicht innerhalb eines Formulars, können sie dazu verwendet werden, die graphische Benutzerschnittstelle des Dokuments aufzuwerten.

Zum Beispiel wollen Autoren vielleicht Schaltflächen in ihre Dokumente einbinden, die zwar kein Formular übertragen, aber dennoch mit einem Server kommunizieren, wenn sie aktiviert werden.

Die folgenden Bespiele zeigen einige mögliche Verhaltensweisen von Steuerelementen und Benutzerschnittstellen, die auf eingebetteten Ereignissen beruhen.

<INPUT NAME="userName" onblur="validUserName(this.value)">

<INPUT NAME="num"
    onchange="if (!checkNum(this.value, 1, 10)) 
        {this.focus();this.select();} else {thanks()}"
    VALUE="0">

    <INPUT name="edit1" size="50">    
    <SCRIPT type="text/vbscript">
      Sub edit1_changed()
        If edit1.value = "abc" Then
          button1.enabled = True
        Else
          button1.enabled = False
        End If
      End Sub
    </SCRIPT>

    <INPUT name="edit1" size="50">
    <SCRIPT type="text/tcl">
      proc edit1_changed {} {
        if {[edit value] == abc} {
          button1 enable 1
        } else {
          button1 enable 0
        }
      }
      edit1 onChange edit1_changed
    </SCRIPT>

    
<BUTTON type="button" name="mybutton" value="10">
<SCRIPT type="text/javascript">
      function my_onclick() {
         . . .
      }
    document.form.mybutton.onclick = my_onclick
 </SCRIPT>
 </BUTTON>

    
<SCRIPT type="text/javascript">
      function my_onload() {
         . . .
      }

      var win = window.open("some/other/URI")
      if (win) win.onload = my_onload
</SCRIPT>

 <SCRIPT type="text/tcl">
     proc my_onload {} {
       . . .
     }
     set win [window open "some/other/URI"]
     if {$win != ""} {
         $win onload my_onload
     }
 </SCRIPT>

18.2.4 Dynamische Modifikation von Dokumenten

Die dynamische Modifikation des Dokuments könnte wie folgt ausgeführt werden:

1. Alle SCRIPT-Elemente werden in der Reihenfolge evaluiert, in der das Dokument geladen wird.
2. Alle Skripte innerhalb eines gegebenen SCRIPT-Elements, die SGML-konformes CDATA erzeugen, werden evaluiert. Der generierte Text wird anstelle des SCRIPT-Elements in den Dokumentinhalt eingefügt.
3. Das erzeugte CDATA wird wieder evaluiert.

HTML-Dokumente müssen konform zu der HTML-DTD sein, sowohl bevor als auch nachdem irgendein SCRIPT-Element verarbeitet wurde.

 <TITLE>Testdokument</TITLE>
 <SCRIPT type="text/javascript">
     document.write("<p><b>Hello World!<\/b>")
 </SCRIPT>

 <TITLE>Testdokument</TITLE>
 <p><b>Hello World!</b>

18.3 Dokumente für Benutzerprogramme erstellen, die Skripte nicht unterstützen

Der folgende Abschnitt erörtert, wie Autoren Dokumente erzeugen können, die mit Benutzerprogrammen, die Skripte nicht unterstützen, funktionieren.

18.3.1 Das Element NOSCRIPT

<!ELEMENT NOSCRIPT - - (%block;)+
  -- alternate content container for non script-based rendering -->
<!ATTLIST NOSCRIPT
  %attrs;                              -- %coreattrs, %i18n, %events --
  >

Start-Tag: erforderlich, End-Tag: erforderlich

• Das Benutzerprogramm ist so konfiguriert, dass es Skripte nicht evaluiert.
• Das Benutzerprogramm unterstützt eine Skriptsprache nicht, die vorher durch ein SCRIPT-Element im Dokument angeführt wurde.

Benutzerprogramme, die Client-seitige Skripte nicht unterstützen, müssen den Inhalt dieses Elements darstellen.

<SCRIPT type="text/tcl">
 ...ein Tcl-Skript, um Daten einzufügen...
</SCRIPT>
<NOSCRIPT>
 <P>Zugang zu <A href="http://someplace.com/data">data.</A>
</NOSCRIPT>

18.3.2 Skriptdaten vor Benutzerprogrammen verbergen

Benutzerprogramme, die das SCRIPT-Element nicht erkennen, werden wahrscheinlich den Inhalt des Elements als Text darstellen. Einige Skript-Engines, einschließlich der Engines für die Sprachen JavaScript, VBScript und Tcl, gestatten die Angabe der Skriptzeilen in SGML-Kommentaren. Benutzerprogramme, die das SCRIPT-Element nicht erkennen, werden folglich den Kommentar ignorieren, während clevere Skript-Engines verstehen werden, dass dieses Skript im Kommentar ausgeführt werden soll.

Eine weitere Lösung des Problems ist die Speicherung der Skripte in externen Dokumenten und ihr Aufruf über das Attribut src.

<SCRIPT type="text/javascript">
<!--  um Skriptinhalt vor alten Browsern zu verstecken
  function square(i) {
    document.write("The call passed ", i ," to the function.","<BR>")
    return i * i
  }
  document.write("The function returned ",square(5),".")
// end hiding contents from old browsers  -->
</SCRIPT>

   <SCRIPT type="text/vbscript">
     <!--
       Sub foo()
        ...
       End Sub
     ' -->
    </SCRIPT>

<SCRIPT type="text/tcl">
<!--  um Skriptinhalt vor alten Browsern zu verstecken
  proc square {i} {
    document write "The call passed $i to the function.<BR>"
    return [expr $i * $i]
  }
  document write "The function returned [square 5]."
# end hiding contents from old browsers  -->
</SCRIPT>