microformats

Les microformats (parfois abrégé μF) sont une extension HTML pour décrire les entités telles que les personnes, organisations, évènements, lieux, posts de blog, produits, critiques, résumés, recettes, etc. Les sites utilisent les microformats pour publier une API standard utilisée par les moteurs de recherche, agrégateurs de contenu et autres outils.

Le terme “microformats” fait référence à la fois à la première génération de microformats (comme hCard ou hCalendar) et aux nouveaux vocabulaires microformats2 comme h-card ou h-entry. Plusieurs bibliothèques ont été développées pour manipuler les microformats.

Les microformats, microdonnées et RDFa

Les microdonnées sont une spécification du WHATWG HTML  qui est utilisée pour intégrer des métadonnées au sein du contenu d'une page web.
RDFa est un standard du W3C qui applique RDF aux pages web.
Les microformats ne sont pas standardisés bien que les conventions pour les formats hCard et hCalendar soient largement utilisées.

Exemples de microformats

adr

Le microformat adr représente une adresse (physique ou postale)

Propriétés

Chaque propriété est une chaîne de caractères ou vaut undefined sauf mention contraire.

Propriété Description
type

Le type d'adresse. La valeur de cette propriété est undefined ou un tableau non vide dont chaque élément peut être l'une des chaînes de caractères suivante :

work
Une adresse professionnelle.
home
Une adresse pour un domicile.
pref
Une adresse privilégiée. On utilisera cette chaîne pour indiquer que l'adresse est l'adresse privilégiée de la personne ou de l'entreprise à laquelle elle est associée.
postal
Une adresse postale.
dom
Une adresse nationale.
intl
Une adresse internationale.
parcel
Une adresse utilisée pour la livraison de paquets ou de colis.
post-office-box Le numéro pour l'adresse (s'il y en a un).
street-address La rue de l'adresse (soit undefined, soit un tableau contenant des chaînes de caractères).
extended-address Les détails supplémentaires sur l'adresse.
locality La ville ou la localité de l'adresse.
region La région de l'adresse.
postal-code Le code postal de l'adresse.
country-name Le nom du pays où est située l'adresse.

Méthodes

toString()

Cette méthode renvoie l'adresse sous forme d'une chaîne de caractères.

geo

Le microformat geo représente un emplacement physique sur la planète, décrit grâce à une latitude et à une longitude.

Propriétés

Propriété Description
latitude La latitude du lieu, exprimée avec un nombre décimal. Cette propriété est obligatoire.
longitude La longitude du lieu, exprimée avec un nombre décimal. Cette propriété est obligatoire.

Méthodes

toString()

Cette méthode renvoie l'adresse sous forme d'une chaîne de caractères.

geoString = geo.toString();

hCalendar

Le microformat hCalendar représente un rendez-vous ou un évènement dans un calendrier. Le nom de la classe associée est vevent, elle contient deux propriétés obligatoires : summary et dtstart.

Propriétés

Sauf mention contraire, la valeur de chaque propriété est une chaîne de caractères. Si la propriété n'est pas obligatoire, elle peut valoir undefined.

Note : La fonction Microformats.dateFromISO8601 prend en argument une date au format ISO 8601 et renvoie la date (cf. Date) correspondante.
Propriété Description
category Zéro ou plusieurs catégories auxquelles est associé l'évènement. Si une catégorie est un microformat tag, c'est sa propriété tag qui sera utilisée. La valeur peut valoir undefined ou être un tableau non-vide dont chaque élément est une chaîne de caractères.
class La classification associée à l'évènement. Cette propriété peut prendre la valeur public (publique), private (privé) ou confidential (confidentiel).
description Une description de l'évènement en HTML.
dtstart La date et l'heure à laquelle commence l'évènement. Cette valeur est exprimée au format ISO8601. Cette propriété est obligatoire.
dtend La date et l'heure à laquelle finit l'évènement. Cette valeur est exprimée au format ISO8601.
dtstamp La date et l'heure à laquelle l'évènement a été créé dans le calendrier. Cette valeur est exprimée au format ISO8601.
duration La durée de l'évènement. Celle-ci peut être exprimée sous la forme "1w" (pour une semaine) ou "1h" (pour une heure). Pour plus de détails sur le format, voir la RFC 2445.
geo Un emplacement physique associé à l'évènement. La valeur de cette propriété est un microformat geo pour lequel aucune des propriétés n'est obligatoire.
location Le lieu où se déroule l'évènement. La valeur de cette propriété est une chaîne de caractères ou un microformat hCard pour lequel aucune des propriétés n'est obligatoire.
status L'état de l'évènement. Ce peut être l'une des valeurs suivantes : tentative (provisoire), confirmed (confirmé), cancelled (annulé).
summary Une description concise de l'évènement. Cette propriété est obligatoire.
transp Cette propriété indique si l'évènement doit être ignoré lorsqu'on recherche des disponibilités dans le calendrier de l'utilisateur. Si cette propriété vaut transparent, le créneau occupé est considéré comme libre. En revanche, si elle vaut opaque, le créneau est considéré comme indisponible.
uid Un identifiant unique associé à l'évènement.
url Une URL associée à l'évènement.
last-modified La date et l'heure à laquelle l'évènement a été modifié pour la dernière fois. La valeur est exprimée sous la forme d'une date au format ISO8601.
rrule Cette propriété indique la récurence de l'évènement. Pour plus de détails sur le format de la valeur, consulter la RFC 2445.

