Paragraphes (et autres éléments de bloc) dans les notes

Évitez d'utiliser des éléments de bloc dans les notes. Des éléments de bloc enfants doivent être utilisés uniquement lorsqu'une note contient plusieurs points ou idées.

L'élément note peut contenir un ou plusieurs paragraphes (p) ou d'autres éléments données de bloc. Les éléments note et p sont tous les deux des éléments de bloc.

Ci-dessous, les deux options de balisage :

<note>
 Il y a quatre types d'alimentation forcée.
</note>

et

<note>
 <p>Il y a quatre types d'alimentation forcée.</p>
</note>

Ces options de balisages sont valides mais utiliser les deux options de balisage à la fois entraîne des incohérences.

On peut affirmer que les deux options sont différentes d'un point de vue sémantique. Un paragraphe est une unité indépendante qui traite une seule idée. Une note suit un objectif différent, visant à mettre en avant des idées auxiliaires ou associées. Par conséquent, une note unique n'a pas besoin de contenir de paragraphe. Cependant, dans la plupart des cas, il y aura plusieurs idées (notes) auxiliaires, d'où la nécessité de diviser la note en plusieurs blocs de texte.

La meilleure technique reste de simplifier le balisage au maximum.

Si la note contient seulement un bloc de texte, elle doit être composée de données de chaînes de caractères. Cela permet de conserver les balises élémentaires et simplifier la sortie. Si la note contient des blocs multiples, il faut alors utiliser des paragraphes, des listes ou autres éléments de bloc. Ne débutez jamais une note par des données de chaînes de caractères suivies d'un bloc.

Dans un ensemble de notes, si une note doit inclure des éléments de bloc, toutes les notes de l'ensemble doivent être traitées systématiquement de la même manière. L'utilisation de méthodes de balisage mixtes (blocs dans certaines notes, chaînes de caractères dans d'autres) risque de provoquer un rendu de sortie incohérent.

Dans une même note, le texte constitué de données de chaînes de caractères ne doit pas être utilisé avec des éléments de bloc.