h-adr

From Microformats Wiki
Jump to navigation Jump to search

Cette page a démarré sur h-adr



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:


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