commentaires
############

.. raw:: html

   <iframe width="560" height="315" src="https://www.youtube.com/embed/8fb6ev1VTY0" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

Il est possible d’utiliser des commentaires en CSS. Une seule forme de
commentaire est possible, monoligne ou multiligne, en délimitant ceux-ci
à l’aide des séparateurs ``/*`` et ``*/`` respectivement pour le début
et la fin. [#commentaires]_

exemple
*******

.. code-block:: css

   @media (max-width: 320px) {
     /* lorsque la taille du viewport
        est inférieure à 320px */
     body {
       /* la taille de la typo est à 12px **/
       font-size: 12px;
     }
   }

.. note::

   Il n'existe pas de commentaire monoligne en CSS. On utilise parfois ``//`` mais il ne s'agit pas de commentaire à proprement parler : cela génère une erreur et les navigateurs tendent alors à ignorer la ligne concernée, un peu comme un commentaire.

   Par exemple, le CSS suivant :

   .. code-block:: css

      body {
         //background:white;
      }

   Génère l'erreur suivante :

   .. image:: ../images/erreur-commentaire--1.png
      :alt: ⚠️ › Déclaration attendue, mais « / » trouvé. Passage à la déclaration suivante.

   On pourrait tout aussi bien enlever le second ``/`` ou même utiliser le code suivant pour obtenir le même résultat :

   .. code-block:: css

      body {
         !background:white;
      }

   .. image:: ../images/erreur-commentaire--2.png
      :alt: ⚠️ › Déclaration attendue, mais « ! » trouvé. Passage à la déclaration suivante.



.. [#commentaires]  “Comments begin with the characters "/*" and end with the characters "*/".” – `“Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification – 4 Syntax and basic data types.” <https://www.w3.org/TR/CSS2/syndata.html#comments>`_ Edited by Bert Bos et al., Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification – 4 Syntax and basic data types, W3C, 12 Apr. 2016.