====== Javascript dans une page web ======
JS, dans une page web, permet une **programmation événementielle**.
Cliquer sur un bouton, passer le curseur de la souris au-dessus d'une zone, écrire dans un champ de texte... Ce sont des événements qui nous permettent d’interagir avec une page web.
JS permet de capter ces événements et de déclencher un programme. Un clic de souris capté par JS permettra d'ajouter un élément, dérouler un menu, changer une couleur, valider une saisie, envoyer un message vers le serveur...
Pour l'ensemble de ce cours, vous aurez besoin des fichiers contenus dans {{ :nsi:premiere:web:js.zip |}}. Décompressez cette archive dans un dossier local.
===== Premier événement =====
**À faire :** ''page_1.html'' est un fichier de l'archive. Ouvrez le dans un navigateur.page 1
Ci-dessous, trois blocs div en couleur. Quand on clique sur le carré rouge, un message s'affiche.
Notez en ligne 10 l'utilisation de la fonction ''alert''.
**À faire :** modifiez le code html pour que les autres boutons lancent un message également.
===== Environnement de travail =====
Avant d'aller plus loin, vous allez découvrir les outils, disponibles sur **Chrome** ou **Firefox**, qui permettent de bien travailler quand on programme dans une page web.
Appuyez **CTRL + MAJ + I**. Un panneau s'ouvre à droite ou en bas -- //vous pouvez le déplacer//. Il est composé de différents onglets :
* **Inspecteur :** vous pouvez sélectionner n'importe quel item sur la page et par exemple analyser ses attributs de style.
* **Console :** messages d'erreurs ou autres.
* **Réseau :** sera utile quand on voudra échanger des données avec un serveur.
Sur Firefox il y a même un outil permettant de voir comment la page sera sur un écran de téléphone !
page 2**À faire :** ouvrez ''page_2.html'' dans un navigateur. Ouvrez la console. Appuyez sur les boutons. Que constatez-vous ?
===== Plus gros programme =====
On rencontre le même problème qu'avec le style : s'il faut écrire le code JS à l'intérieur des balises html, cela va être peu lisible et rapidement impossible à gérer.
Une première étape consiste à placer le code JS dans la zone ''
''. On peut définir des fonctions et appeler ces fonctions lors d'un événement.
==== Modifier la page ====
Dans l'exemple qui va suivre, on va faire mieux que d'afficher un popup d'alerte ou log en console, nous allons modifier la page.
JS peut accéder à la page à l'aide d'une variable ''document'', et cette variable est dotée de fonctions qui permettent de lire le contenu, en ajouter, modifier les styles...
Quand on accède aux éléments de la page, la page est appelé le **DOM** pour //Document Object Model//. Le DOM, c'est la page html avec toutes ses nœuds structurés en arbre : '''' a des enfants, par exemple des ''%%
%%'' qui ont eux-mêmes des enfants, par exemple ''
''...
==== Exemple ====
* on crée un élément de texte (on parle de nœuds, en anglais //node//),
* pour contenir ce texte on crée un élément paragraphe (balise de type ''
'',
* on récupère le nœud de la zone réservée aux messages qui est identifiée par un attribut ''id = "divMessages"'',
* on ajoute le le nœud de texte dans le noeud paragraphe et le nœud paragraphe dans le nœud ''divMessages''.
page 3
Démonstration
Cliquez sur les boutons.
**À faire :** ouvrez ''page_3.html'' dans un navigateur. Vérifiez le bon fonctionnement. Modifiez le code pour que les messages s'affichent dans une liste ordonnée type ''''.
===== Script à part =====
Poussons la logique de séparation un pas plus loin : Nous déplaçons le JS dans un fichier à part -- dans un site moderne, la taille totale du JS peut être plus grande que celle du html !
Dans le code ci-dessous, le script à été déplacé dans le fichier annexe ''script_4.js''.
Remarquez qu'il reste tout de même du code JS dans la page en lignes 11-13.
page 4
Cliquez sur les boutons.
Zone pour les messages
// script_4.js
// Fichier script mis à part
function addMessage(message){
let nodeMessages = document.getElementById("listeMessages");
let nouvelleLigne = message;
let nodeText = document.createTextNode(nouvelleLigne);
let nodeLi = document.createElement("li");
nodeLi.appendChild(nodeText);
nodeMessages.appendChild(nodeLi);
}
==== Changer de style ====
Pour changer l'apparence d'un élément de la page, le plus simple est d'utiliser le style CSS. JS permet d'assigner des styles aux éléments ou d'en enlever.
soit ''node'', un certain nœud du DOM, on peut lui ajouter une classe CSS par la commande :
node.classList.add("nom_de_la_classe");
Le fichier ''styles.css'' contient les classes ''%%"texte_en_rouge""%%'', ''%%"texte_en_bleu""%%'', ''%%"texte_en_vert""%%''.
**À faire :** ouvrez ''page_4.html'' dans un navigateur. Testez son bon fonctionnement puis modifiez ''script_4.js'' pour que les messages apparaissent une ligne sur deux alternativement en rouge et en bleu.
===== Script totalement à part =====
Toujours plus loin dans la séparation, nous essayons d'enlever les dernières traces de JS qui restaient dans le html.
page 5
Cliquez sur les boutons.
Zone pour les messages
Le html ne contient plus aucun code JS. Tout le JS est dans le fichier ''script_5.js''.
// script_5.js
// Fichier script mis à part
function addMessage(message){
let nodeMessages = document.getElementById("listeMessages");
let nouvelleLigne = message;
let nodeText = document.createTextNode(nouvelleLigne);
let nodeLi = document.createElement("li");
nodeLi.appendChild(nodeText);
nodeMessages.appendChild(nodeLi);
}
document.getElementById("bouton_rouge").addEventListener(
"click",
function(){ addMessage("clic sur rouge"); });
document.getElementById("bouton_bleu").addEventListener(
"click",
function(){ addMessage("clic sur bleu"); });
document.getElementById("bouton_vert").addEventListener(
"click",
function(){ addMessage("clic sur vert"); });
Remarquez en particulier les lignes 12-20 : En ligne 12-14 par exemple, on accède à l'élément d'id ''%%""bouton_rouge""%%''. Cet élément est bien présent dans le fichier html, en ligne 11. On demande ce nœud d'**écouter l'événement** clic de souris -- //addEventListener//. On comprend que dès lors, un clic de souris sur cet élément déclenchera une fonction.
**À faire :** ouvrez ''page_5.html'' dans un navigateur. Constatez que cela ne fonctionne pas -- pensez à observer la console.
Voici où est le problème : Le script ''script_5.js'' est déclaré en début de page html. Il est chargé dès le début alors que le contenu ''%%
%%'' n'es pas encore chargé dans le navigateur. Le nœud d'id ''%%""bouton_rouge""%%'' n'existe pas encore dans le DOM.
La solution est de déclarer le script à la fin de ''%%%%'' et pas dans ''%%%%''.
**À faire :** faites-le et constatez que maintenant, ça fonctionne.
===== D'autres événements =====
Il y a d'autres événements que //click// !
* ''load'' : quand l'élément est chargé.\\ On l'associe souvent à ''%%%%'', permet d'attendre que la page est bien chargée.
* ''click'' : déjà vu, c'est le clic souris.
* ''dblclick'' : double clic.
* ''mouseover'' : quand la souris passe au-dessus.
* ''mouseout'' : quand la souris arrête d'être au-dessus.
* ''keypress'' : quand on appuie sur une touche pour entrer un caractère. Utile dans un champ de saisie.
* ''input'' : quand le contenu d'un champ de saisie texte est modifié, à chaque entrée de caractère.
* ''change'' : quand le contenu d'un champ de saisie est modifié et ce changement est validé (un peu différent du précédent)
* ''focus'' : quand l'élément gagne le //focus//. Dans une page où on trouve plusieurs zones de saisie, celle dans laquelle on est en train d'écrire est celle qui a le focus.
* ''blur'' : perte du focus.
* ''submit'' : dans le cas d'un formulaire (ensemble de champ de saisie avec un bouton "soumettre" ou "Envoyer" ou "ok" ou...) quand le formulaire est validé et peut-être envoyé.
Il y a beaucoup d'événements, inutile de les connaître par cœur... Internet est plein de références permettant de trouver tout ce que l'on a besoin de savoir. Par exemple [[https://developer.mozilla.org/fr/|MDN web docs]].
==== Exemple ====
page 6
Démonstration
Zone pour la réponse
Dans ce code, ligne 10, on a défini :
Ce champ de saisie est lié, dans le script ''script_6.js'' en ligne 3, à l'événement ''input''.
// script_6.js
let villes = ["Paris", "Marseille", "Lyon", ... ]; // j'abrège...
document.getElementById("champ_saisie").addEventListener("input", saisieInput)
// Il y a une suite dans script_6.js
**À faire :** on aimerait que quand il n'y a aucun résultat apparaisse un message comme //Aucun résultat//. Faites la modification dans ''script_6.js''.
===== event =====
Quand l'événement appelle la fonction, il lui transmet automatiquement un argument. On peut l'appeler ''e''. Il contient un objet représentant l'événement lui même.
Par exemple, dans ''page_7.html'',
event
Associé à, dans ''script_7.js''
// script_7.js
function clickButton(e){
console.log(e);
}
document.getElementById("bouton_event1").addEventListener("click", clickButton );
document.getElementById("bouton_event2").addEventListener("click", clickButton );
**À faire :** ouvrez ''page_7.html'' dans un navigateur, ouvrez la console et cliquez sur l'un des boutons de la section //event//. Observez ce qui s'affiche en console.L'objet ''event'' qui apparaît en console a beaucoup d'attributs. Ils renseignent sur la nature de l'événement. Par exemple, l'attribut ''target'' nous indique quel nœud du DOM est la cible de cet événement. Ici, deux boutons sont attachés au même événement. L'attribut ''target'' nous permet de savoir lequel a été cliqué.**À faire :** modifiez la fonction ''clickButton'' dans ''script_7.js'' pour que le texte du bouton cliqué change, passant de ''%%"Cliquez-moi !"%%'' à ''%%"Cliquez-moi ! (1)"%%'' au premier clic, puis ''%%"Cliquez-moi ! (2)"%%'' et ainsi de suite.
===== this =====
Le mot clé ''this'' désigne celui qui appelle la fonction. On retrouve ce mot clé dans les différents langages sous différentes formes. En Python, on utilise plutôt ''self''.