html5: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(→‎Issues: itemprop issue)
m (s/<source>/<syntaxhighlight>/)
 
(30 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<h1>Microformats in HTML 5</h1>
{{DISPLAYTITLE:Microformats in HTML5}}


''This page is to document '''future''' use of microformats in [http://www.w3.org/html/wg/html5 HTML 5]. None of the items documented are supported now, and may change upon proper development within the microformats community, or changes in the HTML 5 specification. This page is to track HTML5 enabled enhancements to microformats, and issues that HTML5 raises. It may be used to track issues which we need to push back into the HTML 5 development process.''
''This page is to document '''future''' use of microformats in [http://www.w3.org/html/wg/html5 HTML5]. None of the items documented are supported now, and may change upon proper development within the microformats community, or changes in the HTML 5 specification. This page is to track HTML5 enabled enhancements to microformats, and issues that HTML5 raises. It may be used to track issues which we need to push back into the HTML 5 development process.''


If there are things that Microformats would like to mark up that aren't handled by HTML5 explicitly, please let the WHATWG know, so we can improve HTML5. This is how <code>time</code> came to be, for instance.
If there are things that microformats would like to mark up that aren't handled by HTML5 explicitly, please let the WHATWG know, so we can improve HTML5. This is how the <code>time</code> element came to be, for instance.


==New features in HTML5==
==New features in HTML5==


* '''<code>time</code> element for representing date times'''. In HTML5, the machine form of datetimes can be represented natively. It should be possible to replace the date-time design pattern with native HTML.
=== time element ===
* '''<code>data-</code> naming convention for tag attributes'''. the draft specification states that any attribute that starts with "data-" will be treated as a storage area for private data.
'''<code>time</code> element for representing date times'''. In HTML5, the machine form of datetimes can be represented natively. In some cases it may be possible to replace the date-time design pattern with native HTML5.
** Note that the data-* stuff is explicitly 'not' for Microformats, at least not Microformats that ever want to be handled natively by the browser. Those attributes are defined in such a way that browsers will never do anything special with them, ever. They are intended for script authors to have a space in which they can play without ever clashing with anything the browser does.
 
* '''Microdata'''. HTML5 provides a set of attributes and associated DOM APIs for extracting data from web pages.
* Recommendation: Use the [[value-class-pattern]], in particular preferably <strong>date-time-separation</strong> for accessibly marking up dates and times while following the <abbr title="Don't Repeat Yourself">DRY</abbr> [[principle]] as much as possible.
 
* [[parsers#HTML::Microformats|HTML::Microformats]] and its predecessors have supported the <code>time</code> element since July 2008.
 
* Try http://dev.h2vx.com/ (the beta version of [[H2VX]]) as it now has preliminary support for <code>&lt;time datetime&gt;</code> as well as the new semantic HTML5 elements.
 
Note: that there are documented [http://wiki.whatwg.org/wiki/Time proposals to extend the time element].  Please add additional opinions and use cases to that wiki page so that we can help improve the time element.
 
There was briefly an optional <code>pubdate</code> attribute, to indicate the publication date of an <code>article</code>, but it was dropped in 2012 since it is both unnecessary and insufficient. Rather than use the one-off pubdate attribute, it's much better to:
* Use the [[hAtom]] microformat for articles, and the hAtom <code>published</code> property, as well as the hAtom <code>updated</code> property.
 
==== hCalendar with time element ====
Here is the [[hcalendar#Examples|hCalendar spec example]] updated to use section instead of div, and time instead of abbr.
 
<syntaxhighlight lang="html">
<section class="vevent">
<a class="url" href="http://conferences.oreillynet.com/pub/w/40/program.html">
  http://conferences.oreillynet.com/pub/w/40/program.html
</a>
<span class="summary">Web 2.0 Conference</span>:
<time class="dtstart" datetime="2005-10-05">October 5</time>-
<time class="dtend" datetime="2005-10-07">7</time>,
at the <span class="location">Argent Hotel, San Francisco, CA</span>
</section>
</syntaxhighlight>
 
=== article element ===
'''<code>article</code>''' element for major, independent compositions of content within a page. Perhaps synonymous with [[hAtom]] <code>hentry</code>. Could be parsed as <code>hentry</code> within explicit <code>hfeed</code> blocks?
 
=== data attributes ===
'''<code>data-</code> naming convention for tag attributes'''. the draft specification states that any attribute that starts with "data-" will be treated as a storage area for private data.
* Note that the data-* stuff is explicitly <em>not</em> for microformats. Those attributes are defined in such a way that browsers will never do anything special with them, ever. They are intended for script authors to have a space in which they can play without ever clashing with anything the browser does. There may be some cases of private [[poshformats]] that are never intended for interchange that may be used in data-* attributes.
 
Since data-* attributes are not for general data interchange or generic APIs supported by multiple sites / pieces of software, what are actual valid uses of data-* attributes? One example (feel free to add more)
* Twitter's use of data-* attributes in markup to be picked up only by Twitter's javascript [https://dev.twitter.com/docs/tweet-button library for Tweet buttons], e.g. <code>data-related="indiewebcamp"</code> - indicates [https://twitter.com/indiewebcamp @indiewebcamp] is a related Twitter account for a tweet button.
 
=== new semantic elements ===
HTML5 has numerous new semantic elements.
 
Most microformats [[parsers]] probably won't recognize those elements and may ignore them - so avoid using microformats classes on new HTML5 semantic elements for anything in production.
 
HOWEVER, do try experimenting with microformats and new semantic HTML5,
 
AND try http://dev.h2vx.com/ (the beta version of [[H2VX]]) as it now has preliminary support for the new semantic HTML5 elements as well as <code>&lt;time datetime&gt;</code>.
 
== Changes in HTML5 ==
=== The rel/rev attributes ===
The <code>rev</code> attribute has been removed from HTML5.  The <code>rel</code> attribute can be still be used in the same way, but microformats that assumed the existence of <code>rev</code> and thus only defined a single forward-facing relation may need to be changed to include an opposite relation as well.  That is, for every relation that goes in one direction (e.g. [[rel-parent]] of [[xfn]]), you must explicitly name and define the inverse relationship (e.g. [[rel-child]] of [[xfn]]) if the inverse relation is indeed useful.
 
== Additions beyond HTML5 ==
=== microdata ===
{{main|microdata}}
'''[[microdata]]''' is an extension to HTML5 that provides a set of attributes and associated DOM APIs for semantically marking up and extracting data from existing content in web pages, similar to microformats but with new attributes.


== Current microformat compatibility ==
== Current microformat compatibility ==
Line 18: Line 70:


== Requests ==
== Requests ==
* microformats examples that use HTML5, e.g.
* "how to use with HTML5" sections that include (a) microformats examples that use [[HTML5]], and (b) microformats parsing details that specify what to do (if anything special is required) with HTML5 elements (e.g. how to parse the <code>time</code> element for dates and times for microformats). See (and add to if necessary) :
** hCalendar with the <code>time</code> element
** [[hcard-brainstorming#how_to_use_with_HTML5|hCard brainstorming - how to use with HTML5]]
* microformats parsing details that specify what to do (if anything special is required) with HTML5 elements
** [[hcalendar-brainstorming#how_to_use_with_HTML5|hCalendar brainstorming - how to use with HTML5]] e.g. hCalendar with the <code>time</code> element
** how to parse the <code>time</code> element for dates and times for microformats
** [[citation-brainstorming#how_to_use_with_HTML5|citation brainstorming - how to use with HTML5]]
** if nothing special is required, then after performing the analysis, that should be noted as well, for the purpose of clarity.
** if nothing special is required for HTML5, then after performing the analysis, that should be noted as well, for the purpose of clarity.


==Issues==
==Issues==
<div class='discussion issues'>
* '''The <code>profile</code> attribute has been removed'''. In HTML, the <code>profile</code> attribute from the <code>head</code> has been removed, with no direct replacement. This causes issues for GRDDL support. It's been suggested that profile URLs be represented in <code>link</code> elements instead, or even as a custom HTTP header. See [[grddl]] and [[profile-uris]]
** See [[rel-profile]] which is the replacement for the profile attribute. [[User:Tantek|Tantek]] 23:24, 5 November 2009 (UTC)
* '''Microdata <code>itemprop</code> duplicates <code>class</code> data'''. the new attribute itemprop is designed to hold some meaningful data about an element, but class already exists to hold this data. Unsure of reasons why itemprop required?
** This is because microdata is designed to be generically parsable, even when the parser does not understand the vocabulary. As such, property names have to be on an explicit attribute, not shared with other, non-data classnames. --[[User:BenWard|BenWard]] 21:12, 4 September 2009 (UTC)
* '''The [http://microformats.org/wiki/value-class-pattern#Date_and_time_parsing recommended removal of the colon in timezone] doesn’t validate''' The relevant uF wiki text is “However the colons ":" separating the hours and minutes of any timezone offset are optional and discouraged in order to make it less likely that a timezone offset will be confused for a time.” ref: [http://www.whatwg.org/specs/web-apps/current-work/multipage/common-microsyntaxes.html#global-dates-and-times HTML5 time microsyntax for &lt;time&gt;] --[[User:Oli|Oli]] 14:40, 14 February 2010 (+9)
* '''Some websites are not ready to upgrade to HTML5''' and must stick with HTML4 (or XHTML1 served/interpreted as HTML4) for now. For example:
**  http://www.ascentsir.com/eng - according to [[IRC]] "ChiefRA" on 2011-06-30
</div>


* '''The <code>rev</code> attribute has been removed'''. In HTML5, <code>rel</code> and <code>rev</code> are no-longer paired, and the <code>rel</code> attribute nolonger describes the direction of a relationship. Microformats which use <code>rev</code> will need to use <code>rel</code> instead.
== see also ==
** Or something like data-rev="vote-for"
* [[HTML3]]
*** As above, <code>data-</code> attributes are for application-context functionality, ''not'' shared vocabularies. Further, the HTML5 specification makes <code>rel</code> the correct attribute to use, regardless of direction, through the changed specification. --[[User:BenWard|BenWard]] 17:53, 12 May 2009 (UTC)
* '''The <code>profile</code> attribute has been removed'''. In HTML, the <code>profile</code> attribute from the <code>head</code> has been removed, with no direct replacement. This causes issues for GRDDL support. It's been suggested that profile URLs be represented in <code>link</code> elements instead, or even as a custom HTTP header. See [[grddl]] and [[profile-uris]]
* '''Microdata itemprop duplicates class data'''. the new attribute itemprop is designed to hold some meaningful data about an element, but class already exists to hold this data. Unsure of reasons why itemprop required?

Latest revision as of 21:27, 26 July 2023


This page is to document future use of microformats in HTML5. None of the items documented are supported now, and may change upon proper development within the microformats community, or changes in the HTML 5 specification. This page is to track HTML5 enabled enhancements to microformats, and issues that HTML5 raises. It may be used to track issues which we need to push back into the HTML 5 development process.

If there are things that microformats would like to mark up that aren't handled by HTML5 explicitly, please let the WHATWG know, so we can improve HTML5. This is how the time element came to be, for instance.

New features in HTML5

time element

time element for representing date times. In HTML5, the machine form of datetimes can be represented natively. In some cases it may be possible to replace the date-time design pattern with native HTML5.

  • Recommendation: Use the value-class-pattern, in particular preferably date-time-separation for accessibly marking up dates and times while following the DRY principle as much as possible.
  • Try http://dev.h2vx.com/ (the beta version of H2VX) as it now has preliminary support for <time datetime> as well as the new semantic HTML5 elements.

Note: that there are documented proposals to extend the time element. Please add additional opinions and use cases to that wiki page so that we can help improve the time element.

There was briefly an optional pubdate attribute, to indicate the publication date of an article, but it was dropped in 2012 since it is both unnecessary and insufficient. Rather than use the one-off pubdate attribute, it's much better to:

  • Use the hAtom microformat for articles, and the hAtom published property, as well as the hAtom updated property.

hCalendar with time element

Here is the hCalendar spec example updated to use section instead of div, and time instead of abbr.

<section class="vevent">
 <a class="url" href="http://conferences.oreillynet.com/pub/w/40/program.html">
  http://conferences.oreillynet.com/pub/w/40/program.html
 </a>
 <span class="summary">Web 2.0 Conference</span>: 
 <time class="dtstart" datetime="2005-10-05">October 5</time>-
 <time class="dtend" datetime="2005-10-07">7</time>,
 at the <span class="location">Argent Hotel, San Francisco, CA</span>
</section>

article element

article element for major, independent compositions of content within a page. Perhaps synonymous with hAtom hentry. Could be parsed as hentry within explicit hfeed blocks?

data attributes

data- naming convention for tag attributes. the draft specification states that any attribute that starts with "data-" will be treated as a storage area for private data.

  • Note that the data-* stuff is explicitly not for microformats. Those attributes are defined in such a way that browsers will never do anything special with them, ever. They are intended for script authors to have a space in which they can play without ever clashing with anything the browser does. There may be some cases of private poshformats that are never intended for interchange that may be used in data-* attributes.

Since data-* attributes are not for general data interchange or generic APIs supported by multiple sites / pieces of software, what are actual valid uses of data-* attributes? One example (feel free to add more)

  • Twitter's use of data-* attributes in markup to be picked up only by Twitter's javascript library for Tweet buttons, e.g. data-related="indiewebcamp" - indicates @indiewebcamp is a related Twitter account for a tweet button.

new semantic elements

HTML5 has numerous new semantic elements.

Most microformats parsers probably won't recognize those elements and may ignore them - so avoid using microformats classes on new HTML5 semantic elements for anything in production.

HOWEVER, do try experimenting with microformats and new semantic HTML5,

AND try http://dev.h2vx.com/ (the beta version of H2VX) as it now has preliminary support for the new semantic HTML5 elements as well as <time datetime>.

Changes in HTML5

The rel/rev attributes

The rev attribute has been removed from HTML5. The rel attribute can be still be used in the same way, but microformats that assumed the existence of rev and thus only defined a single forward-facing relation may need to be changed to include an opposite relation as well. That is, for every relation that goes in one direction (e.g. rel-parent of xfn), you must explicitly name and define the inverse relationship (e.g. rel-child of xfn) if the inverse relation is indeed useful.

Additions beyond HTML5

microdata

Main article: microdata

microdata is an extension to HTML5 that provides a set of attributes and associated DOM APIs for semantically marking up and extracting data from existing content in web pages, similar to microformats but with new attributes.

Current microformat compatibility

There seems to be no issue with current implementation of the following microformats in HTML 5:

Requests

Issues

  • The profile attribute has been removed. In HTML, the profile attribute from the head has been removed, with no direct replacement. This causes issues for GRDDL support. It's been suggested that profile URLs be represented in link elements instead, or even as a custom HTTP header. See grddl and profile-uris
    • See rel-profile which is the replacement for the profile attribute. Tantek 23:24, 5 November 2009 (UTC)
  • Microdata itemprop duplicates class data. the new attribute itemprop is designed to hold some meaningful data about an element, but class already exists to hold this data. Unsure of reasons why itemprop required?
    • This is because microdata is designed to be generically parsable, even when the parser does not understand the vocabulary. As such, property names have to be on an explicit attribute, not shared with other, non-data classnames. --BenWard 21:12, 4 September 2009 (UTC)
  • The recommended removal of the colon in timezone doesn’t validate The relevant uF wiki text is “However the colons ":" separating the hours and minutes of any timezone offset are optional and discouraged in order to make it less likely that a timezone offset will be confused for a time.” ref: HTML5 time microsyntax for <time> --Oli 14:40, 14 February 2010 (+9)
  • Some websites are not ready to upgrade to HTML5 and must stick with HTML4 (or XHTML1 served/interpreted as HTML4) for now. For example:

see also