11.9. data

L'élément <data> représente une propriété dans un thème ou une carte DITA. Bien que l'on puisse utiliser directement l'élément <data> pour capturer des propriétés, il est particulièrement utile comme base de spécialisation. Le traitement par défaut considère les valeurs de propriété comme un type de métadonnée inconnu, mais un traitement personnalisé peut filtrer l'attribut name ou l'élément <specialized> pour formater les propriétés comme des bandeaux ou autres ornements, ou pour récolter des propriétés en vue d'un traitement automatique.

Le sujet de la propriété est habituellement le conteneur de l'élément <data>. Dans le modèle de contenu des éléments <prolog> et <metadata>, la propriété s'applique au thème dans son ensemble. Dans l'élément <topicmeta>, la propriété s'applique au thème référencé. On peut utiliser l'élément <data-about> pour identifier le sujet de la propriété avec une référence explicite.

L'attribut name nomme la propriété pour les processus. On peut utiliser un sous-élément <title> pour fournir un intitulé à la propriété. On peut utiliser l'attribut datatype pour identifier le type de la valeur. La valeur de la propriété est l'une des suivantes :

ATTENTION :
L'élément <data> ne devrait être utilisé que pour des propriétés et ne pas incorporer de texte à formater dans le flux du corps du thème.

Exemple

La structure identifie la bibliothèque et la version démontrée par un échantillon de code :

<codeblock>
   <data name="exampleOf">
      <data name="library" href="ajaxLibrary.js"/>
      <data name="version" value="2006-6-19"/>
   </data>
          ...
</codeblock>

Contient :

Doctype Modèle de contenu
ditabase, topic, task, reference, concept ( données textuelles ou keyword ou option ou parmname ou apiname ou cmdname ou msgnum ou varname ou wintitle ou term ou data ou data-about ou foreign ou unknown ou image ou object ou ph ou codeph ou synph ou filepath ou msgph ou userinput ou systemoutput ou b ou u ou i ou tt ou sup ou sub ou uicontrol ou menucascade ou title) (un nombre quelconque)
map, bookmap ( données textuelles ou keyword ou term ou data ou data-about ou foreign ou unknown ou image ou object ou ph ou title) (un nombre quelconque)

Contenu par :

Doctype Parents
bookmap data-about, data-about, data, title, shortdesc, desc, p, note, lq, q, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, pre, lines, ph, alt, stentry, draft-comment, fn, indexterm, index-base, cite, xref, entry, author, source, publisher, copyrholder, category, prodname, brand, series, platform, prognum, featnum, component, map, topicref, relcell, topicmeta, linktext, searchtitle, bookmeta, publisherinformation, person, organization, summary, printlocation, published, reviewed, edited, tested, approved, bookevent, bookpartno, booknumber, maintainer, topichead, topicgroup, index-see, index-see-also, index-sort-as, organizationname, otherinfo, addressdetails, locality, localityname, administrativearea, thoroughfare, emailaddress, url
map data-about, data-about, data, title, shortdesc, desc, p, note, lq, q, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, pre, lines, ph, alt, stentry, draft-comment, fn, indexterm, index-base, cite, xref, entry, author, source, publisher, copyrholder, category, prodname, brand, series, platform, prognum, featnum, component, map, topicref, relcell, topicmeta, linktext, searchtitle, topichead, topicgroup, index-see, index-see-also, index-sort-as
ditabase data-about, data-about, data, title, shortdesc, desc, p, note, lq, q, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, pre, lines, ph, alt, stentry, draft-comment, fn, indexterm, index-base, cite, xref, entry, author, source, publisher, copyrholder, category, prodname, brand, series, platform, prognum, featnum, component, navtitle, searchtitle, abstract, body, section, example, prolog, metadata, linktext, linkinfo, conbody, prereq, context, cmd, info, tutorialinfo, stepxmp, choice, choptionhd, chdeschd, choption, chdesc, stepresult, result, postreq, refbody, refsyn, proptypehd, propvaluehd, propdeschd, proptype, propvalue, propdesc, glossterm, glossdef, uicontrol, screen, b, u, i, tt, sup, sub, codeph, codeblock, var, oper, delim, sep, pt, pd, fragref, repsep, msgph, msgblock, filepath, userinput, systemoutput, coords, index-see, index-see-also, index-sort-as
topic data-about, data-about, data, title, shortdesc, desc, p, note, lq, q, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, pre, lines, ph, alt, stentry, draft-comment, fn, indexterm, index-base, cite, xref, entry, author, source, publisher, copyrholder, category, prodname, brand, series, platform, prognum, featnum, component, navtitle, searchtitle, abstract, body, section, example, prolog, metadata, linktext, linkinfo, uicontrol, screen, b, u, i, tt, sup, sub, codeph, codeblock, var, oper, delim, sep, pt, pd, fragref, repsep, msgph, msgblock, filepath, userinput, systemoutput, coords, index-see, index-see-also, index-sort-as
task data-about, data-about, data, title, shortdesc, desc, p, note, lq, q, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, pre, lines, ph, alt, stentry, draft-comment, fn, indexterm, index-base, cite, xref, entry, author, source, publisher, copyrholder, category, prodname, brand, series, platform, prognum, featnum, component, navtitle, searchtitle, abstract, body, section, example, prolog, metadata, linktext, linkinfo, prereq, context, cmd, info, tutorialinfo, stepxmp, choice, choptionhd, chdeschd, choption, chdesc, stepresult, result, postreq, uicontrol, screen, b, u, i, tt, sup, sub, codeph, codeblock, var, oper, delim, sep, pt, pd, fragref, repsep, msgph, msgblock, filepath, userinput, systemoutput, coords, index-see, index-see-also, index-sort-as
concept data-about, data-about, data, title, shortdesc, desc, p, note, lq, q, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, pre, lines, ph, alt, stentry, draft-comment, fn, indexterm, index-base, cite, xref, entry, author, source, publisher, copyrholder, category, prodname, brand, series, platform, prognum, featnum, component, navtitle, searchtitle, abstract, body, section, example, prolog, metadata, linktext, linkinfo, conbody, uicontrol, screen, b, u, i, tt, sup, sub, codeph, codeblock, var, oper, delim, sep, pt, pd, fragref, repsep, msgph, msgblock, filepath, userinput, systemoutput, coords, index-see, index-see-also, index-sort-as
reference data-about, data-about, data, title, shortdesc, desc, p, note, lq, q, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, pre, lines, ph, alt, stentry, draft-comment, fn, indexterm, index-base, cite, xref, entry, author, source, publisher, copyrholder, category, prodname, brand, series, platform, prognum, featnum, component, navtitle, searchtitle, abstract, body, section, example, prolog, metadata, linktext, linkinfo, refbody, refsyn, proptypehd, propvaluehd, propdeschd, proptype, propvalue, propdesc, uicontrol, screen, b, u, i, tt, sup, sub, codeph, codeblock, var, oper, delim, sep, pt, pd, fragref, repsep, msgph, msgblock, filepath, userinput, systemoutput, coords, index-see, index-see-also, index-sort-as
glossary data-about, data-about, data, title, shortdesc, desc, p, note, lq, q, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, pre, lines, ph, alt, stentry, draft-comment, fn, indexterm, index-base, cite, xref, entry, author, source, publisher, copyrholder, category, prodname, brand, series, platform, prognum, featnum, component, navtitle, searchtitle, abstract, body, section, example, prolog, metadata, linktext, linkinfo, conbody, glossterm, glossdef, uicontrol, screen, b, u, i, tt, sup, sub, codeph, codeblock, var, oper, delim, sep, pt, pd, fragref, repsep, msgph, msgblock, filepath, userinput, systemoutput, coords, index-see, index-see-also, index-sort-as

