h-item

From Microformats Wiki
Revision as of 21:42, 3 August 2017 by Tantek (talk | contribs) (editorial: drop explicit HTML5 on the web from dfn, unnecessary)
Jump to navigation Jump to search

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


h-item is a simple, open format for publishing details about arbitrary items. h-item is one of several open microformat draft standards suitable for embedding data in HTML.

In practice, h-item is almost never used on its own, but rather as the p-item in an h-review if the item being reviewed cannot otherwise be represented by either an h-card, h-product, h-event, or other specific microformat.

Per CC0, to the extent possible under law, the editors have waived all copyright and related or neighboring rights to this work. In addition, as of 2024-11-24, the editors have made this specification available under the Open Web Foundation Agreement Version 1.0.

Example

As the only properties defined by h-item are p-name, u-url and u-photo, in practice only the root class name is ever actually required thanks to microformats-2-implied-properties. Explicit properties may be needed for unusual markup structures or to represent multiple values, e.g. multiple URLs, photos. etc..

<a class="h-item" href="http://example.org/items/1">
  <img src="http://example.org/items/1/photo.png" alt="" />
  The Item Name
</a>

Parsed JSON:

{
  "items": [
    {
      "type": [
        "h-item"
      ],
      "properties": {
        "name": [
          "The Item Name"
        ],
        "photo": [
          "http://example.org/items/1/photo.png"
        ],
        "url": [
          "http://example.org/items/1"
        ]
      }
    }
  ]
}

Properties

  • p-name - item name
  • u-url - permalink URL
  • u-photo - photo URL

All properties are optional.

Status

h-item is a microformats.org draft specification. Public discussion on h-item takes place on h-item-feedback and the #microformats irc channel on irc.freenode.net.

Property Details

(stub, add any property explanations here)

Examples in the Wild

  • … add any h-item examples you find in the wild

Validating

Main article: validators

Test and validate microformats2 markup in general with:

Background

h-item was extracted from the classic hReview microformat as a way of referring to arbitrary reviewed items which cannot be represented by other microformats but which required a “shell” microformat due to the flat property requirement of microformats 2.

See Also