A place to cache linked articles (think custom and personal wayback machine)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

index.md 39KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515
  1. title: Bonnes pratiques en CSS : BEM et OOCSS
  2. url: http://www.alsacreations.com/article/lire/1641-bonnes-pratiques-en-css-bem-et-oocss.html
  3. hash_url: e2600a64d31f9684cf8711384bc7ac98
  4. <p>
  5. Des années durant, j'ai intégré des sites Web et développé des applications JavaScript sans ressentir le besoin d'une méthodologie pour nommer les classes CSS. Puis, les projets grossissant, le code CSS est devenu douloureux…</p>
  6. <p>
  7. L'épineux sujet du nommage en CSS est loin d'être fermé. Depuis le début de la décennie, plusieurs auteurs majeurs ont partagé leurs recherches. Ils ont apporté un regard nouveau et sont allés à contrecourant, en rupture avec ce qui faisait jusqu'alors consensus. Je raconte dans cet article mon propre cheminement dans leurs travaux en espérant qu'il sera utile à l'intégrateur Web autant qu'au développeur JavaScript. J'ai cherché en effet une approche adaptée à la fois aux pages et aux applications Web.</p>
  8. <h3>
  9. Sommaire</h3>
  10. <ol class="tdm">
  11. <li>
  12. <a href="#oocss">OOCSS</a></li>
  13. <li>
  14. <a href="#bem">BEM</a></li>
  15. <li>
  16. <a href="#pertinence-de-bem">Pertinence de BEM</a></li>
  17. <li>
  18. <a href="#une-syntaxe-bem-jolie">Une syntaxe BEM… jolie !</a></li>
  19. <li>
  20. <a href="#ingerences-transversales-et-oocss">Ingérences transversales et… OOCSS</a></li>
  21. <li>
  22. <a href="#cas-d-utilisation-partie-1-html">Cas d'utilisation, partie 1 : HTML</a></li>
  23. <li>
  24. <a href="#cas-d-utilisation-partie-2-css-avec-sass">Cas d'utilisation, partie 2 : CSS avec SASS</a></li>
  25. <li>
  26. <a href="#conclusion">Conclusion</a></li>
  27. </ol>
  28. <h3 id="oocss">
  29. OOCSS</h3>
  30. <p>
  31. Je me suis d'abord tourné vers OOCSS (<em>Object Oriented CSS</em>), un ensemble de bonnes pratiques initiées par Nicole Sullivan (<a href="http://www.stubbornella.org/">Stubbornella</a>).</p>
  32. <p>
  33. Le concept de OOCSS est de repérer des « objets CSS », c'est-à-dire des « patterns visuels » qui se répètent, et de définir ainsi des classes réutilisables. La méthode consiste à prendre le design comme point de départ : on repère des répétitions visuelles <em>puis</em> on les nomme. La sémantique du document n'est donc plus une base de travail, et des classes CSS nommées selon l'apparence sont autorisées à partir du moment où elles sont génériques. En cela, OOCSS est en décalage avec les bonnes pratiques des années 2000. L'ancien nommage par la sémantique préconisait des classes comme <code>.last-articles-box</code> ou <code>.comment-title</code>, alors qu'en OOCSS des classes <code>.links-box</code> ou <code>.tiny-title</code> seront préférées. Cela implique que le pilotage de l'apparence se fait depuis le code HTML. Ainsi, lorsqu'une feuille de styles écrite à la manière OOCSS est bien faite, il devient possible d'ajouter des morceaux entiers dans le design sans toucher à la feuille CSS, juste en réutilisant des objets CSS déjà existants.</p>
  34. <p>
  35. OOCSS met en avant deux principes :</p>
  36. <ol>
  37. <li>
  38. Le principe de séparation de la structure et de l'apparence ;</li>
  39. <li>
  40. Le principe de séparation du conteneur et du contenu.</li>
  41. </ol>
  42. <p>
  43. Le premier principe nous fera préférer, dans les sélecteurs CSS, les classes plutôt que des identifiants ou des noms d'éléments HTML. Il incite également à factoriser les propriétés visuelles répétées. Pour l'exemple, partons du code HTML suivant :</p>
  44. <pre class="code">
  45. <code class="html">&lt;button class="<b>small-btn</b>"&gt;&lt;/button&gt;
  46. &lt;button class="<b>large-btn</b>"&gt;&lt;/button&gt;
  47. </code></pre>
  48. <p>
  49. Mieux vaut factoriser dans une classe <code>btn</code> les règles CSS communes aux deux boutons, ce qui donne :</p>
  50. <pre class="code">
  51. <code class="html">&lt;button class="<b>btn small-btn</b>"&gt;&lt;/button&gt;
  52. &lt;button class="<b>btn large-btn</b>"&gt;&lt;/button&gt;
  53. </code></pre>
  54. <p>
  55. Le second principe consiste à éviter des cascades CSS comme <code>.links-box .title</code>, car l'apparence du contenu <code>.title</code> serait alors couplée au conteneur <code>.links-box</code>. Une classe <code>.box-title</code> sera plus réutilisable.</p>
  56. <p>
  57. Je recommande au lecteur l'exposé de Nicole Sullivan : <a href="http://www.slideshare.net/stubbornella/our-best-practices-are-killing-us"><em>Our best practices are killing us</em></a>, publié en 2011. Cet exposé est formidable. Il a été, pour de nombreux intégrateurs, le point de départ d'une aventure OOCSS. Le lecteur désirant aller plus loin lira ensuite cette <a href="http://nicoespeon.com/fr/2013/05/plongee-au-coeur-de-oocss/">introduction à OOCSS</a> (en français) ainsi que le <a href="https://github.com/stubbornella/oocss/wiki">wiki du framework OOCSS</a>.</p>
  58. <p>
  59. Mais OOCSS correspondait imparfaitement à mon besoin. Les designers avec lesquels je travaille conçoivent trop de variations entre chaque bloc. OOCSS ne donne pas des règles de construction nettes et fermes, et le temps passé à factoriser l'apparence peut dépasser le gain de la réutilisation. L'approche OOCSS aide certainement à afficher des milliers d'objets dans une plateforme tentaculaire comme Facebook, car le designer lui-même raisonne alors par objets. Elle reste globalement inappropriée pour intégrer un joli design monolithique fait sur mesure pour un site plus modeste. En outre, dans le cadre de la conception d'une application JavaScript, le découpage de l'interface ne devrait pas être fait par l'apparence, les ressemblances entre composants différents étant toujours superficielles et amenées à diverger.</p>
  60. <p>
  61. Quoi qu'il en soit, les nouvelles bonnes pratiques de OOCSS font prendre conscience que l'ancien nommage par la seule sémantique est obsolète dans la mesure où il nous fait produire du code CSS non-réutilisable. Mettons OOCSS de côté pour le moment, nous y reviendrons plus tard.</p>
  62. <figure class="center">
  63. <img alt="Design des Halles de Paris, 1863, par Victor Baltard [Source: Wikipedia]" src="/xmedia/doc/full/Design_des_Halles_de_Paris,_1863,_par_Victor_Baltard_[Source:_Wikipedia].jpg"/> <figcaption>La méthode consiste à prendre le design comme point de départ… [Design des Halles de Paris, 1863, par Victor Baltard, Wikipédia]</figcaption></figure>
  64. <h3 id="bem">
  65. BEM</h3>
  66. <p>
  67. La méthodologie BEM est une solution élaborée par Yandex et publiée en 2010. BEM a deux faces : il s'agit d'abord d'une méthode déclarative de l'interface utilisateur servant à décrire un « arbre BEM », les outils <em>open source</em> de Yandex travaillent ensuite sur cet arbre. BEM apporte également une convention de nommage des classes CSS qui a gagné une certaine popularité. C'est de cette méthodologie du nommage, véritablement puissante, que nous allons parler ici.</p>
  68. <p>
  69. BEM est l'acronyme de <em>Block, Element, Modifier</em>, et toute la méthodologie du nommage à la manière BEM tient dans ces trois mots. La force du concept ? Ce qui compose un page ou une application Web peut toujours être rangé dans une arborescence de blocs, d'éléments et de modificateurs.</p>
  70. <p>
  71. Un <strong>bloc</strong> est une entité indépendante, une « brique » de l'application ou de la page Web. Un bloc forme son propre contexte autonome. Ci-dessous des exemples de blocs dans une illustration tirée du site officiel :</p>
  72. <figure class="center">
  73. <img alt="Logo, Onglets, Formulaires, etc." src="/xmedia/doc/full/bem-blocks-540.jpg"/> <figcaption>Des blocs BEM [source : <a href="http://bem.info/method/definitions/#Unified-Data-Domain">bem.info</a>]</figcaption></figure>
  74. <p>
  75. Un <strong>élément</strong> est une partie d'un bloc. Le contexte d'un élément est celui du bloc. Ci-dessous deux exemples empruntés toujours au site officiel :</p>
  76. <figure class="center">
  77. <img alt="Champ Input, Button" src="/xmedia/doc/full/bem-elements-540.jpg"/> <figcaption>Des éléments BEM [source : <a href="http://bem.info/method/definitions/#Element">bem.info</a>]</figcaption></figure>
  78. <p>
  79. En tant que « brique de construction », un bloc est réutilisable dans d'autres blocs ou dans des éléments. Il ne connait toutefois que son propre contexte et non celui du parent. Un bloc n'est donc pas livré avec les règles CSS de son propre positionnement au sein du conteneur parent. Nous éclaircirons ultérieurement, sur un cas d'utilisation, ce point important.</p>
  80. <p>
  81. Un <strong>modificateur</strong> est une propriété qui sert à créer des variantes, pour faire des modifications minimes comme changer des couleurs. Il existe des modificateurs de blocs et des modificateurs d'éléments.</p>
  82. <p>
  83. La méthodologie BEM établit ensuite trois règles essentielles :</p>
  84. <ol>
  85. <li>
  86. Les blocs et les éléments doivent chacun avoir un nom unique, lequel sera utilisé comme classe CSS ;</li>
  87. <li>
  88. Les sélecteurs CSS ne doivent pas utiliser les noms des éléments HTML (pas de <code>.menu td</code>) ;</li>
  89. <li>
  90. Les cascades dans les sélecteurs CSS devraient être évitées.</li>
  91. </ol>
  92. <p>
  93. À propos de la première règle, précisons que les identifiants HTML (les attributs <code>id</code>) ne doivent pas être utilisés en CSS, chaque bloc pouvant par principe être instancié plusieurs fois. Les identifiants HTML ne servent que d'ancres. La deuxième règle est nécessaire dans la mesure où les blocs peuvent être imbriqués. Un sélecteur <code>.menu td</code> briserait la séparation des contextes en interagissant avec les balises <code>&lt;td&gt;</code> des sous-blocs, cela doit être évité.</p>
  94. <p>
  95. Ces règles impliquent de préfixer les noms des éléments par leur contexte. Venons-en à la convention de nommage des classes CSS. Le site officiel prend soin de préciser que seuls comptent les concepts, la syntaxe restant libre. L'équipe de BEM utilise pour sa part une syntaxe à base de <em>underscores</em> :</p>
  96. <ul>
  97. <li>
  98. <code>block-name</code></li>
  99. <li>
  100. <code>block-name_modifier_name</code></li>
  101. <li>
  102. <code>block-name__element-name</code></li>
  103. <li>
  104. <code>block-name__element-name_modifier_name</code></li>
  105. </ul>
  106. <p>
  107. Pouah ! Hideux ! La raison d'une telle laideur est un manque de caractères utilisables dans les identifiants en CSS.</p>
  108. <p>
  109. Le code CSS, en méthodologie BEM, est presque plat. Voici un exemple de code CSS pour un bloc <code>search-box</code> doté d'un modificateur <code>light</code>, contenant un élément <code>btn</code> avec un modificateur <code>max_visible</code> :</p>
  110. <pre class="code">
  111. <code class="css">.<b>search-box</b> {
  112. height: 300px;
  113. width: 300px;
  114. }
  115. .search-box_<b>light</b> {
  116. background-color: #DEF;
  117. color: #777;
  118. }
  119. .search-box__<b>btn</b> {
  120. padding: 4px;
  121. }
  122. .search-box__btn_<b>max_visible</b> {
  123. font-weight: bold;
  124. }
  125. </code></pre>
  126. <p>
  127. Le code HTML :</p>
  128. <pre class="code">
  129. <code class="html">&lt;div class="<b>search-box</b> search-box_<b>light</b>"&gt;
  130. &lt;!-- (input field here) --&gt;
  131. &lt;button class="search-box__<b>btn</b> search-box__btn_<b>max_visible</b>"&gt;Search&lt;/button&gt;
  132. &lt;/div&gt;
  133. </code></pre>
  134. <p>
  135. Une cascade est utilisée lorsqu'un modificateur de bloc a un effet sur un élément :</p>
  136. <pre class="code">
  137. <code class="css">.search-box_<b>light</b> .search-box__<b>btn</b> {
  138. background-color: #9AB;
  139. }
  140. </code></pre>
  141. <p>
  142. Signalons entre parenthèses que cette cascade est à éviter sur les blocs pouvant s'imbriquer récursivement, car le modificateur du bloc parent affecterait alors les blocs enfants. Fort heureusement le cas est rare.</p>
  143. <p>
  144. Nous n'en avons pas terminé avec BEM. Dans la suite de l'article cependant nous nous écarterons de la syntaxe et même de la terminologie originale. Je suggère au lecteur intéressé par l'orthodoxie : la <a href="http://bem.info/method/definitions/">présentation officielle de la méthodologie BEM</a> dont sont tirées les deux illustrations, et un article sur <a href="http://www.smashingmagazine.com/2014/07/17/bem-methodology-for-small-projects/">l'utilisation de BEM dans de petits projets</a> (incluant la partie déclarative de l'arbre BEM).</p>
  145. <h3 id="pertinence-de-bem">
  146. Pertinence de BEM</h3>
  147. <p>
  148. BEM, c'est un peu le chic type au visage ingrat. Il a des qualités mais qu'est-ce qu'il est… LAID ! Je ne sais pas pour vous ? En ce qui me concerne, travailler sur un code qui me dégoute, ça, jamais !</p>
  149. <p>
  150. Tout de même, juger sur l'apparence n'est pas bien. Donnons-lui une chance et regardons au moins ses avantages.</p>
  151. <h4 id="la-proprete">
  152. La propreté</h4>
  153. <p>
  154. En BEM, aucun risque d'aboutir à ce code-là :</p>
  155. <pre class="code">
  156. <code class="css">.my-aside-title {
  157. font-size: 1.5em; /* Je style mon titre, OK c'est propre */
  158. }
  159. .my-aside h2.my-aside-title {
  160. position: inherit; /* Ah merde, annulation d'une règle sur h2 prévue pour autre chose */
  161. }
  162. </code></pre>
  163. <h4 id="la-performance">
  164. <img alt="Performance [source: all-free-photos.com]" class="left" src="/xmedia/doc/full/Performance_[source:_all-free-photos.com].jpg"/>La performance</h4>
  165. <p>
  166. La performance concerne plus particulièrement les applications Web. Les navigateurs rangent les classes CSS dans une table de hachage globale au document, mais il serait trop couteux de créer des sous-tables pour les descendants au niveau de chaque élément HTML. Aussi, en CSS, seul le premier niveau de sélection est performant. Les cascades CSS, lorsqu'elles sont nombreuses, engendrent des problèmes de fluidité surtout sur les pages animées des applications Web.</p>
  167. <p>
  168. BEM, en limitant drastiquement l'usage des cascades CSS, incite à élaborer des feuilles de styles performantes.</p>
  169. <h4 id="la-scalability-et-une-architecture-par-composants">
  170. La <em>scalability</em> et une architecture par composants</h4>
  171. <p>
  172. <img alt="Scalability [source: Wikipedia]" class="right" src="/xmedia/doc/full/Scalability_[source:_Wikipedia].jpg"/>Un bloc peut être placé n'importe où dans la page, ou encore apparaitre (être instancié) plusieurs fois. Cela est possible parce que ses règles CSS sont radicalement séparées de celles des autres blocs. Il est alors possible de construire des applications géantes tout en travaillant toujours à une échelle réduite : le contexte d'un bloc.</p>
  173. <p>
  174. Un parallèle est à faire avec les « composants Web », lesquels seront les briques des futures applications JavaScript. Chaque composant Web embarquera ses propres règles CSS et son propre code JavaScript. La norme prévoit un <em>shadow DOM</em>, c'est-à-dire une <em>sandbox</em> qui encapsule une portion de DOM dans le but d'empêcher les sélecteurs CSS et les identifiants HTML d'interagir par erreur avec le reste du DOM. Aujourd'hui, tout le challenge des <i>frameworks</i> JavaScript est de s'adapter à cette manière de travailler.</p>
  175. <p>
  176. Les blocs BEM correspondent bien à la philosophie du développement par composants. BEM donne pour les technologies d'aujourd'hui un format de nommage utilisable et une manière de travailler compatible avec celle de demain.</p>
  177. <h3 id="une-syntaxe-bem-jolie">
  178. Une syntaxe BEM… jolie !</h3>
  179. <p>
  180. D'un côté BEM en vaut la peine, de l'autre il n'est pas séduisant. Nous risquons le mariage de raison… Les lignes suivantes relatent une démarche qui m'a pris plusieurs mois.</p>
  181. <p>
  182. HTML 5 est venu avec une bonne et une mauvaise nouvelle. La bonne nouvelle, c'est qu'il est désormais possible d'utiliser <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#classes">n'importe quel caractère</a> dans les identifieurs des attributs <code>class</code> et <code>id</code>. Et la mauvaise nouvelle, c'est que… pas en CSS. Un auteur Belge a dressé <a href="http://mathiasbynens.be/notes/css-escapes#css">la liste des caractères</a> qui ont un sens spécial en CSS et qu'il faut donc échapper : <code>!</code>, <code>"</code>, <code>#</code>, <code>$</code>, <code>%</code>, <code>&amp;</code>, <code>'</code>, <code>(</code>, <code>)</code>, <code>*</code>, <code>+</code>, <code>,</code>, <code>-</code>, <code>.</code>, <code>/</code>, <code>:</code>, <code>;</code>, <code>&lt;</code>, <code>=</code>, <code>&gt;</code>, <code>?</code>, <code>@</code>, <code>[</code>, <code>\</code>, <code>]</code>, <code>^</code>, <code>`</code>, <code>{</code>, <code>|</code>, <code>}</code> et <code>~</code>. Échapper n'est pas une option, on ne va pas remplacer une laideur par une autre.</p>
  183. <p>
  184. Il reste alors deux caractères de séparation : le trait d'union (<code>-</code>) qu'une règle spéciale permet d'utiliser dans un identifieur sauf en première position, et le <i>underscore</i> (<code>_</code>).</p>
  185. <p>
  186. Aïe.</p>
  187. <p>
  188. Bloqué.</p>
  189. <p>
  190. Prenons le problème autrement. La norme en CSS dit ceci :</p>
  191. <blockquote>
  192. All CSS syntax is case-insensitive within the ASCII range […], except for parts that are not under the control of CSS. For example, the case-sensitivity of values of the HTML attributes "id" and "class" […] (<a href="http://www.w3.org/TR/CSS21/syndata.html#characters">Source : W3C</a>).</blockquote>
  193. <p>
  194. La casse est donc utilisable. À titre personnel je rechignais un peu. J'ai toujours nommé mes classes CSS en minuscules avec des traits d'union, tous les gens bien font comme cela. Mais ici il faut sacrifier quelque chose. Accepter un séparateur illisible et moche ? Plutôt mourir ! S'assoir sur la norme ? Bon j'avoue avoir envisagé un temps une utilisation irrégulière du tilde (<code>~</code>)… Mais quoi ! La casse est valide, on l'utilise ailleurs en programmation, zut alors ! À cœur vaillant rien d'impossible, tant pis pour la tradition.</p>
  195. <p>
  196. Une syntaxe BEM basée sur la casse est décrite par Nicolas Gallagher dans son mémorable article : <a href="http://nicolasgallagher.com/about-html-semantics-front-end-architecture/"><em>About HTML semantics and front-end architecture</em></a>, 2012. L'auteur en fait usage dans son framework <em>SUIT CSS</em>. La voici :</p>
  197. <ul>
  198. <li>
  199. <code>ComponentName</code></li>
  200. <li>
  201. <code>ComponentName--modifierName</code></li>
  202. <li>
  203. <code>ComponentName-descendantName</code></li>
  204. <li>
  205. <code>ComponentName.is-stateOfComponent</code></li>
  206. </ul>
  207. <p>
  208. On l'aura compris, les composants sont les blocs et les descendants sont les éléments. La terminologie de BEM est ambigüe car « bloc » en CSS est aussi un type de flux d'affichage (l'opposé de « en ligne ») et « élément » désigne une balise HTML et son contenu. Aussi, adoptons définitivement les termes « composant » et « descendant ». Un <strong>composant CSS</strong> évoque en effet avec justesse l'idée d'encapsulation du composant Web, et un <strong>descendant</strong> en est effectivement un dans l'arbre DOM. Un composant Web pouvant embarquer plusieurs composants CSS, je préfère accoler ainsi « CSS » afin de les distinguer.</p>
  209. <p>
  210. La syntaxe de l'état est intéressante : un simple point de séparation. C'est la syntaxe du sélecteur pour deux classes affectées à un même élément HTML. Ce sélecteur est devenu utilisable depuis que Windows XP et donc Internet Explorer 6 ont été abandonnés. Ci-dessous un exemple de bloc <code>MenuBtn</code> marqué avec l'état <code>current</code> en syntaxe SUIT CSS :</p>
  211. <pre class="code">
  212. <code class="html">&lt;button class="<b>MenuBtn</b> <b>is-current</b>"&gt;Open&lt;/button&gt;
  213. </code></pre>
  214. <p>
  215. En revanche, la syntaxe des modificateurs oblige encore, à l'instar de celle originale de BEM, à de lourdes répétitions. Car la classe CSS d'un modificateur est déclarée <em>en plus</em> de celle du composant CSS. Voici comment s'écrira un bouton doté des modificateurs <code>big</code> et <code>darkBlue</code> :</p>
  216. <pre class="code">
  217. <code class="html">&lt;button class="<b>MenuBtn</b> MenuBtn--<b>big</b> MenuBtn--<b>darkBlue</b>"&gt;Open&lt;/button&gt;
  218. </code></pre>
  219. <p>
  220. Pourquoi le principe de la double classe n'a-t-il pas été retenu pour les modificateurs ? L'auteur m'a répondu : « It helps keep specificity low » (« Ça aide à garder basse la spécificité »). Et c'est une réalité. La <a href="http://www.w3.org/TR/CSS21/cascade.html#specificity">spécificité CSS</a> est une mesure de la priorité d'un sélecteur CSS. Par exemple, le code suivant affichera en bleu les éléments ayant les deux classes <code>c1</code> et <code>c2</code>, car la spécificité de <code>.c1.c2</code> est plus élevée que celle de <code>.c1</code> :</p>
  221. <pre class="code">
  222. <code class="css">.c1.c2 {
  223. color: blue;
  224. }
  225. .c1 {
  226. color: red;
  227. }
  228. </code></pre>
  229. <p>
  230. Toutefois, si <code>c1</code> était le nom du composant CSS et <code>c2</code> celui d'un modificateur, alors une spécificité plus haute pour le modificateur aurait du sens. Le but d'un modificateur n'est-il pas précisément de surcharger les règles d'affichage de base du composant ?</p>
  231. <p>
  232. En outre, sur le plan de la performance, sélectionner simultanément deux classes CSS revient à faire l'intersection des résultats de deux sélections simples. La complexité, au sens algorithmique du terme, reste dans le même ordre de grandeur. Par conséquent la sélection simultanée de deux classes CSS est performante.</p>
  233. <p>
  234. Voici alors la convention de nommage que je propose à mon tour, dérivée de celle de SUIT CSS, dérivée de BEM :</p>
  235. <ul>
  236. <li>
  237. <code>ComponentName</code></li>
  238. <li>
  239. <code>ComponentName.modifierName</code></li>
  240. <li>
  241. <code>ComponentName-descendantName</code></li>
  242. <li>
  243. <code>ComponentName-descendantName.modifierName</code></li>
  244. <li>
  245. <code>ComponentName.isStateOfComponent</code></li>
  246. </ul>
  247. <p>
  248. J'ai gardé l'idée d'une convention pour un état booléen. Mais, visuellement, un état n'est rien d'autre qu'un modificateur spécial et je l'ai donc intégré dans la syntaxe des modificateurs. Voici un exemple de code HTML contenant de surcroit un descendant <code>keyword</code> :</p>
  249. <pre class="code">
  250. <code class="html">&lt;button class="<b>MenuBtn</b> <b>big</b> <b>darkBlue</b> <b>isCurrent</b>"&gt;
  251. Open the &lt;b class="MenuBtn-<b>keyword</b>"&gt;archives&lt;/b&gt;
  252. &lt;/button&gt;</code></pre>
  253. <p>
  254. Il arrive qu'une classe ne s'applique que sur certains types d'écrans. Un simple suffixe en majuscules fera ressortir cette caractéristique. Par exemple le modificateur <code>stickyMT</code> s'appliquera sur les écrans des mobiles et des tablettes seulement. Je compose pour ma part les suffixes avec <code>D</code> (<em>desktop</em>), <code>T</code> (<em>tablet</em>) et <code>M</code> (<em>mobile</em>). En cas d'écrans multiples, ordonner alphabétiquement.</p>
  255. <h3 id="ingerences-transversales-et-oocss">
  256. Ingérences transversales et… OOCSS</h3>
  257. <p>
  258. La méthodologie BEM apporte une solide séparation entre les contextes CSS des différents composants CSS. Pourtant, tous ces contextes reposent en définitive sur du sable mouvant. Les composants supposent en effet toujours un certain contexte CSS global, comme l'existence d'un <em>reset CSS</em> pour annuler les marges ou encore le fait qu'une balise <code>&lt;strong&gt;</code> affiche par défaut son contenu en gras.</p>
  259. <p>
  260. Et il est à mon avis justifié de jouer volontairement sur la corde transversale en marquant des éléments du DOM avec des classes ne respectant pas l'arborescence des composants CSS. Ainsi, un site réutilisant des patterns visuels globaux à la façon OOCSS fera dépendre de classes CSS transversales des propriétés décoratives. Dans une application JavaScript, un service du support multilingue peut travailler de manière transversale sur des libellés disposant de traductions.</p>
  261. <p>
  262. Pour ces marqueurs transversaux, je propose d'utiliser un préfixe commençant par une lettre minuscule et se terminant par le premier trait d'union : <code>myPrefix-…</code>. Par exemple un <em>objet CSS</em> aux propriétés décoratives : <code>ob-prettyBox</code> ; un libellé dont le contenu est modifiable par un service multilingue transversal : <code>lang-localizableLabel</code>. Pas de convention pour ce qui suit le préfixe : <code>lang-LocalizableLabel</code> ou encore <code>lang-localizable-label</code> au bon vouloir du concepteur.</p>
  263. <p>
  264. Nota. — Les ingérences transversales sortent de l'orthodoxie BEM.</p>
  265. <h4 id="a-propos-d-objets-css">
  266. À propos d'objets CSS</h4>
  267. <p>
  268. Parmi les objets CSS valides en OOCSS, distinguons ceux purement décoratifs de ceux qui organisent l'interface utilisateur.</p>
  269. <p>
  270. Les objets CSS décoratifs qui se limitent aux propriétés sans effet sur le flux d'affichage, comme les couleurs, les ombres, les coins arrondis, sont à consommer sans modération. Cependant, la mise en commun de propriétés décoratives peut aller plus loin. S'il apparait que la moitié des composants CSS partagent un <code>padding</code> de dix pixels et une bordure de deux pixels, pourquoi ne pas définir une classe transversale <code>ob-commonBox</code> ? Grâce aux objets CSS, nous ne sommes plus limités à un seul contexte CSS global, nous pouvons créer de multiples contextes CSS globaux. Ils seront ensuite affectés aux composants ou descendants, et joueront le rôle d'habillage par défaut.</p>
  271. <p>
  272. Quant aux objets CSS qui structurent l'interface utilisateur, à l'instar du <em><a href="http://www.stubbornella.org/content/2010/06/25/the-media-object-saves-hundreds-of-lines-of-code/">media object</a></em>, leur usage coïncide avec celui des composants CSS. Une syntaxe BEM devrait alors être préférée. Ensuite, lorsqu'il s'agit de délimiter nos composants CSS à partir d'un design, l'approche OOCSS consistant à repérer des répétitions de patterns visuels est excellente.</p>
  273. <h3 id="cas-d-utilisation-partie-1-html">
  274. Cas d'utilisation, partie 1 : HTML</h3>
  275. <p>
  276. Un peu de pratique pour fixer les idées. Nous allons élaborer un modèle de page innovant pour un blog. Admirez la beauté :</p>
  277. <figure class="center">
  278. <p>
  279. <img alt="Template de blog" src="/xmedia/doc/full/blog-template-540.jpg"/></p>
  280. </figure>
  281. <p>
  282. Quatre grands composants CSS se distinguent aisément : <code>SiteHeader</code> pour l'en-tête, <code>MainContent</code> l'article principal en blanc, <code>Sidebar</code> la barre latérale et <code>SiteFooter</code> le pied de page.</p>
  283. <p>
  284. Nous avons également besoin d'un composant <code>PageWrapper</code> pour centrer la page et lui fixer une largeur, et <code>BodyLayout</code> le conteneur de l'article principal et de la barre latérale. Intéressons-nous au code HTML de ce dernier :</p>
  285. <pre class="code">
  286. <code class="html"> &lt;div class="BodyLayout"&gt;
  287. &lt;main class="BodyLayout-<b>mainContent</b>"&gt;
  288. &lt;article class="<b>MainContent</b>"&gt;&lt;!-- Content here… --&gt;&lt;/article&gt;
  289. &lt;/main&gt;
  290. &lt;div class="BodyLayout-<b>sidebar</b> <b>Sidebar</b>"&gt;&lt;!-- Widgets here… --&gt;&lt;/div&gt;
  291. &lt;/div&gt;
  292. </code></pre>
  293. <p>
  294. En tant que composants CSS, <code>MainContent</code> et <code>Sidebar</code> ne doivent pas contenir leur propre positionnement. Aussi seront-ils positionnés par des conteneurs <code>mainContent</code> et <code>sidebar</code> (notez bien les premières lettres minuscules qui distinguent les descendants des composants). Et dans le cas de la barre latérale, le descendant <code>sidebar</code> et le composant <code>Sidebar</code> sont associés au même élément HTML. Cela est autorisé par BEM : on dit alors du nœud du DOM qu'il est un <em>mix</em> des deux.</p>
  295. <p>
  296. Les <em>mix</em> sont pratiques dans le cas d'un modèle de page Web car ils économisent des balises HTML. Ils impliquent toutefois une plus grande rigueur dans les CSS, comme nous le verrons dans la section suivante.</p>
  297. <p>
  298. Voici le code HTML complet :</p>
  299. <pre class="code">
  300. <code class="html">&lt;!DOCTYPE html&gt;
  301. &lt;html&gt;
  302. &lt;head&gt;
  303. &lt;link rel="stylesheet" href="hello-bem.css"&gt;
  304. &lt;/head&gt;
  305. &lt;body&gt;
  306. &lt;div class="<b>PageWrapper</b>"&gt;
  307. &lt;header class="<b>SiteHeader</b>"&gt;
  308. &lt;a class="SiteHeader-<b>titles</b>" href="/"&gt;
  309. &lt;p class="SiteHeader-<b>h1</b>"&gt;Hello, World!&lt;/p&gt;
  310. &lt;p class="SiteHeader-<b>h2</b>"&gt;BEM is sooo handy&lt;/p&gt;
  311. &lt;/a&gt;
  312. &lt;/header&gt;
  313. &lt;div class="<b>BodyLayout</b>"&gt;
  314. &lt;main class="BodyLayout-<b>mainContent</b>"&gt;
  315. &lt;article class="<b>MainContent</b> <b>ob-formattedText</b>"&gt;&lt;p&gt;Main content here&lt;/p&gt;&lt;/article&gt;
  316. &lt;/main&gt;
  317. &lt;div class="BodyLayout-<b>sidebar</b> <b>Sidebar</b>"&gt;
  318. &lt;ul&gt;
  319. &lt;li class="Sidebar-<b>li</b>"&gt;&lt;aside class="<b>SmallBox</b> <b>sticky</b>"&gt;Widget 1&lt;/aside&gt;&lt;/li&gt;
  320. &lt;li class="Sidebar-<b>li</b>"&gt;&lt;aside class="<b>SmallBox</b>"&gt;Widget 2&lt;/aside&gt;&lt;/li&gt;
  321. &lt;/ul&gt;
  322. &lt;/div&gt;
  323. &lt;/div&gt;
  324. &lt;footer class="<b>SiteFooter</b>"&gt;Something about copies here&lt;/footer&gt;
  325. &lt;/div&gt;
  326. </code></pre>
  327. <p>
  328. Du texte formaté pourrait apparaitre dans plusieurs composants CSS différents, il fait donc l'objet d'une classe transversale <code>ob-formattedText</code>. Notons également la présence du modificateur <code>sticky</code> sur la première des deux instances du composant <code>SmallBox</code>.</p>
  329. <h4 id="discussion-html">
  330. Discussion HTML</h4>
  331. <p>
  332. Deux sujets méritent une attention particulière. Premièrement, constatons que les arbres BEM et DOM ne coïncident pas en tout point. Nous avons des descendants frères : <code>SiteHeader-titles</code>, <code>SiteHeader-h1</code> et <code>SiteHeader-h2</code>, tous trois sont des enfants du composant <code>SiteHeader</code> alors que dans l'arbre DOM les deux derniers sont des enfants du premier. Autre exemple : le descendant <code>BodyLayout-sidebar</code> est le parent du composant <code>Sidebar</code> dans l'arbre BEM alors que dans le DOM il s'agit du même élément.</p>
  333. <p>
  334. Ensuite, certains morceaux de HTML peuvent être au choix des descendants ou des composants. Pour déterminer quel est le meilleur choix, la question n'est pas : « Cette chose-là a-t-elle du sens indépendamment du reste ? » L'en-tête d'un article, contenant le titre et la date de publication, perdrait son sens s'il était séparé du corps de l'article. Il mérite pourtant souvent d'être un composant car la question à se poser est plutôt : « A-t-on besoin de créer un contexte (d'apparence) à ce niveau ? » Et en effet, la zone de titre d'un article, surtout si elle est complexe, mérite d'être un composant. Cela permettra, par exemple, de la déplacer sous le corps de l'article le jour où ce dernier deviendra une vidéo.</p>
  335. <p>
  336. En cas d'indécision, la règle que je suggère est de faire au plus simple. Dans le code HTML au-dessus, le descendant <code>SiteHeader-titles</code> pourrait être un composant <code>SiteTitles</code>. Dans la mesure où le composant englobant <code>SiteHeader</code> est presque vide, j'ai préféré utiliser son contexte. Mais le jour où nous lui ajouterons d'autres enfants, il deviendra plus pratique de créer un contexte composant à part pour les titres du site.</p>
  337. <h3 id="cas-d-utilisation-partie-2-css-avec-sass">
  338. Cas d'utilisation, partie 2 : CSS avec SASS</h3>
  339. <p>
  340. Dans cette partie, je vais utiliser le préprocesseur SASS avec sa variante syntaxique SCSS. SASS autorise les imbrications et depuis la version 3.3 sortie cette année elles fonctionnent même sur des noms composés.</p>
  341. <p>
  342. En SASS, le <code>&amp;</code> représente le sélecteur du bloc de déclarations parent. Un exemple de code SCSS :</p>
  343. <pre class="code">
  344. <code class="css"><b>.Sidebar</b> {
  345. background-color: #998;
  346. min-height: 160px;
  347. padding: 20px 0;
  348. &amp;<b>-li</b> {
  349. margin-bottom: 10px;
  350. padding: 0 20px;
  351. }
  352. }
  353. </code></pre>
  354. <p>
  355. … Après compilation par SASS, le code CSS généré est le suivant :</p>
  356. <pre class="code">
  357. <code class="css"><b>.Sidebar</b> {
  358. background-color: #998;
  359. min-height: 160px;
  360. padding: 20px 0
  361. }
  362. <b>.Sidebar-li</b> {
  363. margin-bottom: 10px;
  364. padding: 0 20px
  365. }
  366. </code></pre>
  367. <p>
  368. Remarquez la réutilisation du sélecteur parent <code>.Sidebar</code> pour composer celui de l'enfant <code>.Sidebar-li</code>. Simple et nette.</p>
  369. <p>
  370. Reprenons maintenant notre <em>mix</em> du descendant <code>BodyLayout-sidebar</code> et du composant <code>Sidebar</code>. Surtout ne vous laissez pas embrouiller. Cette explication est réellement facile. Il n'y a à chaque fois qu'un simple pattern de deux niveaux de hiérarchie, lequel se répète de manière imbriquée.</p>
  371. <p>
  372. Dans l'arbre BEM, <code>BodyLayout-sidebar</code> est le conteneur de <code>Sidebar</code>. La règle CSS du composant <code>Sidebar</code> régit l'intérieur de la barre latérale, elle a été donnée plus haut. Le positionnement échoit au conteneur dont voici la règle :</p>
  373. <pre class="code">
  374. <code class="css">.BodyLayout-sidebar {
  375. float: right;
  376. width: 25%;
  377. }
  378. </code></pre>
  379. <p>
  380. La largeur du conteneur est définie en pourcentage : <code>25%</code>. Celle du composant <code>Sidebar</code> est indéfinie, ce dernier prendra donc automatiquement la largeur allouée par le conteneur. Rappelons-nous que, dans le cas qui nous préoccupe, le composant et son conteneur sont en réalité le même élément HTML. Or, en CSS, un <em>padding</em> à gauche ou à droite, ou encore une bordure, s'ajoute à la largeur prise par l'élément HTML. Voilà pourquoi un <em>mix</em> demande de la rigueur : ici le composant ne doit pas utiliser ces propriétés CSS sous peine d'agrandir son propre conteneur.</p>
  381. <p>
  382. Si l'on ne peut contrôler les règles CSS qui s'appliquent sur un composant, comme cela est le cas, notamment, dans une application JavaScript modulaire, alors mieux vaut éviter les <em>mix</em> en dissociant dans le DOM les descendants et les composants.</p>
  383. <p>
  384. Le contenu complet du fichier <code>hello-bem.scss</code> :</p>
  385. <pre class="code">
  386. <code class="css">@charset "UTF-8";
  387. // Reset CSS (partial)
  388. html, body, div, p, a, ul, li, footer, header, main {
  389. border: 0;
  390. font: inherit;
  391. margin: 0;
  392. padding: 0;
  393. vertical-align: baseline;
  394. }
  395. body {
  396. line-height: 1;
  397. }
  398. ul {
  399. list-style: none;
  400. }
  401. // CSS Objects
  402. <b>.ob-formattedText</b> {
  403. p {
  404. margin-bottom: .5em;
  405. }
  406. }
  407. // CSS Components
  408. body {
  409. background-color: #EEB;
  410. }
  411. <b>.PageWrapper</b> {
  412. background-color: #CCC;
  413. margin: 0 auto;
  414. width: 750px;
  415. }
  416. <b>.SiteHeader</b> {
  417. height: 120px;
  418. position: relative;
  419. &amp;<b>-titles</b> {
  420. display: inline-block;
  421. left: 80px;
  422. position: absolute;
  423. top: 20px;
  424. }
  425. &amp;<b>-h1</b> {
  426. font-size: 3em;
  427. font-weight: bold;
  428. }
  429. &amp;<b>-h2</b> {
  430. font-size: 1.5em;
  431. font-style: italic;
  432. }
  433. }
  434. <b>.BodyLayout</b> {
  435. &amp;<b>-mainContent</b> {
  436. float: left;
  437. width: 73%;
  438. }
  439. &amp;<b>-sidebar</b> {
  440. float: right;
  441. width: 25%;
  442. }
  443. &amp;::after {
  444. clear: both;
  445. content: "";
  446. display: block;
  447. }
  448. }
  449. <b>.MainContent</b> {
  450. background-color: #FFF;
  451. min-height: 160px;
  452. padding: 20px 40px;
  453. }
  454. <b>.Sidebar</b> {
  455. background-color: #998;
  456. min-height: 160px;
  457. padding: 20px 0;
  458. &amp;<b>-li</b> {
  459. margin-bottom: 10px;
  460. padding: 0 20px;
  461. }
  462. }
  463. <b>.SmallBox</b> {
  464. background-color: #665;
  465. color: #fff;
  466. line-height: 50px;
  467. text-align: center;
  468. &amp;<b>.sticky</b> {
  469. font-weight: bold;
  470. }
  471. }
  472. <b>.SiteFooter</b> {
  473. line-height: 2em;
  474. text-align: center;
  475. }
  476. </code></pre>
  477. <h4 id="discussion-css">
  478. Discussion CSS</h4>
  479. <p>
  480. Intéressons-nous tout d'abord à l'objet CSS <code>ob-formattedText</code>. Il est fait pour habiller des textes provenant d'un éditeur WYSIWYG. En situation réelle, il accueillera l'ensemble des règles d'affichage des éléments de formatage : du paragraphe aux listes à puces en passant par les sous-titres. Puisque les noms des balises HTML apparaissent directement, la séparation des contextes pour les éventuels sous-blocs est brisée. Cela n'est pas conforme à BEM mais il faut bien faire avec la réalité. Seuls des sous-blocs « résistants aux formatages » comme des médias devront être autorisés à l'intérieur de cet objet CSS.</p>
  481. <p>
  482. Un mot encore à propos du positionnement. Le principe général est que les composants CSS et leurs modificateurs ne contiennent pas leur propre positionnement dans leur conteneur. Cela implique, la plupart du temps, de ne définir aucune marge sur l'élément HTML du composant (attention à la fusion des marges) et de ne toucher à aucune propriété qui influencerait le positionnement du composant dans son conteneur.</p>
  483. <p>
  484. Ce principe n'est pas absolu. Le vrai principe sous-jacent est la réutilisation. Un positionnement est utilisé à bon escient dès qu'il fait partie intégrante du composant et ne gène donc aucunement sa réutilisation. Par exemple, le composant <code>PageWrapper</code> dans le code donné ci-dessus contient son propre positionnement centré. Ou encore, un composant <code>InlineFig</code> encapsulant une image avec sa légende, à l'intérieur d'un texte formaté, sera aligné en flottant à gauche ou à droite au moyen d'un modificateur :</p>
  485. <pre class="code">
  486. <code class="css">.InlineFig {
  487. &amp;.alignLeft {
  488. float: left;
  489. margin: 10px 10px 10px 0;
  490. }
  491. &amp;.alignRight {
  492. float: right;
  493. margin: 10px 0 10px 10px;
  494. }
  495. }
  496. </code></pre>
  497. <h3 id="conclusion">
  498. Conclusion</h3>
  499. <p>
  500. Tant que sera respecté le principe d'une séparation rigoureuse entre les contextes des composants CSS, BEM fournira une robuste armature à nos pages Web et à nos applications JavaScript. Mais le Web autorise également des manipulations transversales puissantes. Les objets CSS décoratifs et les traitements en JavaScript travaillant en dehors de toute hiérarchie tirent parti des capacités si particulières des navigateurs, ne nous en privons pas.</p>
  501. <p>
  502. Un parallèle parlera aux amateurs de langages à objets. Un composant CSS est un contexte, de la même manière qu'en programmation un objet en est un. À l'intérieur du composant, toutes sortes de descendants s'appuient sans façon les uns sur les autres, en programmation les membres privés d'un objet font de même. Vu depuis l'extérieur, le composant CSS apparait comme une « boite noire » réutilisable dont le mode d'implémentation n'importe plus. De telles considérations ont donné leur nom aux « objets CSS » de OOCSS.</p>
  503. <p>
  504. Dans le cadre d'une application JavaScript, une bonne ergonomie fera toujours correspondre la ressemblance visuelle à une similitude du comportement programmé en JavaScript. Aussi, les règles CSS doivent être couplées au code JavaScript qui anime la portion du DOM concernée. Terminons alors sur les composants Web, ces briques de construction dans le domaine applicatif et non plus seulement visuel. Ils reposent sur quatre fonctionnalités utilisables séparément :</p>
  505. <p>
  506. Le support par les navigateurs progresse vite. Les quatre sont implémentées par Chrome et Opera, Firefox est en train de suivre, l'équipe d'Internet Explorer <a href="http://status.modern.ie/">y réfléchit</a>. Safari, en revanche, <a href="http://jonrimmer.github.io/are-we-componentized-yet/#code">reste en dehors</a> de la course.</p>
  507. <p>
  508. Avec l'avènement du <em>shadow DOM</em>, certains nœuds du DOM deviennent des points de montage pour des portions de DOM encapsulées. Le DOM acquiert, en quelque sorte, du volume. La taille d'une portion de DOM ainsi encapsulée n'a pas de limite, un composant Web peut embarquer toute une application ! À l'intérieur des <em>shadow DOM</em>, de même bien entendu que dans le DOM principal du document, une syntaxe BEM reste appropriée. Du point de vue CSS, le <em>shadow DOM</em> est un espace de nommage pour les composants CSS embarqués.</p>
  509. <p>
  510. En nous offrant de raisonner « par composants » à tous les niveaux de l'habillage en CSS, la méthodologie BEM et ses syntaxes préfixées s'intègrent naturellement dans un environnement fait de composants Web. Elles sont à la fois le présent et le futur des bonnes pratiques en CSS.</p>
  511. <p class="info">
  512. <em>26/08/2014 : Mise à jour sur l'état de l'implémentation des Web components par les navigateurs.</em><br/>
  513. <em>Publication originale <a href="http://tarh.developpez.com/articles/2014/bonnes-pratiques-en-css-bem-et-oocss/">sur Developpez.com</a>.</em></p>