Utilisation de microformats

  • Raccourci de la révision : Utilisation_de_microformats
  • Titre de la révision : Utilisation de microformats
  • ID de la révision : 166694
  • Créé :
  • Créateur : Mgjbot
  • Version actuelle ? Non
  • Commentaire robot Ajoute: [[pl:Zastosowanie mikroformatów]] <<langbot>>

Contenu de la révision

{{template.Fx_minversion_header(3)}} {{wiki.template('Traduction_à_relire')}} {{template.Draft()}} Les microformats permettent aux sites Web de fournir des données sémantiques au navigateur afin que celui-ci puisse présenter un résumé des informations présentes sur une page sans avoir à connaître de manière particulière d'analyser son contenu. Firefox 3 implémente un objet global Microformats permettant d'accéder aux microformats. Cet objet et l'API associée facilitent la recherche et la lecture de microformats.

Chargement de l'API des microformats

L'objet Microformats est créé à l'aide du nouveau chargeur de scripts JavaScript ajouté à Firefox 3. Pour utiliser l'API, il faut d'abord charger cet objet :

Components.utils.import("resource://gre/modules/Microformats.js");

Une fois l'API des microformats chargée, il est possible de gérer des microformats à l'aide des méthodes listées ici. Pour plus d'information sur l'analyse de microformats, consultez Analyse de microformats en JavaScript

Microformats prédéfinis

Firefox 3 fournit des définitions implémentant divers microformats répandus :

adr
Représente une adresse (comme une adresse de destination ou une adresse postale).
geo
Représente un emplacement géographique en utilisant sa latitude et sa longitude.
hCard
Représente les informations de contact d'une personne.
hCalendar
Représente une entrée de rendez-vous d'un agenda.
tag
Utilisé pour ajouter des balises à d'autres microformats.

Méthodes

add()

Ajoute un nouveau microformat au module des microformats.

{{template.Note("Si un microformat du nom spécifié existe déjà, il sera remplacé par le nouveau.")}}

add(nom, définition);
Paramètres
<tt>nom</tt>
Le nom du microformat à ajouter au module des microformats.
<tt>définition</tt>
Une structure JavaScript décrivant le microformat. Consultez Description de microformats en JavaScript pour plus de détails.

count()

Compte le nombre de microformats dans un document qui correspondent à des critères spécifiés.

