DokuWiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
|<- [[Hyphen Delimited]]|[[Naming Conventions in HTML]] ->|

====== BEM-like Naming ======

Pour de plus étendus, interrelated éléments d'interface utilisateur requiérant un nombre de classes, on utilise des conventions de nommage BEM-like.

BEM, signifiant Block, Element, Modifier, est une méthodologie front-end mise au point par des développeurs travaillant à Yandex. Alors que BEM est une méthodologie complète, nous nous intéressons ici seulement à ses conventions de nommages. Et au-delà de cela, les conventions de nommages ici sont uniquement BEM-like; les principes sont exactement les même, mais la syntaxes diffère légèrement.

BEM divise les composants en trois groupes :

  - Block: La racine du composant.
  - Element: Un composant partie du bloc.
  - Modifier: Une variante ou extension du Block.

Pour faire une analogie (notez, ce n'est pas un exemple):

<code>
.person { }
.person__head { }
.person--tall { }
</code>

Les éléments sont délimitées avec 2 underscores ([[__]]), et les modifieurs sont délimités par deux tirets (--).

On peut voir ici que .person {} est le bloc, il s'agit de la racine d'une entité distinct. .person[[__]]head {} est un élément; c'est une plus petite partie du bloc .person {}. Enfin, .person--tall {} est un Modifier; c'est une variante spécifique du bloc .person {}.

===== Starting Context =====

Votre contexte de bloc démarre à l'endroit le plus logique, self-contained, distinct. Pour continuer avec notre analogie basée sur la personne, nous ne devrions pas avoir de classe comme .room[[__]]person {}, étant donné que la pièce (room) est un autre contexte bien plus élevé. Nous aurons sans doute des blocs séparés tels que :

<code>
.room { }

  .room[[__]]door { }

.room--kitchen { }


.person { }

  .person[[__]]head { }
</code>

Si nous voulons dénoter une .person {} à l'intérieur d'un .room {}, il est plus correct d'utiliser un sélecteur comme .room .person {} qui fait le pont entre deux blocs, que d'étendre la portée des blocs et éléments existants

Un exemple plus réaliste de blocs correctement scopés pourrait ressembler à ceci où chaque morceau de code représente son propre bloc.

<code>
.page { }


.content { }


.sub-content { }


.footer { }

  .footer__copyright { }
</code>

Une notation incorrecte serait :

<code>
.page { }

  .page__content { }

  .page__sub-content { }

  .page__footer { }

    .page__copyright { }
</code>

Il est important de savoir quand le scope BEM commence et termine. Comme règle, BEM s'applique aux éléments distincts et self-contained de l'UI.

===== More Layers =====

Si nous devions ajouter un autre élément — appelé, disons, .person[[__]]eye {}— à ce composant .person {} , nous n'aurions pas besoin de parcourir chaque niveau du DOM. c'est facile à dire, mais la notation serait .person[[__]]eye {}, et non .person[[__]]head[[__]]eye {}. Vos classes ne reflètent pas l'entièreté du DOM.

===== Modifying Elements =====


Vous pouvez avoir des variantes d'éléments, et ceci peut être dénoté de nombreuses manières différentes selon comment et pourquoi il sont modifiés. Pour continuer avec notre exemple de la personne, un œil bleu pourrait ressembler à ceci :

<code>
.person__eye--blue { }
</code>

Ici nous pouvons voir que nous modifions directement l'élément eye.

Les choses peuvent toutefois devenir plus complexes. excusez l'analogie quelque peu crue, mais imaginons avoir un élément face qui soit 'beau'. La personne elle-même n'est pas si belle, alors modifions l'élément face directement — un beau visage sur une personne habituelle :

<code>
.person__face--handsome { }
</code>

Mais si la personne est belle, et que nous voulons en modifier le visage à cause de cela ? Un visage normal sur une belle personne :

<code>
.person--handsome .person__face { }
</code>

Voici une des rares occasions où nous utilisons un sélecteur descendant to modify an Element based on a Modifier on the Block.

Si l'on utilise SASS, il est probable que nous l'écrivions ainsi :

<code>
.person { }

  .person__face {

    .person--handsome & { }

  }

.person--handsome { }
</code>

Notez que nous ne nichons pas la nouvelle instance de .person[[__]]face {} dans .person--handsome {}; à la place, nous faisons usage du sélecteur de parent SASS pour prépend .person--handsome sur le sélecteur .person[[__]]face {} existant. cela signifie que toutes les règles related à .person[[__]]face {} existent à un seul endroit, et ne s'étalent pas dans tout le fichier. C'est une bonne pratique général lorsque l'on a affaire à du code niché : garder tout votre contexte (ici tout le code de .person[[__]]face {}) encapsulé en un unique endroit.