25.1. %display-atts;

Le groupe des attributs d'affichage est une déclaration d'entité de paramètre dans la définition DTD du thème qui comprend des attributs dont les valeurs peuvent servir à affecter l'affichage d'un thème ou sa sélection par les outils de recherche.

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
scale Spécifie un pourcentage, sélectionné dans une liste énumérée, utilisé pour redimensionner les fontes par rapport à la taille normale du texte. Cet attribut s'utilise principalement pour l'impression.

L'attribut scale fournit une propriété reconnue de type style directement sur les éléments DITA. Pour les éléments <table> et <fig>, la propriété permet aux auteurs d'ajuster les dimensions des fontes sur le contenu de l'élément conteneur, principalement pour l'impression. Dans ces contextes, une image ne sera redimensionnée que selon son propre attribut scale. Sans redimensionnement spécifique, une telle image n'est pas affectée par la propriété scale de son parent <table> ou <fig>.

(50 | 60 | 70 | 80 | 90 | 100 | 110 | 120 | 140 | 160 | 180 | 200 | -dita-use-conref-target) #IMPLIED non
frame Spécifie quelle portion d'une bordure devrait entourer l'élément. Les valeurs admissibles sont :
top
Dessine une ligne avant l'élément.
bottom
Dessine une ligne après l'élément.
topbot
Dessine une ligne avant et après l'élément.
all
Dessine un cadre autour de l'élément.
sides
Dessine une ligne à chaque bord de l'élément.
none
Ne dessine aucune ligne autour de cet élément.
-dita-use-conref-target
Cf. la section 25.10.1.1. Utilisation de la valeur "-dita-use-conref-target" pour plus d'informations.

Certains processeurs DITA ou formats de sortie ne gèreront peut-être pas toutes les valeurs.

(top | bottom | topbot | all | sides | none | -dita-use-conref-target) #IMPLIED non
expanse Détermine le positionnement horizontal de l'élément.

Les valeurs admissibles sont :

page
Place l'élément sur la marge gauche de la page.
column
Aligne l'élément à la marge de colonne courante.
textline
Aligne l'élément à la marge gauche de la ligne de texte courante et prend en compte l'indentation.
-dita-use-conref-target
Cf. la section 25.10.1.1. Utilisation de la valeur "-dita-use-conref-target" pour plus d'informations sur la valeur de conref.

Pour une sortie non paginée, telle que XHTML, certaines valeurs ne seront pas gérées.

Dans les tables DITA, on emploie l'attribut pgwide à la place de l'attribut expanse utilisé par les autres éléments DITA, pour la conformité avec le modèle OASIS Exchange Table Model. Cet attribut a une sémantique similaire (1=largeur de la page ; 0=redimensionner à la galée ou la colonne).

(page | column | textline | -dita-use-conref-target) #IMPLIED non

Exemple

L'entité de paramètre %display-atts; est utilisée dans les définitions DTD DITA comme définition commune des attributs qui affectent la présentation de certains éléments. Ces capacités n'ont pas encore été toutes offertes au traitement de thème DITA. Voici un exemple typique :

<codeblock scale="90" frame="topbot" expanse="page">
/* a long sample program */
Do forever
  Say "Hello, World"
End
</codeblock>