h-item: Difference between revisions
(Category:Draft Specifications) |
m (Replace <entry-title> with {{DISPLAYTITLE:}}) |
||
(7 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
{{DISPLAYTITLE:h-item}} | |||
<span class="h-card vcard"><span class="p-name fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="p-role role">Editor</span>)</span> | <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 | <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. | ||
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}} | |||
== Example == | == Example == | ||
Line 14: | 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> | ||
== Properties == | == Properties == | ||
* '''<code>p-name</code>''' - item name | * '''<code>p-name</code>''' - item name | ||
* '''<code>u-url</code>''' - permalink URL | * '''<code>u-url</code>''' - permalink URL | ||
* '''<code>u-photo</code>''' - photo URL | * '''<code>u-photo</code>''' - photo URL | ||
All properties are optional. | |||
== 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 == | ||
Line 31: | Line 58: | ||
== Examples in the Wild == | == Examples in the Wild == | ||
* … add any h-item examples you find in the wild | |||
== Validating == | |||
{{h-spec-section-validating}} | |||
== Background == | == 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. | 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. | ||
Revision as of 16:23, 18 July 2020
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-04-19, 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.