h-item: Difference between revisions
(explicit validating section) |
(Added parsed json to main example) |
||
Line 16: | Line 16: | ||
The Item Name | The Item Name | ||
</a> | </a> | ||
</source> | |||
Parsed JSON: | |||
<source lang=javascript> | |||
{ | |||
"items": [ | |||
{ | |||
"type": [ | |||
"h-item" | |||
], | |||
"properties": { | |||
"name": [ | |||
"The Item Name" | |||
], | |||
"photo": [ | |||
"http://example.org/items/1/photo.png" | |||
], | |||
"url": [ | |||
"http://example.org/items/1" | |||
] | |||
} | |||
} | |||
] | |||
} | |||
</source> | </source> | ||
Revision as of 18:32, 4 October 2014
<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-21, 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, the #microformats irc channel on irc.freenode.net, and microformats-new mailing list.
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.