Dans l’optique de donner une instruction au lecteur, il peut y avoir plus d’une option pour ce dernier. Par exemple, pour utiliser un autoradio stéréo, le lecteur peut choisir son mode d’utilisation (AM, FM, CD, source externe, etc.).
Pour présenter cette information, et pour lui attribuer une étiquette sémantiquement appropriée, vous pouvez utiliser les éléments <choices> ou <choicetable>.
-
Utilisez <choices> quand les choix requièrent seulement une bref description
-
Utilisez <choicetable> (détaillé plus loin dans ce cours) lorsque vous avez besoin de fournir des mots-clés spécifiques, avec une description étendue pour chacun d’entre eux
L’élément <choices> est habituellement présenté comme une liste à puces. La structure de l’élément <choices> est comme celle de l’élément <ul> :
| Élément <ul> |
Élément <choices> |
<ul>
<li>une chose</li>
<li>un autre chose</li>
</ul>
|
<choices>
<choice>une chose</choice>
<choice>une autre chose</choice>
</choices>
|
L’élément <choices> contient un ou plusieurs éléments <choice>. Chaque élément <choice> présente une des options du lecteur. Le contenu de l’élément <choice> est tout élément pouvant être utilisé dans un élément <li>.
Pratique
- Continuez de travailler sur le fichier l_tache_debut.dita
- Après la balise de fermeture du premier élément <step>, ajoutez un nouvel élément <step>. À l’intérieur de cet élément <step>, créez un élément <cmd> (si aucun n’a été créé pour vous). Ajoutez le contenu présenté ici dans l’élément <cmd> :
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<task id="ma_premiere_tache">
...
</step>
<step>
<cmd>Choisissez un guide de terrain pour identifier les canards.</cmd>
</step>
</steps>
</taskbody>
</task>
- Après le nouvel élément <cmd>, ajoutez un élément <choices>.
<step>
<cmd>Choisissez un guide de terrain pour identifier les canards.</cmd>
<choices>
</choices>
</step>
- Si votre éditeur ne l’a pas fait automatiquement, ajoutez un premier élément <choice> à l’intérieur de l’élément <choices>.
<step>
<cmd>Choisissez un guide de terrain pour identifier les canards.</cmd>
<choices>
<choice>De nombreux observateurs de canards modernes s'appuient sur le guide Sibley</choice>
</choices>
</step>
Par défaut, la plupart des générateurs de publication DITA formatent l’élément <choices> comme une liste à puce.
- Ajoutez un élément <choice> supplémentaire.
<step>
<cmd>Choisissez un guide de terrain pour identifier les canards.</cmd>
<choices>
<choice>De nombreux observateurs de canards modernes s'appuient sur le guide Sibley</choice>
<choice>Celui préféré par les traditionalistes est le guide Peterson</choice>
</choices>
</step>
Contributeurs
