diff options
Diffstat (limited to 'files/fr/archive/mozilla/firefox/utilisation_de_microformats')
| -rw-r--r-- | files/fr/archive/mozilla/firefox/utilisation_de_microformats/index.html | 197 |
1 files changed, 0 insertions, 197 deletions
diff --git a/files/fr/archive/mozilla/firefox/utilisation_de_microformats/index.html b/files/fr/archive/mozilla/firefox/utilisation_de_microformats/index.html deleted file mode 100644 index f45f86c6b4..0000000000 --- a/files/fr/archive/mozilla/firefox/utilisation_de_microformats/index.html +++ /dev/null @@ -1,197 +0,0 @@ ---- -title: Utilisation de microformats -slug: Archive/Mozilla/Firefox/Utilisation_de_microformats -tags: - - Firefox 3 - - Microformats -translation_of: Archive/Mozilla/Firefox/Using_microformats ---- -<div></div> - -<p>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> - -<h2 id="Chargement_de_l.27API_des_microformats" name="Chargement_de_l.27API_des_microformats">Chargement de l'API des microformats</h2> - -<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>Components.utils.import("resource://gre/modules/Microformats.js"); -</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/docs/Analyse_de_microformats_en_JavaScript">Analyse de microformats en JavaScript</a>.</p> - -<h2 id="Microformats_pr.C3.A9d.C3.A9finis" name="Microformats_pr.C3.A9d.C3.A9finis">Microformats prédéfinis</h2> - -<p>Firefox 3 fournit des définitions implémentant divers microformats répandus :</p> - -<dl> - <dt><code><a href="/fr/docs/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/docs/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/docs/Le_microformat_hCard">hCard</a></code></dt> - <dd>Représente les informations de contact d'une personne.</dd> - <dt><code><a href="/fr/docs/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/docs/Le_microformat_tag">tag</a></code></dt> - <dd>Utilisé pour ajouter des balises à d'autres microformats.</dd> -</dl> - -<h2 id="M.C3.A9thodes" name="M.C3.A9thodes">Méthodes</h2> - -<h3 id="add.28.29" name="add.28.29">add()</h3> - -<p>Ajoute un nouveau microformat au module des microformats.</p> - -<p></p><div class="note"><strong>Note :</strong> Si un microformat du nom spécifié existe déjà, il sera remplacé par le nouveau.</div><p></p> - -<pre>add(nom, définition); -</pre> - -<h5 id="add-Param.C3.A8tres" name="add-Param.C3.A8tres">Paramètres</h5> - -<dl> - <dt><code>nom</code></dt> - <dd>Le nom du microformat à ajouter au module des microformats.</dd> - <dt><code>définition</code></dt> - <dd>Une structure JavaScript décrivant le microformat. Consultez <a href="/fr/docs/Description_de_microformats_en_JavaScript">Description de microformats en JavaScript</a> pour plus de détails.</dd> -</dl> - -<h3 id="count.28.29" name="count.28.29">count()</h3> - -<p>Compte le nombre de microformats dans un document qui correspondent à des critères spécifiés.</p> - -<pre>nbMicroformats = Microformats.count(nom, élémentRacine, options); -</pre> - -<h5 id="count-Param.C3.A8tres_2" name="count-Param.C3.A8tres_2">Paramètres</h5> - -<dl> - <dt><code>nom</code></dt> - <dd>Le nom du microformat à compter.</dd> - <dt><code>élémentRacine</code></dt> - <dd>Obligatoire. L'élément DOM où doit commencer la recherche. Pour rechercher dans le document entier, utiliser <code>content.document</code>.</dd> - <dt><code>options</code></dt> - <dd>Facultatif. Si ce paramètre est fourni, il s'agit d'un objet JavaScript contenant une série de drapeaux parmi les suivants : - <dl> - <dt><code>recurseExternalFrames</code></dt> - <dd>Si à <code>true</code>, les cadres enfants font partie de la recherche. La valeur par défaut est <code>true</code>.</dd> - <dt><code>showHidden</code></dt> - <dd>Si à <code>true</code>, les microformats cachés seront ajoutés ; autrement ils sont ignorés. La valeur par défaut est <code>false</code>.</dd> - <dt><code>debug</code></dt> - <dd>Spécifiez <code>true</code> si le mode debug est utilisé ; sinon indiquez <code>false</code>. La valeur par défaut est <code>false</code>.</dd> - </dl> - </dd> -</dl> - -<h5 id="count-Valeur_de_retour" name="count-Valeur_de_retour">Valeur de retour</h5> - -<p>Une valeur entière indiquant le nombre de microformats correspondant aux critères spécifiés.</p> - -<h3 id="debug.28.29" name="debug.28.29">debug()</h3> - -<p>Renvoie une chaîne qui décrit un objet de microformat.</p> - -<p></p><div class="note"><strong>Note :</strong> 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.</div><p></p> - -<pre>dumpString = debug(objetMicroformat); -</pre> - -<h5 id="debug-Param.C3.A8tres" name="debug-Param.C3.A8tres">Paramètres</h5> - -<dl> - <dt><code>objetMicroformat</code></dt> - <dd>L'objet de microformat à afficher.</dd> -</dl> - -<h5 id="debug-Valeur_de_retour_2" name="debug-Valeur_de_retour_2">Valeur de retour</h5> - -<p>Une chaîne décrivant le contenu de l'objet de microformat spécifié.</p> - -<h3 id="get.28.29" name="get.28.29">get()</h3> - -<p>Renvoie un tableau d'objets de microformat correspondant aux critères spécifiés.</p> - -<pre>microformats = Microformats.get(nom, élémentRacine, options, tableauCible); -</pre> - -<h5 id="get-Param.C3.A8tres" name="get-Param.C3.A8tres">Paramètres</h5> - -<dl> - <dt><code>nom</code></dt> - <dd>Le nom du microformat recherché.</dd> - <dt><code>élémentRacine</code></dt> - <dd>Obligatoire. L'élément DOM d'où sera lancée la recherche. Pour rechercher dans le document entier, indiquer <code>content.document</code>.</dd> - <dt><code>options</code></dt> - <dd>Facultatif. Si fourni, il s'agit d'un objet JavaScript contenant une série éventuellement vide des drapeaux suivants : - <dl> - <dt><code>recurseExternalFrames</code></dt> - <dd>Si défini à <code>true</code>, les cadres enfants référençant du contenu externe feront partie de la recherche. La valeur par défaut est <code>true</code>.</dd> - <dt><code>showHidden</code></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><code>debug</code></dt> - <dd>Indique d'utiliser le mode<em>debug</em> si à <code>true</code>. La valeur par défaut est <code>false</code>.</dd> - </dl> - </dd> - <dt><code>tableauCible</code></dt> - <dd>Facultatif. Si fourni, il s'agir d'un tableau d'objets microformat auquel ajouter les résultats de la recherche.</dd> -</dl> - -<h5 id="get-Valeur_de_retour" name="get-Valeur_de_retour">Valeur de retour</h5> - -<p>Un nouveau tableau d'objets microformat correspondant aux critères de recherche, ou le tableau spécifié par le paramètre <code>microformats</code> auquel les nouveaux objets microformat trouvés auront été ajoutés.</p> - -<h3 id="getNamesFromNode.28.29" name="getNamesFromNode.28.29">getNamesFromNode()</h3> - -<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>liste = Microformats.getNamesFromNode(nœud); -</pre> - -<h5 id="getNamesFromNode-Param.C3.A8tres" name="getNamesFromNode-Param.C3.A8tres">Paramètres</h5> - -<dl> - <dt><code>nœud</code></dt> - <dd>Le nœud pour lequel une liste de noms de microformats doit être obtenue.</dd> -</dl> - -<h5 id="getNamesFromNode-Valeur_de_retour" name="getNamesFromNode-Valeur_de_retour">Valeur de retour</h5> - -<p>Si le <code>nœud</code> 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> - -<h3 id="getParent.28.29" name="getParent.28.29">getParent()</h3> - -<p>Renvoie le nœud parent du microformat ou enfant de microformat spécifié.</p> - -<pre>nœudParent = Microformats.getParent(nœud); -</pre> - -<h5 id="getParent-Param.C3.A8tres" name="getParent-Param.C3.A8tres">Paramètres</h5> - -<dl> - <dt><code>nœud</code></dt> - <dd>Le nœud dont le parent doit être retrouvé.</dd> -</dl> - -<h5 id="getParent-Valeur_de_retour" name="getParent-Valeur_de_retour">Valeur de retour</h5> - -<p>Le parent du nœud spécifié. Ne renvoie rien si le <code>nœud</code> spécifié n'est pas un microformat ou l'enfant d'un microformat.</p> - -<h3 id="isMicroformat.28.29" name="isMicroformat.28.29">isMicroformat()</h3> - -<p>Détermine si le nœud DOM spécifié est un microformat.</p> - -<pre>valeur = Microformats.isMicroformat(nœud); -</pre> - -<h5 id="isMicroformat-Param.C3.A8tres" name="isMicroformat-Param.C3.A8tres">Paramètres</h5> - -<dl> - <dt><code>nœud</code></dt> - <dd>Le nœud DOM dont on veut savoir s'il est un microformat.</dd> -</dl> - -<h5 id="isMicroformat-Valeur_de_retour" name="isMicroformat-Valeur_de_retour">Valeur de retour</h5> - -<p><code>true</code> si le nœud est un microformat, <code>false</code> sinon.</p> - -<p></p><div class="note"><strong>Note :</strong> Cette méthode ne renvoie<em>pas</em> <code>true</code> si le nœud est l'enfant d'un microformat.</div><p></p> |
