18 Les scripts

18.1 Introduction aux scripts

Les scripts offrent aux auteurs le moyen d'accroître les documents HTML de manière à les rendre très réactifs et interactifs. Par exemple :

• des scripts peuvent être évalués au chargement du document et modifier le contenu de celui-ci dynamiquement ;
• des scripts peuvent accompagner un formulaire et en traiter les entrées au fur et à mesure. Les concepteurs peuvent remplir dynamiquement des parties du formulaire en fonction des valeurs des autres champs. Ils peuvent aussi s'assurer que les données entrées appartiennent à un éventail prédéterminé de valeurs, que les champs soient cohérents les uns avec les autres, etc. ;
• des scripts peuvent être déclenchés par les événements qui affectent le document, tels que le chargement, le déchargement, l'attention d'un élément [ndt. element focus], le mouvement de la souris, etc. ;
• des scripts peuvent être attachés aux commandes d'un formulaire (par exemple, les boutons) et produire les éléments d'une interface utilisateur graphique.

Il existe deux types de script que les auteurs peuvent attacher à un document HTML :

• ceux qui sont exécutés une seule fois quand le document est chargé par l'agent utilisateur. Les scripts qui apparaissent à l'intérieur d'un élémnet SCRIPT s'exécutent quand le document est chargé. Pour les agents utilisateurs qui ne peuvent pas ou ne pourront pas gérer les scripts, l'auteur peut inclure un contenu de remplacement via l'élément NOSCRIPT ;
• ceux qui sont exécutés toutes les fois où un événement particulier se produit. Ces scripts peuvent être assignés à un certain nombre d'éléments au moyen des attributs d'événement intrinsèque.

18.2 La conception des documents pour les agents utilisateurs qui gèrent les scripts

Les sections suivantes abordent les questions concernant les agents utilisateurs qui gèrent les scripts.

18.2.1 L'élément SCRIPT

<!ELEMENT SCRIPT - - %Script;          -- déclartions du script -->
<!ATTLIST SCRIPT
  charset     %Charset;      #IMPLIED  -- encodage de caractères de la ressource reliée --
  type        %ContentType;  #REQUIRED -- type de contenu du langage de script --
  src         %URI;          #IMPLIED  -- URI d'un script externe --
  defer       (defer)        #IMPLIED  -- différer l'exécution du script --
  >

Balise ouvrante: obligatoire, balise fermante : obligatoire

L'élément SCRIPT installe un script dans le document. Cet élément peut apparaître un nombre quelconque de fois dans les éléments HEAD ou BODY d'un document HTML.

Le script peut être défini en contenu de l'élément SCRIPT ou dans un fichier externe. Si l'attribut src n'est pas spécifié, alors l'agent utilisateur doit interpréter le contenu de l'élément comme étant le script. Si l'attribut src a une valeur d'URI, alors l'agent utilisateur doit ignorer le le contenu de l'élément et ramener le script désigné par l'URI. Remarquez que l'attribut charset se réfère à l'encodage de caractères du script désigné par l'attribut src ; cela ne concerne pas le contenu de l'élément SCRIPT.

Les scripts sont évalués par les moteurs de script, qui doivent être connus de l'agent utilisateur.

La syntaxe des données du script dépend du langage de script.

18.2.2 La spécification du langage de script

Comme HTML ne dépend pas d'un langage de script particulier, les auteurs des documents doivent indiquer explicitement aux agents utilisateurs le langage de chaque script. Cela peut être fait soit au travers d'une déclaration par défaut, soit par une déclaration locale.

Le langage de script par défaut  

Les auteurs devraient spécifier le langage de script par défaut pour tous les scripts d'un document, en incluant la déclaration META suivante dans l'élément HEAD :

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

dans laquelle la valeur "un_certain_type" représente le type de contenu nommant le langage de script. En exemple de telles valeurs : "text/tcl", "text/javascript", "text/vbscript".

En l'absence d'une déclaration META, le langage par défaut peut être fixé par un en-tête HTTP « Content-Script-Type ».

    Content-Script-Type: un_certain_type

dans lequel la valeur "un_certain_type" représente encore le type de contenu nommant le langage de script.

Les agents utilisateurs devraient déterminer le langage de script par défaut du document selon les étapes suivantes (de la priorité la plus grande à la plus faible) :

1. Si d'éventuelles déclarations META spécifient une valeur "Content-Script-Type", c'est la dernière dans le flux de caractères qui détermine le langage de script par défaut ;
2. Sinon, si d'éventuels en-têtes HTTP spécifie "Content-Script-Type", c'est le dernier dans le flux de caractères qui détermine le langage de script par défaut.

Les documents, qui ne spécifient pas de langage de script par défaut et qui contiennent des éléments spécifiant un script d'événement intrinsèque, sont erronés. Les agents utilisateurs peuvent toujours essayer d'interpréter les scripts spécifiés incorrectement mais ils ne sont pas obligés de le faire. Les outils d'édition devraient générer une indication de langage de script par défaut pour aider les auteurs à créer des documents corrects.

La déclaration locale du langage de script 

On doit spécifier l'attribut type pour chaque instance de l'élément SCRIPT dans le document. La valeur de l'attribut type d'un élément SCRIPT surclasse le langage de script par défaut de cet élément.

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

L'appel des éléments HTML à partir d'un script 

Chaque langage de script obéit à ses propres règles pour appeler des objets HTML à partir d'un script. Cette spécification ne définit pas de mécanisme standard pour appeler les objets HTML.

