Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Utiliser les microdonnées en HTML

Les microdonnées font partie du standard HTML WHATWG et servent à imbriquer des métadonnées dans le contenu existant des pages web. Les moteurs de recherche et les robots d'indexation peuvent extraire et traiter les microdonnées d'une page web pour offrir une expérience de navigation enrichie aux utilisateur·ice·s. Les moteurs de recherche tirent grand profit d'un accès direct à ces données structurées, car cela leur permet de comprendre les informations présentes sur les pages web et de fournir des résultats plus pertinents aux utilisateur·ice·s. Les microdonnées utilisent un vocabulaire associé pour décrire un élément et des paires nom-valeur pour attribuer des valeurs à ses propriétés. Les microdonnées sont une tentative de fournir une méthode déclarative pour annoter les éléments HTML avec des balises lisibles par machine, par rapport aux approches similaires utilisant RDFa et les microformats classiques.

À un niveau général, les microdonnées se composent d'un groupe de paires nom-valeur. Les groupes sont appelés éléments, et chaque paire nom-valeur est une propriété. Les éléments et les propriétés sont représentés par des éléments HTML classiques.

  • Pour créer un élément, on utilise l'attribut itemscope.
  • Pour ajouter une propriété à un élément, on utilise l'attribut itemprop sur l'un des descendants de l'élément.

Vocabulaires

Google et les autres moteurs de recherche majeurs prennent en charge le vocabulaire schema.org (angl.) pour les données structurées. Ce vocabulaire définit un ensemble standard de noms de types et de noms de propriétés, par exemple, schema.org Music Event (angl.) indique une représentation de concert, avec les propriétés startDate (angl.) et location (angl.) pour définir les détails clés du concert. Dans ce cas, schema.org Music Event (angl.) sera l'URL utilisée par itemtype et startDate et location seront les itemprop définis par schema.org Music Event (angl.).

Note : Pour en savoir plus sur les attributs itemtype, consultez le site https://schema.org/Thing (angl.).

Les vocabulaires de microdonnées fournissent la sémantique ou la signification d'un Item. Les développeur·euse·s Web peuvent concevoir un vocabulaire personnalisé ou utiliser des vocabulaires disponibles sur le Web, tels que le vocabulaire largement utilisé schema.org (angl.). Une collection de vocabulaires de balisage couramment utilisés est fournie par Schema.org.

Vocabulaires couramment utilisés :

Les principaux opérateurs de moteurs de recherche comme Google, Microsoft et Yahoo ! s'appuient sur le vocabulaire schema.org (angl.) pour améliorer les résultats de recherche. Pour certains usages, un vocabulaire ad-hoc est adéquat. Pour d'autres, un vocabulaire devra être conçu. Dans la mesure du possible, les auteurs sont encouragés à réutiliser les vocabulaires existants, car cela facilite la réutilisation du contenu.

Localisation

Dans certains cas, les moteurs de recherche couvrent un public régional. Certaines extensions sont donc ajoutées aux microdonnées pour fournir du contenu spécifique. Ainsi, Yandex qui est un moteur de recherche très présent en Russie supporte des microformats comme hCard (informations de contact d'une entreprise), hRecipe (recette de cuisine), hReview (avis du marché) et hProduct (données sur les produits) et fournit son propre format pour dédfinir les termes et les articles encyclopédiques. Cette extension a été construite afin de résoudre les problèmes de translitération entre les alphabets cyrillique et latin. En raison de la mise en œuvre de paramètres de balisage supplémentaires du vocabulaire de Schema, l'indexation des informations sur les pages Web en langue russe est devenue considérablement plus efficace.

Attributs universels liés aux microdonnées

itemid — Identifiant unique et global d'un élément.

itemprop — Utilisé pour ajouter des propriétés à un élément. Tout élément HTML peut avoir un attribut itemprop défini, où un itemprop consiste en une paire nom et valeur.

itemref — Les propriétés qui ne sont pas des descendants d'un élément avec l'attribut itemscope peuvent être associées à l'élément à l'aide de itemref. itemref fournit une liste d'identifiants d'éléments (et non de itemid) avec des propriétés supplémentaires ailleurs dans le document.

itemscope — L'attribut itemscope fonctionne généralement avec itemtype pour indiquer que le HTML contenu dans un bloc concerne un élément particulier. L'attribut itemscope crée un Item et définit la portée de l'itemtype qui lui est associé. L'attribut itemtype est une URL valide d'un vocabulaire (comme schema.org (angl.)) qui décrit l'élément et le contexte de ses propriétés.

itemtype — Définit l'URL du vocabulaire qui sera utilisée pour définir les itemprop (propriétés d'élément) dans la structure de données. L'attribut itemscope est utilisé pour définir la portée dans la structure de données où le vocabulaire défini par itemtype sera actif.

Exemple

HTML

html
<div itemscope itemtype="https://schema.org/SoftwareApplication">
  <span itemprop="name">Angry Birds</span> - NÉCESSITE
  <span itemprop="operatingSystem">ANDROID</span><br />
  <link
    itemprop="applicationCategory"
    href="https://schema.org/GameApplication" />

  <div
    itemprop="aggregateRating"
    itemscope
    itemtype="https://schema.org/AggregateRating">
    ÉVALUATION&nbsp;:
    <span itemprop="ratingValue">4.6</span> (
    <span itemprop="ratingCount">8864</span> notes )
  </div>

  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer">
    Prix&nbsp;: <span itemprop="price">1.00</span>$
    <meta itemprop="priceCurrency" content="USD" />
  </div>
</div>

Données structurées

itemscope itemtype SoftwareApplication (https://schema.org/SoftwareApplication)
itemprop name Angry Birds
itemprop operatingSystem ANDROID
itemprop applicationCategory GameApplication (https://schema.org/GameApplication)
itemscope itemprop[itemtype] aggregateRating [AggregateRating]
itemprop ratingValue 4.6
itemprop ratingCount 8864
itemscope itemprop[itemtype] offers [Offer]
itemprop price 1.00
itemprop priceCurrency USD

Résultat

Note : Un outil pratique pour extraire et vérifier les structures de microdonnées à partir du HTML est le Schema Markup Validator (angl.). Essayez-le sur le HTML présenté ci-dessus.

Voir aussi