a-cantet / tp-grid-vite

TP — Grid + Vite

Pour se familiariser avec les différentes propriétés : Grid Garden

Le but de ce TP est d'utiliser CSS Grid pour intégrer simplement un tableau complexe : le tableau périodique des éléments.

Le tableau interactif (mais non responsive !) qui nous servira de référence se trouve ici.

Étape 0 : mise en place

• Créer un fork de ce repository
• Cloner le fork sur votre machine
• Ouvrir le projet dans votre éditeur (VSCode recommandé)

Lancement de vite

L'environnement de travail pour ce TP utilise Vite, un outil d'empaquetage moderne et rapide. Pour simplifier, il prend toutes vos ressources "brutes" (html, scss, images...) et se charge de tout compiler pour le développement en local ou le déploiement en production.

• Ouvrez un terminal depuis votre éditeur puis lancez l'installation des dépendances du projet :

npm install

Note : npm est le gestionnaire de paquets de node. Il a été installé automatiquement avec ce dernier.

• Lancez Vite en mode développement

npm run dev

Votre serveur local est maintenant disponible à l'URL fournie par Vite.

Étape 1 : Comprendre le tableau et le HTML

Le fichier index.html contient déjà ce qu'il nous faut : la liste de tous les éléments.

Note : Pour simplifier, nous allons ignorer les deux lignes "externes" au tableau pour le moment (en bas). On laissera deux cases vides au sein du tableau principal. C'est pourquoi les éléments correspondants sont commentés dans le HTML.

Voici par exemple l'Argon en BEM (rappel : l'élément <abbr> représente une abbréviation):

<article class="element element--nobleGas" data-period="3" data-group="18">
  <p class="element__number">18</p>
  <abbr class="element__symbol">Ar</abbr>
  <p class="element__name">Argon</p>
</article>

Prenez le temps de bien comprendre chaque information, en comparant avec le tableau de référence :

• element--nobleGas : modificateur BEM désignant le type d'élement. Dans cet exemple, cela permet de savoir que l'argon est un gaz noble.
• data-period="3" : attribut désignant la ligne sur laquelle se trouve l'élément (la période, pour les intimes). L'argon se trouve sur la troisième ligne.
• data-group="18": attribut désignant la colonne sur laquelle se trouve l'élément (le groupe). L'argon se trouve sur la dix-huitième colonne.

À vous de jouer :

• L'oxygène a été retiré du fichier index.html : rajoutez-le.
• Il est déjà temps d'effectuer un petit commit pour conclure cette introduction.

Étape 2 : Un peu de couleur avec SCSS

Ajouter un fichier src/styles/styles.scss à votre projet et l'importer à partir de index.html. Vite s'occupera de la transformation en CSS natif.

Reset CSS

• Ajouter un fichier src/styles/vendors/reset.scss à votre projet contenant le reset CSS classique, sans l'importer dans l'index.html (seul le fichier principal est importé).

• Dans le fichier styles.scss, utiliser un import SASS pour importer le fichier reset.scss :

@import 'vendors/reset.scss';

Cela doit avoir pour effet de faire disparaître les styles par défaut du navigateur.

Styles de base

Dans vos projets, toujours inclure les deux règles CSS suivantes (rappel sur box-sizing) :

* {
  box-sizing: border-box;
}

img {
  max-width: 100%;
}

Les couleurs du tableau périodique ne sont pas normalisées, il est donc possible de les choisir, tant qu'un type est strictement associé à une couleur. Voici un exemple :

Tout d'abord, utilisez lightgrey sur le sélecteur .element, pour que les éléments sans type soient en gris à la fin.

Pour le reste des couleurs, plutôt que de le faire à la main, utilisons les fonctionnalités avancées de SASS et CSS :

• Lists (pour contenir les types)
• Boucle each ou boucle for (pour récupérer les éléments des listes)
• Couleurs HSL(en faisant varier le paramètre hue entre 0 & 360, vous obtiendrez différentes teintes)
• Les fonctions $length, $nth, $index...

Plusieurs syntaxes sont possibles, mais le résultat doit occuper moins de 10 lignes.

Pour vous aider à démarrer, voici la liste des types au format SCSS :

$types: alkaliMetal lanthanide nobleGas transitionMetal postTransitionMetal alkalineEarthMetal actinide metalloid otherNonMetal;

Astuce : pour comprendre le code CSS généré par votre fichier SCSS, lancez la commande npm run build et analysez le résultat généré dans le dossier dist.

Une fois ceci fait, git commit !

Étape 3 : Grille mobile

Les propriétés suivantes seront exclues :

• width
• height
• float
• position
• transform
• display autre que display: flex ou display: grid

Le tableau ne peut pas être représenté dans sa forme classique sur mobile, mais on peut l'adapter. Sur mobile, on souhaite présenter les éléments "en bloc" :

Et voici le comportement responsive souhaité, tant que l'écran n'est pas assez grand pour présenter la mise en forme classique :

Vous aurez besoin :

• De transformer l'élément .table en grille
• De définir la hauteur des rows (dont on ignore la quantité)
• De définir les columns, variant d'un minimum à un maximum, mais remplissant toujours l'espace horizontal

Un peu d'inspiration pour résoudre ce problème !

N'oubliez pas le commit de fin d'étape.

Étape 4 : Grille classique

Inspirez vous du TP Flexbox pour écrire une mixin vous permettant de cibler les écrans de taille supérieure à 1400px, c'est à dire 87.5em (l'usage de l'unité em est recommandée pour les media queries).

Note : pour ne pas être gêné par la longueur du nom de certains éléments (#rutherfordium), je vous conseille de réduire leur font-size à 0.75rem.

Utilisez cette mixin pour re-définir sur le body les rows et les columns, dont vous connaissez maintenant le nombre (pour rappel, on ignore les deux lignes du bas sur le tableau classique).

Indice : le mot-clé repeat vous sera utile à deux reprises.

Comme les éléments ne sont pas encore correctement placés, le résultat va ressembler à ça :

Note : vous pouvez-voir où sont les cellules de la grille en survolant les éléments dans l'inspecteur.

git commit

Étape 5 : Placer les éléments

Rappelez-vous : chaque élément possède des attributs data-period et data-group, définissant respectivement leur ligne et colonne.

Vous pouvez placer les éléments dans la grille en combinant :

• Boucle for SASS
• Sélecteurs d'attribut
• grid-row & grid-column

10 lignes vous suffiront, à ajouter à nouveau avec git commit.

Le résultat attendu :

Félicitations, vous avez complété le TP. Si vous le souhaitez, vous pouvez aller plus loin (voir section suivante).

Aller plus loin

Le tableau n'est pas complet ! Il manque les lanthanides et les actinides, qui ont la particularité d'être souvent représentés en dessous du tableau principal.

À vous de trouver comment modifier la grille pour afficher ces éléments. Ils sont déjà présents dans le HTML, il vous suffit de retirer les commentaires. Modifiez le HTML selon vos besoins.

Aller encore plus loin

Et si l'écran était assez large pour afficher les lanthanides et les actinides dans le tableau principal, et pas dans des lignes externes ?

C'est ce que vous pouvez voir en cliquant sur le bouton wide, en haut à droite du tableau.

Ajoutez une media query pour les très grands écrans pour afficher le tableau complet.

Ressources

• Reférence : CSS Tricks Guide
• Outil : Grid generator
• Entraînement Grid Garden
• Exemple : grid-auto-flow: dense
• Le futur Subgrid