h-item

From Microformats Wiki
Jump to navigation Jump to search

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 2020-08-06, 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 microformats2 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 #microformats on freenode 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: microformats validators

Test and validate microformats2 markup in general with:

Background

h-item was extracted from the classic hReview 0.4 (in progress) 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