L’attribut HTML data-bdf-milestone pour la construction d’une table des matières

Comme indiqué dans la fiche Proposer une table des matières dans le formulaire d’une fiche, un sommaire est construit automatiquement lorsque des balises <h2> sont présentes dans des commentaires ou lorsqu’une fiche satellite est insérée. Le code Javascript qui permet cette construction est celui du fichier js/ficheframe/Ficheframe.js.

Cette construction repose sur l’attribut @data-bdf-milestone qui peut avoir trois valeurs possibles :

• satellite : le script recherche à l’intérieur de l’élément porteur de l’attribut les balises <h1> ;

• comment : le script recherche à l’intérieur de l’élément porteur de l’attribut les balises <h2> ;

• heading : c’est l’élément porteur de l’attribut qui sert à la construction du sommaire.

Dans le cas d’un gabarit personnalisé, c’est cette troisième valeur qui nous intéresse, les deux autres valeurs correspondant au code HTML généré automatiquement par l’insertion d’une fiche satellite ou d’un commentaire.

Cet attribut peut être complété par un autre attribut @data-bdf-goto qui permet d’indiquer à quel endroit du formulaire se positionner lorsque la fiche sera ouverte en édition. Cet attribut peut être absent et dans ce cas-là, le formulaire s’ouvrira normalement au début.

<h2 data-bdf-milestone="heading" data-bdf-goto="section_text">Texte complet</h2>

<xsl:apply-templates select="section[@name='text']" mode="component-FieldReference"/>