25.10.4. L'attribut role

L'attribut role définit le rôle joué par le thème cible dans la relation avec le thème courant. Par exemple, dans une relation parent/enfant, le rôle serait "parent" si la cible était le parent du thème courant, et "child" si la cible était l'enfant du thème courant. On pourrait utiliser cette structure pour trier et classer les liens lors de l'affichage.

Valeurs gérées

Les valeurs admissibles pour l'attribut role sont les suivantes :

parent

Indique un lien vers un thème qui est un parent du thème courant.

child

Indique un lien vers un sous-thème direct tel qu'un thème directement imbriqué ou dépendant.

sibling

Indique un lien entre deux sous-thèmes du même thème parent.

friend

Indique un lien vers un thème similaire qui ne fait pas nécessairement partie de la même hiérarchie.

next

Indique un lien vers le thème suivant dans une séquence.

previous

Indique un lien vers le thème prédédent dans une séquence.

cousin

Indique un lien vers un autre thème dans la même hiérarchie qui n'est pas du type "parent", "child", "sibling", "next" ou "previous".

ancestor

Indique un lien vers un thème au-dessus du thème parent.

descendent

Indique un lien vers un thème au-dessous d'un thème enfant.

sample

À éviter (deprecated).

external

À éviter. Utilisez l'attribut scope="external" pour indiquer des liens externes.

other

Indique tout autre type de relation ou rôle. Entrez ce rôle en valeur de l'attribut otherrole.

-dita-use-conref-target

Cf. la section 25.10.1.1. Utilisation de la valeur "-dita-use-conref-target" pour plus d'informations.

OASIS DITA Version 1.1 Language Specification — OASIS Standard, 1 August 2007
Copyright © OASIS Open 2005, 2007. All Rights Reserved.