hcard-cheatsheet

hCard cheetsheet

Properties

• class="vcard" (1)
  • class="adr"
    • class="type" [work|home|pref|postal|dom|intl]
    • class="post-office-box"
    • class="street-address"
    • class="extended-address"
    • class="region"
    • class="locality"
    • class="postal-code"
    • class="country-name"
  • class="agent"
  • class="bday" (ISO date)
  • class="class" – confidentiality/access classification of the entire hCard
  • class="category"
  • class="email"
    • class="type"
    • class="value"
  • class="fn" (1)
  • class="geo" (3)
    • class="latitude"
    • class="longitude"
  • class="key"
  • class="label"
  • class="logo"
  • class="mailer"
  • class="n" (3)
    • class="honorific-prefix"
    • class="given-name"
    • class="additional-name"
    • class="family-name"
    • class="honorific-suffix"
  • class="nickname"
  • class="note"
  • class="org"
    • class="organization-name" (3)
    • class="organization-unit"
  • class="photo"
  • class="rev" – datetime of the revision of the entire hCard (3)
  • class="role"
  • class="sort-string" (3)
  • class="sound"
  • class="title"
  • class="tel" (Note E.123 for formatting info.)
    • class="type" [home|work|pref|fax|cell|pager]
    • class="value"
  • class="tz" – timezone of the person (3)
  • class="uid" – applies to the entire hCard (3)
  • class="url"

Key

1 - Single occurrence required

2 - One or more, required (n/a)

3 - single occurrence optional

4 - zero or more occurrence

[square brackets] - common list of values

(data format)

pref = preferred

dom = domestic

intl = international

cell = mobile

Notes

• URL in vCard becomes <a class="url" href="...">...</a> inside the element with class="vcard" in hCard.
• Similarly, EMAIL in vCard becomes <a class="email" href="mailto:...">...</a>
• PHOTO in vCard becomes <img class="photo" src="..." alt="Photo of ..." /> or <object class="photo" data="..." type="...">Photo of ...</object>
• UID in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

Related pages

• hCard
• hCard cheatsheet - hCard properties
• hCard creator (feedback) - create your own hCard.
• hCard authoring - learn how to add hCard markup to your existing contact info.
• hCard examples - example usage of various classes within hCard.
• hCard examples in the wild - an on-going list of websites which use hCards.
• hcard-supporting-user-profiles - sites with user profiles marked up with hCard - a very common example.
• hCard FAQ - if you have any questions about hCard, check here.
• hCard implementations - websites or tools which either generate or parse hCards.
• hCard parsing - normative details of how to parse hCards.
• hCards and pages - semantic distinctions between different hCards on a page, and how to identify each
• hcard-user-interface - techniques and issues surrounding user-interfaces to author, publish, and display hCards.
• hCard profile - the XMDP profile for hCard
• hCard singular properties - an explanation of the list of singular properties in hCard.
• hCard tests - a wiki page with actual embedded hCards to try parsing.
• hCard advocacy - encourage others to use hCard
• hCard "to do" - jobs to do

The hCard specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added. These thoughts, issues, and questions are kept in separate pages.

• hCard brainstorming - brainstorms and other explorations relating to hCard.
  • hcard-parsing-brainstorming - brainstorming specific to parsing of hCard
  • geo brainstorming
• hCard feedback - general feedback (as opposed to specific issues).
• hCard issues - specific issues with the specification.
• vCard errata - corrections to the vCard specification, which underlies hCard.
• vCard suggestions - suggested improvements to the vCard specification.