HTML
HTML décrit ce que contient une page web : un titre, un paragraphe, un tableau, un lien. Il ne dit ni à quoi cela ressemble, c'est le rôle de CSS, ni comment cela réagit, c'est celui de JavaScript.
Le problème
L'API des scores renvoie du JSON :
JSON
C'est parfait pour un programme, illisible pour un joueur. On veut une page de classement qu'on ouvre dans un navigateur, sans lancer le jeu.
Ce site de documentation est lui-même fait de HTML : chaque fichier .mdx est transformé en page HTML par npm run build.
La notion
Les trois langages du navigateur
| Langage | Répond à | Comparaison avec le jeu |
|---|---|---|
| HTML | Qu'y a-t-il sur la page ? | L'état : la carte, les unités |
| CSS | À quoi cela ressemble-t-il ? | Le rendu : couleurs, positions |
| JavaScript | Que se passe-t-il quand on clique ? | Les règles et les entrées |
Les garder séparés est la même discipline que de séparer les règles du jeu de son affichage.
Balise, élément, attribut
HTML
| Morceau | Nom | Rôle |
|---|---|---|
<a ...> | Balise ouvrante | Début de l'élément |
href= | Attribut | Une précision : ici, la destination du lien |
Lire les règles | Contenu | Ce qui est affiché |
</a> | Balise fermante | Fin de l'élément |
Les éléments s'emboîtent les uns dans les autres et forment un arbre. Certains n'ont pas de contenu et pas de balise fermante, comme <img> ou <br>.
Le squelette d'une page
HTML
| Ligne | Rôle |
|---|---|
<!doctype html> | Annonce du HTML moderne |
<html lang= | La racine, avec la langue du contenu |
<head> | Les informations sur la page, non affichées |
<meta charset= | L'encodage. Sans lui, les accents peuvent s'afficher de travers |
<meta name= | Adapte la page à la largeur des téléphones |
<title> | Le texte de l'onglet du navigateur |
<body> | Tout ce qui est affiché |
Les balises courantes
Le texte
| Balise | Usage |
|---|---|
<h1> à <h6> | Titres, du plus important au moins important. Un seul <h1> par page |
<p> | Paragraphe |
<strong>, <em> | Texte important, texte accentué |
<ul>, <ol>, <li> | Liste à puces, liste numérotée, élément de liste |
<a href= | Lien |
<img src= | Image. alt décrit l'image pour qui ne la voit pas |
<code>, <pre> | Code dans une phrase, bloc de code |
La structure
Ces balises ne changent rien à l'affichage. Elles disent à quoi sert chaque partie de la page.
On parle de HTML sémantique : choisir la balise pour son sens, pas pour son apparence. Trois raisons :
- les lecteurs d'écran, utilisés par les personnes malvoyantes, s'appuient sur ces balises pour se repérer ;
- les moteurs de recherche aussi ;
- le code se relit mieux qu'une pile de
<div>.
<div> et <span> existent pour les cas où aucune balise n'a le sens voulu : un bloc ou un bout de texte qu'on veut seulement mettre en forme.
Les tableaux
Un classement est un tableau de données : c'est la balise à utiliser.
| Balise | Rôle |
|---|---|
<table> | Le tableau |
<caption> | Son titre |
<thead>, <tbody> | L'en-tête, le corps |
<tr> | Une ligne |
<th> | Une cellule d'en-tête |
<td> | Une cellule de données |
Les formulaires
HTML
Chaque champ a un <label>, relié par for et id. Cliquer sur le texte place alors le curseur dans le champ, et un lecteur d'écran sait annoncer à quoi il sert.
La page du classement
On crée un dossier web/ à la racine du projet.
Code
HTML
Pour la voir, on la sert avec le serveur d'une ligne :
Bash
Puis http:// dans le navigateur. La page s'affiche sans style, avec l'apparence par défaut du navigateur : c'est normal, et c'est le sujet du cours CSS.
class et id
Deux attributs servent à désigner des éléments, pour CSS et JavaScript.
| Attribut | Règle | Exemple |
|---|---|---|
class | Partagé par autant d'éléments qu'on veut | class=, class= |
id | Unique dans la page | id="player" |
Les outils du navigateur
Clic droit sur la page, puis Inspecter. L'onglet des éléments montre l'arbre HTML tel que le navigateur l'a compris, et permet de le modifier en direct. C'est l'équivalent d'un débogueur pour la page.
Le navigateur est tolérant : une balise mal fermée ne provoque pas d'erreur, il devine. Ce qu'il devine n'est pas toujours ce qu'on voulait. Le validateur du W3C signale ces fautes.
Les limites de cette page
Les scores sont écrits à la main dans le fichier. Pour afficher ceux de l'API, il faut du JavaScript : demander /scores, puis construire les lignes du tableau. C'est ce que fait le cours React.
À retenir
- HTML dit ce qu'est le contenu, pas à quoi il ressemble.
- Choisir la balise pour son sens :
<nav>,<main>,<table>,<button>. - Un
<label>par champ, unaltpar image, un seul<h1>. classse partage,idest unique.- L'inspecteur du navigateur montre ce qui a réellement été compris.
Exercices
- Créer
web/, le servir, et l'ouvrir. Ajouter trois lignes au classement.index. html - Créer
web/à partir de la page Les règles de la documentation du jeu : titres, listes, un tableau des unités.regles. html - Ajouter une image du jeu, prise dans
assets, avec unaltqui la décrit vraiment. - Dans l'inspecteur, supprimer la balise
<thead>et observer ce que cela change. Recharger la page : que constate-t-on ? - Passer la page au validateur du W3C et corriger ce qu'il signale.
- Ouvrir l'inspecteur sur une page de cette documentation. Retrouver
<header>,<nav>et<main>.