Carnet Wiki

Nommage des classes Z

Version 3 — Août 2010 tetue

Cette page sert à mettre en commun les éléments de réflexion sur le nommage des classes Z :

  • non encore fixées
  • déjà présentes mais qui seraient à reformuler

Lorsqu’un choix est défini et intégré dans les squelettes, il faut l’enlever de cette page Et les mettre dans un vrai article de doc peut être !.

Structure, blocs principaux

La structure du body mériterait des sélecteurs + usuels que ceux actuels : header, navigation, content et footer sont déjà utilisés dans de nombreux thèmes et frameworks, notamment dans les modèles Layout Gala qui servent de référence à la dist depuis 2007.

+ utiliser des class plutôt que des identifiants facilite la surcharge

Homogénéisation des différents types de listes

Actuellement :

  • menu / menu-liste / menu-entree
  • liste / liste-items / item
  • comments / comments-list / comment

Proposition :

  • menu / menu-items / item
  • liste / liste-items / item
  • comments / comments-items / item

Il n’est pas possible de faire directement une sélection « .liste .items » car l’élément de plus haut niveau (menu, liste) n’est pas obligatoire. Il sert à pouvoir inclure un titre en plus de la liste elle-même.

Préfixage dans les classes CSS

  • Dans le body, le préfixe se fait avec un underscore « _ » : page_sommaire.
  • Dans les listes, il se fait avec un tiret « - » : menu-liste, liste-items.

Là encore, cela demanderait à être homogénéisé.

Romy suggère (et applique depuis longtemps) ces nomenclatures (autant pour les noms de fichiers que les sélecteurs CSS et les chaines de langue) :
-  autant que possible, nommer de même le sélecteur css, le fichier image et la chaîne de langue qui s’appliquent au même endroit
-  commencer le nom par son radical, éviter les prefixes => c’est plus facile à relire/comprendre lorsque c’est classé par ordre alphabétique
-  séparer le suffixe par un tiret (idem pour le prefixe s’il y a en), typiquement pour ajouter un numéro identifiant
-  le underscore est réservé au radical, si nécessaire

Système de boite personnalisable

Système de colonnes internes à un bloc


marcimat

Je tentais de dire tout à l’heure que c’est bien de pouvoir sélectionner tous les blocs conteneurs, tous les items de liste d’un coup aussi, plutot que d’avoir à écrire .truc-items, .chose-items, .belette-items et que donc, quelque chose comme cela me conviendrait mieux :

  • bloc menu / items menu-items /item
  • bloc liste / items liste-items /item
  • bloc commentaires / items commentaires-items / item