hCard

Le microformat hCard décrit un contact dans une base de données de contact (c'est en quelque sorte une carte de visite numérique).

Propriétés

Sauf mention contraire, la valeur de chaque propriété est une chaîne de caractères. Si une propriété n'est pas marquée comme obligatoire, elle peut valoir undefined. Si une propriété est qualifiée de plurielle, cela signifie que la valeur peut être undefined ou un tableau non-vide dont chaque élément est une chaîne de caractères. Les valeurs associées aux propriétés email, n, org et tel ne sont actuellement pas complètement documentées.

Propriété Description
adr L'adresse du contact. Cette propriété est plurielle. Chaque élément du tableau est un microformat adr pour lequel aucune des propriétés n'est obligatoire.
agent Les personnes autorisées à agir au nom du contact. Cette propriété est plurielle et chaque élément est une chaîne de caractères ou un microformat hCard dont aucune des propriétés n'est obligatoire.
bday La date d'anniversaire du contact.
class Une classe dans laquelle associer le contact.
category La catégorie à laquelle le contact est associé. Si la valeur de cette propriété est un microformat tag, c'est la propriété tag qui est utilisée. Cette propriété est plurielle.
email Zéro ou plusieurs adresses électroniques pour le contact. Chaque adresse électronique peut contenir deux sous-propriétés (qui sont toutes les deux plurielles) :
type
Une valeur ou plus parmi internet, x400 ou pref. Le type pref indique l'adresse électronique privilégiée.
value
Une ou plusieurs adreses électroniques associées au type indiqué.
fn Le nom complet du contact. Cette propriété est obligatoire.
geo L'emplacement physique du contact. La valeur de cette propriété est un microformat geo pour lequel aucune des propriétés n'est obligatoire.
key La clé publique du contact, qui peut être utilisée pour échanger des données chiffrées avec le contact. Cette propriété est plurielle.
label Un texte mis en forme qui fournie une étiquette d'adresse. Cette propriété est plurielle.
logo Une URI qui pointe vers une image représentant le logo associé au contact (on peut par exemple l'utiliser pour le logo de l'entreprise à laquelle est rattaché le contact). Cette propriété est plurielle.
mailer Le type de messagerie électronique utilisée par le contact. Cette propriété est plurielle.
n Le nom du contact. Cette propriété possède les sous-propriétés suivantes :
honorific-prefix
Zéro ou plusieurs titres à ajouter devent le nom (par exemple Mme, Dr, etc.).
given-name
Le prénom (d'usage) du contact.
additional-name
Un prénom supplémentaire (souvent le deuxième prénom).
family-name
Le nom de famille du contact.
honorific-suffix
Zéro ou plusieurs caractéristiques honorifiques à ajouter après le nom.

La propriété n est normalement obligatoire mais l'implémentation de Mozilla permet d'obtenir une valeur implicite optimisée et dans les faits, elle est donc optionnelle. Elle sera analysée à partir de la propriété fn si nécessaire.

nickname Un surnom pour le contact. Cette propriété est plurielle.
note Une note, en HTML, qui contient des informations complémentaires sur le contact. Cette propriété est plurielle.
org L'organisation à laquelle est associé le contact. La valeur de cette propriété possède deux propriétés :
organization-name
Le nom de l'organisation.
organization-unit
Le département ou le bureau dont fait partie le contact.
photo Une URI qui fournit une photographie du contact. Cette propriété est plurielle.
rev La date et l'heure à laquelle a eu lieu la dernière modification pour ce contact.
role Le rôle associé au contact au sein de son organisation. Cette propriété est plurielle.
sequence Un numéro de version pour le contact. Chaque fois que le contact est modifié, ce numéro devrait être incrémenté.
sort-string Si cette propriété est fournie, cette chaîne de caractères est utilisée plutôt que fn ou n afin de déterminer l'ordre de la carte. Cette propriété peut s'avérer utile lorsque l'ordre lexicographique de la locale du contact est différent de celui utilisé pour les noms des autres contacts.
sound Une URI qui indique un fichier sonore associé au contact. Cette propriété est plurielle.
title Le poste occupé par le contact. Cette propriété est plurielle.
tel Le numéro de téléphone du contact. Cette propriété est plurielle et chaque élément peut contenir les sous-propriétés suivantes :
type
Le type de numéro de téléphone. Cela peut être une ou plusieurs valeurs parmi : msg, home, work, pref, voice, fax, cell, video, pager, bbs, car, isdn, pcs.
tel
Le numéro de téléphone.
tz Le fuseau horaire du contact.
uid Un identifiant unique pour ce contact.
url Une URL associée au contact. Cette propriété est plurielle.

tag

Le microformat tag est utilisé afin d'ajouter des étiquettes à d'autres microformats.

Propriétés

La valeur de chaque propriété est une chaîne de caractères.

Propriété Description
tag Le nom de l'étiquette. C'est le texte qui sera utilisé après la dernière barre oblique du lien. Cette propriété est obligatoire.
link Une URL associée à l'étiquette. Cette propriété est obligatoire.
text Le texte associé à l'étiquette. Cette propriété est obligatoire.

Méthodes

toString()

Cette méthode renvoie l'étiquette sous forme d'une chaîne de caractères.

Voir aussi

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : SphinxKnight, marie-ototoi
 Dernière mise à jour par : SphinxKnight,