h-item: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(→‎Status: -mailinglist)
m (set up status/editor/participate section, remove redundant DisplayTitle:h-item)
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<entry-title>h-item</entry-title>
<dfn style="font-style:normal;font-weight:bold">h-item</dfn> is a simple, open format for publishing details about arbitrary items. h-item is one of several open [[microformats|microformat]] draft standards suitable for embedding data in HTML.
<span class="h-card vcard"><span class="p-name fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="p-role role">Editor</span>)</span>
----
<dfn style="font-style:normal;font-weight:bold">h-item</dfn> is a simple, open format for publishing details about arbitrary items. h-item is one of several open [[microformats|microformat]] draft standards suitable for embedding data in HTML/HTML5 on the web.


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.
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.


{{cc0-owfa-license}}
;<span id="Status">Status</span>
:This is a '''Draft Specification'''
;Participate
:[[IRC]]: [irc://irc.libera.chat/microformats #microformats on Libera]
;Editor
:<span class="h-card vcard"><span class="p-name fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="p-role role">Editor</span>)</span>
;License
:{{cc0-owfa-license}}
__TOC__


== Example ==
== Example ==

Revision as of 22:07, 1 October 2022

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.

Status
This is a Draft Specification
Participate
IRC: #microformats on Libera
Editor
Tantek Çelik (Editor)
License
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-03-28, 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