Le tableau de choix est un tableau à deux colonnes. Dans chaque ligne, la première colonne contient une option (qui peut-être un mot-clé, un paramètre de ligne de commande ou une valeur d’argument). La deuxième colonne de la ligne contient une description détaillée de l’option. La description détaillée peut inclure plusieurs paragraphes, des listes et même des images.
Les éléments contenus dans un élément <choicetable> sont :
|
<chhead>
|
Lgne d’entête d’un élément <choicetable>. L’élément <chhead> contient les éléments <choptionhd> et <chdeskhd> et est optionnel. Il ne peut y avoir qu’un élément <chhead> dans un élément <choicetable>.
|
|
<choptionhd>
|
Texte d’entête pour la colonne d’option dans un tableay de choix. Le texte devrait être encadré par un élément <p> selon les meilleures pratiques.
|
|
<chdeschd>
|
Texte d’entête pour la colonne description d’un tableau de choix. Le texte devrait être encadré par un élément <p> selon les meilleures pratiques.
|
|
<chrow>
|
Une ligne du corps du tableau de choix. L’élément <chrow> contient les éléments <choption> et <chdesc>. Il peut y avoir un ou plusieurs éléments <chrow> dans un élément <choicetable>.
|
|
<choption>
|
Texte de l’option dans une ligne du tableau de choix. Le texte devrait être encadré par un élément <p> selon les meilleures pratiques.
|
|
<chdesc>
|
Texte de la description dans une ligne du tableau de choix. Le texte devrait être encadré par un élément <p> selon les meilleures pratiques. Il peut y avoir plusieurs éléments dans l’élément <chdesc>.
|
Vidéo : Créer un tableau de choix dans une tâche DITA montre comment utiliser l’assistant de l’éditeur oXygen XML.
Pratique
- Continuez de travailler avec le fichier l_tache_debut.dita.
- À la suite de l’élément <step> contenant l’élément <choices>, créez une nouvelle étape avec un élément <cmd> contenant le texte présenté ici :
<step>
<cmd>Trouvez de bonnes optiques</cmd>
</step>
- Après l’élément <cmd>, ajoutez un élément <choicetable> et tous ses éléments enfants :
<step>
<cmd>Trouvez de bonnes optiques</cmd>
<choicetable>
<chrow>
<choption></choption>
<chdesc></chdesc>
</chrow>
<chrow>
<choption></choption>
<chdesc></chdesc>
</chrow>
</choicetable>
</step>
Pour chaque ligne dans le <choicetable>, vous avez besoin d’un élément <chrow>. La ligne contient deux éléments, tous deux requis : <choption> qui contient le texte de l’option et <chdesc> qui contient le texte de la description. Pour une utilisation normale, le <choption> contient juste quelques mots (habituellement un), tandis que la description peut contenir de nombreuses phrases, ou même paragraphes (élément <p>).
Le <choicetable> a une entête optionnelle (<chhead>), qui vous permet d’étiqueter les deux colonnes du tableau.
- Avant la première ligne du tableau de choix, ajoutez un élément <chhead> et ses enfants, tel que présenté ici :
<step>
<cmd>Trouvez de bonnes optiques</cmd>
<choicetable>
<chhead>
<choptionhd></choptionhd>
<chdeschd></chdeschd>
</chhead>
<chrow>
<choption></choption>
<chdesc></chdesc>
</chrow>
...
</choicetable>
</step>
L’élément <choptionhd> fournit une entête à la colonne d’option ; l’élément <chdeschd> fournit une entête pour la colonne description.
- Ajoutez du contenu à l’élément <chhead> et à ses enfants, tel que présenté ici :
...
<chhead>
<choptionhd>
<p>Type</p>
</choptionhd>
<chdeschd>
<p>Avantages</p>
</chdeschd>
</chhead>
...
- Ajoutez du contenu à l’élément <chrow> et à ses enfants, tel que présenté ici :
...
<chrow>
<choption>
<p>Jumelles</p>
</choption>
<chdesc>
<p>Large champ de vision, permet des observations rapides</p>
</chdesc>
</chrow>
...
- Après la balise de fermeture de l’élément <chrow>, ajoutez un autre élément <chrow> et ajoutez-y du contenu tel que présenté ici :
<choicetable>
...
</chrow>
<chrow>
<choption>
<p>Téléscope d'observation</p>
</choption>
<chdesc>
<p>Plus fort grossissement, meilleure collecte de la lumière</p>
</chdesc>
</chrow>
</choicetable>
Contributeurs