nbMicroformats = Microformats.count(nom, élémentRacine, recurseFrames);
Paramètres
<tt>nom</tt>
Le nom du microformat à compter.
<tt>élémentRacine</tt>
Facultatif. L'élément DOM où doit commencer la recherche. Par défaut, il s'agit de content.document (en d'autres mots, le document entier).
<tt>recurseFrames</tt>
Facultatif. Si ce paramètre vaut true, les cadres enfants font partie de la recherche. La valeur par défaut est true.
Valeur de retour

Une valeur entière indiquant le nombre de microformats correspondant aux critères spécifiés.

debug()

Renvoie une chaîne qui décrit un objet de microformat.

{{template.Note("Il est possible d\'appeler simplement <code>debug()</code> sur un objet de microformat : <code>objetMicroformat.debug()</code> au lieu d\'utiliser cette méthode, si cela vous convient mieux.")}}

dumpString = debug(objetMicroformat);
Paramètres
<tt>objetMicroformat</tt>
L'objet de microformat à afficher.
Valeur de retour

Une chaîne décrivant le contenu de l'objet de microformat spécifié.

get()

Renvoie un tableau d'objets de microformat correspondant aux critères spécifiés.

microformats = Microformats.get(nom, élémentRacine, options, tableauCible);
Paramètres
<tt>nom</tt>
Le nom du microformat recherché.
<tt>élémentRacine</tt>
L'élément DOM d'où sera lancée la recherche.
<tt>options</tt>
Facultatif. Si fourni, il s'agit d'un objet JavaScript contenant une série éventuellement vide des drapeaux suivants :
<tt>recurseFrames</tt>
Si défini à true, les cadres enfants feront partie de la recherche. La valeur par défaut est true.
<tt>showHidden</tt>
Si défini à true, les microformats masqués seront ajoutés ; dans le cas contraire ils seront ignorés. La valeur par défaut est false.
<tt>debug</tt>
Indique d'utiliser le mode debug si à true. La valeur par défaut est false.
<tt>tableauCible</tt>
Facultatif. Si fourni, il s'agir d'un tableau d'objets microformat auquel ajouter les résultats de la recherche.
Valeur de retour

Un nouveau tableau d'objets microformat correspondant aux critères de recherche, ou le tableau spécifié par le paramètre <tt>microformats</tt> auquel les nouveaux objets microformat trouvés auront été ajoutés.

getNamesFromNode()

Renvoie une liste de noms de microformats séparés par des espaces qui correspondent au nœud de microformat spécifié.

liste = Microformats.getNamesFromNode(nœud);
Paramètres
<tt>nœud</tt>
Le nœud pour lequel une liste de noms de microformats doit être obtenue.
Valeur de retour

Si le <tt>nœud</tt> spécifié est un microformat, le résultat est une chaîne listant tous les noms de microformats, séparés par des espaces, qui correspondent à ce nœud. Si le nœud n'est pas un microformat, rien ne sera renvoyé.

getParent()

Renvoie le nœud parent du microformat ou enfant de microformat spécifié.

nœudParent = Microformats.getParent(nœud);
Paramètres
<tt>nœud</tt>
Le nœud dont le parent doit être retrouvé.
Valeur de retour

Le parent du nœud spécifié. Ne renvoie rien si le <tt>nœud</tt> spécifié n'est pas un microformat ou l'enfant d'un microformat.

isMicroformat()

Détermine si le nœud DOM spécifié est un microformat.

valeur = Microformats.isMicroformat(nœud);
Paramètres
<tt>nœud</tt>
Le nœud DOM dont on veut savoir s'il est un microformat.
Valeur de retour

true si le nœud est un microformat, false sinon.

{{template.Note("Cette méthode ne renvoie <i>pas</i> <code>true</code> si le nœud est l\'enfant d\'un microformat.")}}

{{ wiki.languages( { "en": "en/Using_microformats", "pl": "pl/Zastosowanie_mikroformat\u00f3w" } ) }}

Source de la révision

<p>{{template.Fx_minversion_header(3)}}
{{wiki.template('Traduction_à_relire')}}
{{template.Draft()}}
Les microformats permettent aux sites Web de fournir des données sémantiques au navigateur afin que celui-ci puisse présenter un résumé des informations présentes sur une page sans avoir à connaître de manière particulière d'analyser son contenu. Firefox 3 implémente un objet global <code>Microformats</code> permettant d'accéder aux microformats. Cet objet et l'API associée facilitent la recherche et la lecture de microformats.
</p>
<h3 name="Chargement_de_l.27API_des_microformats"> Chargement de l'API des microformats </h3>
<p>L'objet <code>Microformats</code> est créé à l'aide du nouveau chargeur de scripts JavaScript ajouté à Firefox 3. Pour utiliser l'API, il faut d'abord charger cet objet :
</p>
<pre class="eval"><span class="plain">Components.utils.import("resource://gre/modules/Microformats.js");</span>
</pre>
<p>Une fois l'API des microformats chargée, il est possible de gérer des microformats à l'aide des méthodes listées ici. Pour plus d'information sur l'analyse de microformats, consultez <a href="fr/Analyse_de_microformats_en_JavaScript">Analyse de microformats en JavaScript</a>
</p>
<h3 name="Microformats_pr.C3.A9d.C3.A9finis"> Microformats prédéfinis </h3>
<p>Firefox 3 fournit des définitions implémentant divers microformats répandus :
</p>
<dl><dt><code><a href="fr/Le_microformat_adr">adr</a></code>
</dt><dd>Représente une adresse (comme une adresse de destination ou une adresse postale).
</dd><dt><code><a href="fr/Le_microformat_geo">geo</a></code>
</dt><dd>Représente un emplacement géographique en utilisant sa latitude et sa longitude.
</dd><dt><code><a href="fr/Le_microformat_hCard">hCard</a></code>
</dt><dd>Représente les informations de contact d'une personne.
</dd><dt><code><a href="fr/Le_microformat_hCalendar">hCalendar</a></code>
</dt><dd>Représente une entrée de rendez-vous d'un agenda.
</dd><dt><code><a href="fr/Le_microformat_tag">tag</a></code>
</dt><dd>Utilisé pour ajouter des balises à d'autres microformats.
</dd></dl>
<h3 name="M.C3.A9thodes"> Méthodes </h3>
<h4 name="add.28.29"> add() </h4>
<p>Ajoute un nouveau microformat au module des microformats.
</p><p>{{template.Note("Si un microformat du nom spécifié existe déjà, il sera remplacé par le nouveau.")}}
</p>
<pre class="eval">add(nom, définition);
</pre>
<h6 name="Param.C3.A8tres">Paramètres</h6>
<dl><dt><tt>nom</tt>
</dt><dd>Le nom du microformat à ajouter au module des microformats.
</dd><dt><tt>définition</tt>
</dt><dd>Une structure JavaScript décrivant le microformat. Consultez <a href="fr/Description_de_microformats_en_JavaScript">Description de microformats en JavaScript</a> pour plus de détails.
</dd></dl>
<h4 name="count.28.29"> count() </h4>
<p>Compte le nombre de microformats dans un document qui correspondent à des critères spécifiés.
</p>
<pre class="eval">nbMicroformats = Microformats.count(nom, élémentRacine, recurseFrames);
</pre>
<h6 name="Param.C3.A8tres_2">Paramètres</h6>
<dl><dt> <tt>nom</tt>
</dt><dd> Le nom du microformat à compter.
</dd><dt> <tt>élémentRacine</tt>
</dt><dd> Facultatif. L'élément DOM où doit commencer la recherche. Par défaut, il s'agit de <code>content.document</code> (en d'autres mots, le document entier).
</dd><dt> <tt>recurseFrames</tt>
</dt><dd> Facultatif. Si ce paramètre vaut <code>true</code>, les cadres enfants font partie de la recherche. La valeur par défaut est <code>true</code>.
</dd></dl>
<h6 name="Valeur_de_retour">Valeur de retour</h6>
<p>Une valeur entière indiquant le nombre de microformats correspondant aux critères spécifiés.
</p>
<h4 name="debug.28.29"> debug() </h4>
<p>Renvoie une chaîne qui décrit un objet de microformat.
</p><p>{{template.Note("Il est possible d\'appeler simplement &lt;code&gt;debug()&lt;/code&gt; sur un objet de microformat : &lt;code&gt;objetMicroformat.debug()&lt;/code&gt; au lieu d\'utiliser cette méthode, si cela vous convient mieux.")}}
</p>
<pre class="eval">dumpString = debug(objetMicroformat);
</pre>
<h6 name="Param.C3.A8tres_3">Paramètres</h6>
<dl><dt> <tt>objetMicroformat</tt>
</dt><dd> L'objet de microformat à afficher.
</dd></dl>
<h6 name="Valeur_de_retour_2">Valeur de retour</h6>
<p>Une chaîne décrivant le contenu de l'objet de microformat spécifié.
</p>
<h4 name="get.28.29"> get() </h4>
<p>Renvoie un tableau d'objets de microformat correspondant aux critères spécifiés.
</p>
<pre class="eval">microformats = Microformats.get(nom, élémentRacine, options, tableauCible);
</pre>
<h6 name="Param.C3.A8tres_4">Paramètres</h6>
<dl><dt> <tt>nom</tt>
</dt><dd> Le nom du microformat recherché.
</dd><dt> <tt>élémentRacine</tt>
</dt><dd> L'élément DOM d'où sera lancée la recherche.
</dd><dt> <tt>options</tt>
</dt><dd> Facultatif. Si fourni, il s'agit d'un objet JavaScript contenant une série éventuellement vide des drapeaux suivants :
</dd></dl>
<blockquote>
<dl><dt> <tt>recurseFrames</tt>
</dt><dd> Si défini à <code>true</code>, les cadres enfants feront partie de la recherche. La valeur par défaut est <code>true</code>.
</dd><dt> <tt>showHidden</tt>
</dt><dd> Si défini à <code>true</code>, les microformats masqués seront ajoutés ; dans le cas contraire ils seront ignorés. La valeur par défaut est <code>false</code>.
</dd><dt> <tt>debug</tt>
</dt><dd> Indique d'utiliser le mode <i>debug</i> si à <code>true</code>. La valeur par défaut est <code>false</code>.</dd></dl></blockquote>


<dl><dt> <tt>tableauCible</tt>
</dt><dd> Facultatif. Si fourni, il s'agir d'un tableau d'objets microformat auquel ajouter les résultats de la recherche.
</dd></dl>

<h6 name="Valeur_de_retour_3">Valeur de retour</h6>
<p>Un nouveau tableau d'objets microformat correspondant aux critères de recherche, ou le tableau spécifié par le paramètre <tt>microformats</tt> auquel les nouveaux objets microformat trouvés auront été ajoutés.
</p>
<h4 name="getNamesFromNode.28.29"> getNamesFromNode() </h4>
<p>Renvoie une liste de noms de microformats séparés par des espaces qui correspondent au nœud de microformat spécifié.
</p>
<pre class="eval">liste = Microformats.getNamesFromNode(nœud);
</pre>
<h6 name="Param.C3.A8tres_5">Paramètres</h6>
<dl><dt> <tt>nœud</tt>
</dt><dd> Le nœud pour lequel une liste de noms de microformats doit être obtenue.
</dd></dl>
<h6 name="Valeur_de_retour_4">Valeur de retour</h6>
<p>Si le <tt>nœud</tt> spécifié est un microformat, le résultat est une chaîne listant tous les noms de microformats, séparés par des espaces, qui correspondent à ce nœud. Si le nœud n'est pas un microformat, rien ne sera renvoyé.
</p>
<h4 name="getParent.28.29"> getParent() </h4>
<p>Renvoie le nœud parent du microformat ou enfant de microformat spécifié.
</p>
<pre class="eval">nœudParent = Microformats.getParent(nœud);
</pre>
<h6 name="Param.C3.A8tres_6">Paramètres</h6>
<dl><dt> <tt>nœud</tt>
</dt><dd> Le nœud dont le parent doit être retrouvé.
</dd></dl>
<h6 name="Valeur_de_retour_5">Valeur de retour</h6>
<p>Le parent du nœud spécifié. Ne renvoie rien si le <tt>nœud</tt> spécifié n'est pas un microformat ou l'enfant d'un microformat.
</p>
<h4 name="isMicroformat.28.29"> isMicroformat() </h4>
<p>Détermine si le nœud DOM spécifié est un microformat.
</p>
<pre class="eval">valeur = Microformats.isMicroformat(nœud);
</pre>
<h6 name="Param.C3.A8tres_7">Paramètres</h6>
<dl><dt> <tt>nœud</tt>
</dt><dd> Le nœud DOM dont on veut savoir s'il est un microformat.
</dd></dl>
<h6 name="Valeur_de_retour_6">Valeur de retour</h6>
<p><code>true</code> si le nœud est un microformat, <code>false</code> sinon.
</p><p>{{template.Note("Cette méthode ne renvoie &lt;i&gt;pas&lt;/i&gt; &lt;code&gt;true&lt;/code&gt; si le nœud est l\'enfant d\'un microformat.")}}
</p>
<div class="noinclude">
</div>
{{ wiki.languages( { "en": "en/Using_microformats", "pl": "pl/Zastosowanie_mikroformat\u00f3w" } ) }}
Revenir à cette révision