Héritage :

- topic/data

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
name Définit un nom unique pour l'objet. CDATA #IMPLIED non
datatype Décrit le type des données contenues dans l'attribut value ou dans l'élément <data>. Une utilisation typique de datatype sera l'adresse URI d'identification d'un type de données XML Schema. CDATA #IMPLIED non
value Spécifie la valeur d'un paramètre d'exécution indiqué par l'attribut name. CDATA #IMPLIED non
href Un hyperlien vers une page web externe (adresse URL) ou une autre ressource non-DITA, ou vers un autre thème DITA dans le même fichier ou dans un autre fichier. L'attribut format identifie le format de la cible. Les cibles non-DITA utilisent une syntaxe URL standard. Les thèmes DITA sont ciblés comme suit.

Cible ailleurs dans le même fichier :

  href="#topicid"

Premier thème dans un fichier différent :

  href="filename.dita"

Thème spécifique dans un fichier différent :

  href="filename.dita#topicid"

Si l'adresse URL contient un caractère ESPERLUETTE « & », on devrait utiliser son symbole (&amp;) pour indiquer ce caractère

CDATA #IMPLIED non
format L'attribut format identifie le format de la ressource référencée. Cf. la section 25.10.3. L'attribut format pour des détails sur les valeurs gérées. CDATA #IMPLIED non
type Décrit la cible d'une référence croisée. Cf. la section 25.10.2. L'attribut type pour des informations détaillées sur les valeurs gérées et les implications de traitement. CDATA #IMPLIED (traité comme si la cible était de type "topic", ou hérité d'un ancêtre) non
scope L'attribut scope identife l'étroitesse de la relation entre le document courant et la ressource cible.
  • Mettez scope="local" si la ressource fait partie de l'ensemble de contenu courant ;
  • Mettez scope="peer" si la ressource fait partie de l'ensemble de contenu courant mais n'est pas accessible lors de la construction ;
  • Mettez scope="external" si la ressource ne fait pas partie de l'ensemble d'information courant et devrait s'ouvrir dans une nouvelle fenêtre de navigateur ;
  • Cf. la section 25.10.1.1. Utilisation de la valeur "-dita-use-conref-target" pour plus d'informations sur la valeur "-dita-use-conref-target".
La valeur de traitement par défaut est "local". Si aucune valeur n'est spécifiée, mais que l'attribut est défini sur un ancêtre dans une carte ou dans la section <related-links>, la valeur sera héritée de l'ancêtre le plus proche.
(local | peer | external | -dita-use-conref-target) #IMPLIED non
%univ-atts; (%select-atts;, %id-atts;, %localization-atts;) Un ensemble d'attributs liés, décrit à la section 25.7. %univ-atts; entité paramètre sans objet pour une entité paramètre sans objet
%global-atts; (xtrf, xtrc) Un ensemble d'attributs liés, décrit à la section 25.2. %global-atts; entité paramètre sans objet pour une entité paramètre sans objet
class, outputclass Attributs communs, décrit à la section 25.9. Autres attributs DITA communs