h-adr

Cette page a démarré sur h-adr

• Tantek Çelik (Editeur)
• Christophe Ducamp (Traducteur)

---

h-adr est un format simple, ouvert pour publier des endroits structurés tels que des adresses, physiques et/ou postales. h-adr est l'un des nombreux standards ouverts microformat draft adaptés pour embarquer de la data en HTML/HTML5 sur le web.

h-adr est la mise à jour microformats-2 de adr. Il est le plus communément utilisé comme partie d'une h-card ou d'un h-event.

Exemple

Voic un exemple simple d'adresse postale :

<p class="h-adr">
  <span class="p-street-address">17 Austerstræti</span>
  <span class="p-locality">Reykjavík</span>
  <span class="p-country-name">Iceland</span>
  <span class="p-postal-code">107</span>
</p>

Pour démarrer

La classe h-adr est un nom de classe racine qui indique la présence d'un h-adr.

p-street-address, p-locality, p-country-name, p-postal-code et tous les autres noms de classes propriétés listés ci-dessous définissent les propriétés d'un h-adr.

Voir microformats-2-parsing pour en savoir plus sur les noms de classes propriétés.

Propriétés

Les propriétés h-adr, dans un élément avec la classe h-adr :

• p-street-address - numéro de maison/appartement, étage, nom de rue
• p-extended-address - détails additionnels sur la rue
• p-post-office-box - numéro de boîte postale
• p-locality - ville/village/localité
• p-region - état/pays/province
• p-postal-code - code postal, par ex. ZIP aux USA
• p-country-name - nom du pays
• p-label - une étiquette de mailing, en plein texte, peut-être avec pré-formatage
• p-geo (ou u-geo avec un geo RFC 5870  : URL), embarqué optionnellement avec h-geo
• p-latitude - latitude en décimales
• p-longitude - longitude en décimales
• p-altitude - altitude en décimales - nouveau dans vCard4 (RFC6350)

Toutes les propriétés sont optionnelles.

Statut

h-adr est une spécification draft microformats. La discussion publique sur h-adr à lieu sur h-adr-feedback, le canal irc #microformats sur irc.freenode.net, et la microformats-new liste de diffusion].

h-adr est prêt à être utilisé et implémenté dans la jungle, mais pour de la rétro-compatibilité, vous devriez aussi marquer et enrichir les h-adrs avec les noms de classes adr.

Détails de propriété

(ébauche, ajoutez ici toutes les explications de propriétés)

Exemples dans la jungle

• … ajouter ici tout exemple que vous trouverez dans la jungle

Main article: validators

Test and validate microformats2 markup in general with:

• https://pin13.net/mf2/ - enter your markup directly
• https://pin13.net/ - enter a URL to a page to test where it says "Microformats Parser"

Rétro-compatibilité

Compatibilité pour Auteurs

Pour une rétro-compatibilité, vous pourriez vouloir utiliser les noms de classes classiques adr en plus des propriétés futures h-adr, par exemple :

<p class="h-adr adr">
  <span class="p-street-address street-address">123 rue Principale.</span>, 
  <span class="p-locality locality">VilleSympa</span>
  ...
</p>

Le adr est un nom de classe racine rétro-compatible qui indique la présence d'un adr.

street-address, locality, et tous les noms de classes propriétés rétro-compatibles sont listés en dessous.

Compatibilité Parseurs

Les parseurs microformats devraient détecter les propriétés classiques et les parser comme des propriétés microformats-2. SI un "h-adr" est trouvé, ne pas chercher un "adr" sur le même élément.

Le nom de classe racine compatible : adr

Les propriétés : (parsées comme p - plein texte à moins qu'autre chose ne soit spécifié)

• post-office-box
• extended-address
• street-address
• locality
• region
• postal-code
• country-name

Historique

h-adr est basé sur la spécification adr, qui a été extraite de hCard afin de l'autoriser à être utilisé pour des applications autres que l'information de contact.

Voir aussi

• microformats-2
• h-geo peut être embarqué dans h-adr
• h-card et h-event contiennent souvent h-adr