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

Attribut HTML universel : itemtype

L'attribut universel itemtype définit l'URL du vocabulaire qui sera utilisé pour définir les itemprop (propriétés d'élément) dans la structure de données.

itemscope sert à définir la portée de la structure de données où le vocabulaire défini par itemtype sera actif.

Google et les principaux moteurs de recherche 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, MusicEvent indique une représentation de concert, avec les propriétés startDate (angl.) et location (angl.) qui définissent les détails clés du concert. Dans ce cas, MusicEvent (angl.) serait l'URL utilisée par itemtype, avec startDate et location comme itemprop que MusicEvent (angl.) définit.

Note : Plus d'informations sur les attributs itemtype sont disponibles sur https://schema.org/Thing

  • L'attribut itemtype doit avoir une valeur qui est un ensemble non ordonné de jetons uniques sensibles à la casse, chacun étant une URL valide et absolue, et tous définis pour utiliser le même vocabulaire. La valeur de l'attribut doit contenir au moins un jeton.
  • Les types d'éléments doivent tous être des types définis dans les spécifications applicables (comme schema.org (angl.)), et doivent tous être définis pour utiliser le même vocabulaire.
  • L'attribut itemtype ne peut être défini que sur des éléments qui ont un attribut itemscope.
  • L'attribut itemid ne peut être défini que sur des éléments qui ont à la fois un attribut itemscope et un attribut itemtype défini. Ils ne doivent être définis que sur des éléments avec un attribut itemscope, dont l'attribut itemtype définit un vocabulaire ne prenant pas en charge les identifiants globaux pour les éléments, tel que défini par la spécification de ce vocabulaire.
  • La signification exacte d'un identifiant global est déterminée par la spécification du vocabulaire. Il revient à ces spécifications de définir si plusieurs éléments avec le même identifiant global (que ce soit sur la même page ou sur des pages différentes) sont autorisés à exister, et quelles sont les règles de traitement pour ce vocabulaire concernant la gestion du cas de plusieurs éléments ayant le même identifiant.

Exemples

Représenter des données structurées pour un produit

Cet exemple utilise des attributs de microdonnées pour représenter des données structurées pour un produit, comme suit :

itemscope itemtype Produit (https://schema.org/Product)
itemprop name Enclume exécutive
itemprop image https://pixabay.com/static/uploads/photo/2015/09/05/18/15/suitcase-924605_960_720.png
itemprop description Plus élégante que l'enclume classique d'ACME, l'enclume exécutive est parfaite pour le voyageur d'affaires à la recherche de quelque chose à laisser tomber d'une hauteur.
itemprop mpn 925872
itemprop brand [Thing]
itemprop name ACME
itemscope itemprop[itemtype] aggregateRating[AggregateRating]
itemprop ratingValue 4.4
itemprop reviewCount 89
itemprop offers [Offer] https://schema.org/Offer
itemprop priceCurrency USD
itemprop price 119.99
itemprop priceValidUntil 2020-11-05
itemprop itemCondition https://schema.org/UsedCondition
itemprop availability https://schema.org/InStock
itemscope itemprop[itemtype] seller [Organization] https://schema.org/Organization
itemprop name Objets exécutifs

Note : L'outil Structured Data Testing Tool de Google est très pratique pour extraire les structures de microdonnées d'un code HTML. Essayez-le sur le code HTML présenté ici.

HTML

html
<div itemscope itemtype="https://schema.org/Product">
  <span itemprop="brand">ACME<br /></span>
  <span itemprop="name">Enclume exécutive<br /></span>
  <img
    itemprop="image"
    src="https://pixabay.com/static/uploads/photo/2015/09/05/18/15/suitcase-924605_960_720.png"
    width="50"
    height="50"
    alt="Logo de l'enclume exécutive" /><br />

  <span itemprop="description">
    Plus élégante que l'enclume classique d'ACME, l'enclume exécutive est
    parfaite pour le voyageur d'affaires à la recherche de quelque chose à
    laisser tomber d'une hauteur.
    <br />
  </span>

  Product #: <span itemprop="mpn">925872<br /></span>
  <span
    itemprop="aggregateRating"
    itemscope
    itemtype="https://schema.org/AggregateRating">
    Évaluation&nbsp;: <span itemprop="ratingValue">4.4</span> étoiles, basée sur
    <span itemprop="reviewCount">89 </span> avis
  </span>
  <p>
    <span itemprop="offers" itemscope itemtype="https://schema.org/Offer">
      Prix régulier&nbsp;: 179,99 $<br />
      <meta itemprop="priceCurrency" content="USD" />
      <span itemprop="price">Prix soldé&nbsp;: 119,99 $<br /></span>
      (La vente se termine le
      <time itemprop="priceValidUntil" datetime="2020-11-05">5 novembre!</time>)
      <br />
      Disponible auprès de&nbsp;:
      <span
        itemprop="seller"
        itemscope
        itemtype="https://schema.org/Organization">
        <span itemprop="name">Objets exécutifs<br /></span>
      </span>
      Condition&nbsp;:
      <link
        itemprop="itemCondition"
        href="https://schema.org/UsedCondition" />Déjà utilisé, en excellent
      état<br />
      <link itemprop="availability" href="https://schema.org/InStock" />
      En stock&nbsp;! Commandez maintenant&nbsp;!
    </span>
  </p>
</div>

Résultat

Spécifications

Specification
HTML
# attr-itemtype

Voir aussi