h-item: Difference between revisions
(Added parsed json to main example) |
(→Status: -mailinglist) |
||
Line 51: | Line 51: | ||
== Status == | == Status == | ||
'''h-item''' is a microformats.org draft specification. Public discussion on h-item takes place on [[h-item-feedback]] | '''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 == | == Property Details == |
Revision as of 04:33, 25 May 2015
<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/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.
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-09, 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 nameu-url
- permalink URLu-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
Test and validate microformats2 markup in general with:
- https://pin13.net/mf2/ - enter your markup directly
- https://pin13.net/ - enter a URL to a page to test where it says "Microformats Parser"
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.