balises à caractère sectionnant ou non-sectionnant
##################################################

.. warning::

   Attention : le caractère sectionnant n’est pas à opposer au caractère ouvrant/fermant/orphelin des balises. Ces deux choses ne sont pas liées.

Un document HTML est, comme son nom l’indique, un document. À ce titre, il peut possèder un *outline* (une table des matières) composée de différentes sections, qui pourront par exemple être lues par synthèse vocale ain de faciliter la navigation dans le document.

Prenons l’exemple fictif qui suit :

.. code-block:: html

   <document>
     <h1>mon document</h1>

     <section>
       <h2>1. partie 1</h2>
     </section>

     <section>
       <h2>2. partie 2</h2>

       <section>
         <h2>2.1. partie 2.1</h2>
       </section>

       <div>Ceci est un élément non-sectionnant.</div>

     </section>

   <document>

l’\ *outline* de ce document serait :

-  mon document

   -  partie 1
   -  partie 2

      -  partie 2.1

Certaines balises vont créer de nouvelles sections, d’autres non. C’est
un des paramètres à prendre en compte lors de la structuration de votre
document.

.. seealso::

   Vous pouvez retrouver `ici <https://html.spec.whatwg.org/multipage/dom.html#sectioning-content>`_ la liste des éléments sectionnants : article, aside, nav, section

.. warning::

   Attention, les éléments de titrage (hgroup, h1, h2, etc.) définissent le début d'une section même s'ils ne sont pas utilisés avec des éléments sectionnants

.. note::

   N.B. : bien que la notion de document outline ne soit pas encore bien précisée, c’est cependant un outil intéressant pour réfléchir sa structure de document.