Néanmoins, les scripts devraient se référer à un élément en fonction du nom qui lui est assigné. Les moteurs de scripts devraient observer les règles de préséance suivantes dans l'identification d'un élément : l'attribut name est prioritaire sur l'attribut id, quand tous les deux sont spécifiés. Sinon, on peut utiliser l'un ou l'autre.

18.2.3 Les événements intrinsèques

Il est possible d'associer une action à un certain nombre d'événements, qui se produisent quand l'utilisateur interagit avec l'agent utilisateur. Chacun des « événements intrinsèques » listés ci-dessus prend comme valeur un script. Le script s'exécute toutes les fois où l'événement se produit pour cet élément. La syntaxe des données de script dépend du langage de script.

Les éléments de commande, à savoir INPUT, SELECT, BUTTON, TEXTAREA et LABEL, répondent tous à certains événements intrinsèques. Quand ces éléments n'apparaissent pas dans un formulaire, on peut les employer pour augmenter l'interface utilisateur graphique du document.

Par exemple, l'auteur peut vouloir inclure des boutons poussoirs dans son document, ceux-ci ne soumettant pas de formulaire mais commnuniquant quand même avec un serveur quand ils sont activés.

Les exemples suivants montrent quelques commandes et comportements d'interface utilisateur possibles réalisés à partir d'événements intrinsèques.

<INPUT NAME="nomUtilisateur" onblur="verifNomUtilisateur(this.value)">

<INPUT NAME="nombre"
    onchange="if (!verifNombre(this.value, 1, 10))
        {this.focus();this.select();} else {remercier()}"
    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="mon_bouton" value="10">
<SCRIPT type="text/javascript">
      function mon_onclick() {
         . . .
      }
    document.form.mybutton.onclick = mon_onclick
 </SCRIPT>
 </BUTTON>

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

      var win = window.open("un/autre/URI")
      if (win) win.onload = mon_onload
</SCRIPT>

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

18.2.4 La modification dynamique des documents

On peut modéliser la modification dynamique d'un document comme suit :

1. Tous les éléments SCRIPT sont évalués dans l'ordre au fur et à mesure du chargement du document ;
2. Toutes les structures de script à l'intérieur d'un élément SCRIPT donné, qui génèrent des valeurs SGML de type CDATA, sont évaluées. Leur texte généré combiné est inséré dans le document à la place de l'élément SCRIPT ;
3. Les données générées de type CDATA sont ré-évaluées.

Les documents HTML sont contraints de se conformer au DTD HTML avant comme après le traitement de chaque élément SCRIPT.

 <TITLE>Document de test</TITLE>
 <SCRIPT type="text/javascript">
     document.write("<p><b>Bonjour tout le monde !<\/b>")
 </SCRIPT>

 <TITLE>Document de test</TITLE>
 <P><B>Bonjour tout le monde !</B>

18.3 La conception des documents pour les agents utilisateurs qui ne gèrent pas les scripts

Les sections suivantes expliquent comment les auteurs peuvent créer des documents qui fonctionnent auprès des agents utilisateurs ne reconnaissant pas les scripts.

18.3.1 L'élément NOSCRIPT

<!ELEMENT NOSCRIPT - - (%block;)+
  -- contenu de remplacement pour une restitution sans les scripts -->
<!ATTLIST NOSCRIPT
  %attrs;                              -- %coreattrs, %i18n, %events --
  >

Balise ouvrante: obligatoire, balise fermante : obligatoire

• l'agent utilisateur est configuré pour ne pas évaluer les scripts ;
• l'agent utilisateur ne reconnaît pas le langage de script invoqué par un élément SCRIPT apparu plus tôt dans le document.

Les agents utilisateurs qui ne gèrent pas les scripts côté client doivent restituer le contenu de cet élément.

<SCRIPT type="text/tcl">
 ...un script Tcl qui insère des données...
</SCRIPT>
<NOSCRIPT>
 <P>Acc&eacute;der aux <A href="http://quelquepart.com/data">donn&eacute;es.</A>
</NOSCRIPT>

18.3.2 La dissimulation des données de script aux agents utilisateurs

Les agents utilisateurs qui ne reconnaissent pas l'élément SCRIPT vont vraisemblablement restituer le contenu de cet élément comme un texte. Certains moteurs de script, dont ceux des langages JavaScript, VBScript et Tcl, autorisent la délimitation des déclarations d'un script par un commentaire SGML. Les agents utilisateurs, qui ne reconnaissent pas l'élément SCRIPT, ignoreront donc le commentaire alors que les moteurs de script intelligents comprendront que le script dans le commentaire devrait être exécuté.

Une autre solution à ce problème, c'est de placer les scripts dans des documents externes et de les appeler avec l'attribut src.

<SCRIPT type="text/javascript">
<!-- pour dissimuler le contenu du script aux navigateurs anciens
  function square(i) {
    document.write("L'appel a pass&eacute; ", i ," &agrave; la fonction.","<BR>")
    return i * i
  }
  document.write("La fonction a renvoy&é ",square(i),".")
// fin de la dissimulation du contenu aux navigateurs anciens -->
</SCRIPT>

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

<SCRIPT type="text/tcl">
<!--  pour dissimuler le contenu du script aux navigateurs anciens
  proc square {i} {
    document write "L'appel a pass&eacute; $i &agrave; la fonction.<BR>"
    return [expr $i * $i]
  }
  document write "La fonction a renvoy&eacute; [square 5]."
# fin de la dissimulation du contenu aux navigateurs anciens -->
</SCRIPT>