h-adr

From Microformats Wiki
Revision as of 16:11, 13 June 2013 by Barnabywalters (talk | contribs) (→‎Properties: added BC information)
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

<entry-title>h-adr</entry-title> Tantek Çelik (Editor)


h-adr is a simple, open format for publishing people and organisations on the web. h-adr is one of several open microformat draft standards suitable for embedding data in HTML/HTML5.

h-adr is the microformats-2 replacement for adr. It is most commonly used as part of an h-card or h-event.

Example

Here is a simple minimal person example:

<p class="p-adr 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>

Get started

The class h-adr is a root class name that indicates the presence of an h-adr.

p-street-address, p-extended-address and all the other h-adr property classnames define an element as a property of the h-adr.

See microformats-2-parsing to learn more about property classnames.

Properties

  • p-street-address - house/apartment number, floor, street name
  • p-extended-address - additional street details
  • p-post-office-box
  • p-locality - city/town/village
  • p-region - state/county/province
  • p-postal-code - postal code, e.g. ZIP in the US
  • p-country-name - country name
  • p-label - new in vCard4 (RFC6350)
  • p-geo (or u-geo with a RFC 5870 geo: URL), optionally a nested h-geo
  • p-latitude - metric latitude
  • p-longitude - metric longitude
  • p-altitude - metric altitude

For backward compatibility, microformats 2 parsers should detect the following root class name and property names. A microformats 2 parser may use existing microformats parsers to extract these properties. If an "h-adr" is found, don't look for an "adr" on the same element.

compat root class name: adr properties: (parsed as p- plain text unless otherwise specified)

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

Status

h-adr is a microformats.org draft specification. Public discussion on h-adr takes place on h-adr-feedback, the #microformats irc channel on irc.freenode.net, and microformats-new mailing list.

h-adr is ready to use and implemented in the wild, but for backwards compatibility you should also mark h-adrs up with classic adr classnames.

Property Details

(stub, add any property explanations here)

Background

h-adr is based on the existing adr specification, which was extracted from hCard in order to allow it to be used for applications other than contact information.

See Also