HCard
hCard is a microformat for publishing the contact details of people, companies, organizations, and places, in HTML, Atom, RSS, or arbitrary XML. The hCard microformat does this using a 1:1 representation of vCard properties and values, identified using HTML classes and rel attributes.
It allows parsing tools to extract the details, and display them, using some other websites or mapping tools, index or search them, or to load them into an address-book program.
In May 2009, Google announced that they would be parsing the hCard, hReview and hProduct microformats, and using them to populate search-result pages. In September 2010 Google announced their intention to surface hCard, hReview information in their local search results. In February 2011, Facebook began using hCard to mark up event venues.
Example
Consider the HTML:- Joe Doe
- Jo
- The Example Company
- 604-555-1234
- http://example.com/
With microformat markup, that becomes:
...
...
- Joe Doe
- Jo
- The Example Company
- 604-555-1234
- http://example.com/
Here the properties fn, nickname, org, tel and url have been identified using specific class names; and the whole thing is wrapped in
class="vcard"
which indicates that the other classes form an hcard, and are not just coincidentally named. If the hCard is for an organization or venue, the fn and org classes are used on the same element, as in Wikipedia
or Wembley Stadium
. Other, optional, hCard classes also exist.It is now possible for software, for example browser plug-ins, to extract the information, and transfer it to other applications, such as an address book.
Geo and adr
The Geo microformat is a part of the hCard specification, and is often used to include the coordinates of a location within an hCard.The adr part of hCard can also be used as a stand-alone microformat.
Live example
Here are the Wikimedia Foundation's contact details as of September 2017, as a live hCard:The mark-up used is:
Wikimedia Foundation Inc.
Phone: +1-415-839-6885
Email: info@wikimedia.org
Fax:
+1-415-882-0495
Note that, in this example, the fn and org properties are combined on one element, indicating that this is the hCard for an organization, not a person.
Other attributes
Other commonly used hCard attributes includebday
- a person's birth dateemail
honorific-prefix
honorific-suffix
label
- for non-granular addresseslogo
nickname
note
- free textphoto
post-office-box