A user account is required in order to edit this wiki, but we've had to disable public user registrations due to spam.
To request an account, ask an autoconfirmed user on Chat (such as one of these permanent autoconfirmed members).
Del element: Difference between revisions
(drafted) |
(→dates without times: add example, plus add new "timeref" attribute proposal for visible metadata + dry) |
||
Line 5: | Line 5: | ||
=== dates without times === | === dates without times === | ||
Summary: the <code>datetime</code> attribute (on both del and ins elements) should permit just a date value, in addition to permitting explicit dates with times. | |||
;ISO8601 syntax | ;ISO8601 syntax | ||
:YYYY-MM-DD | :YYYY-MM-DD | ||
Currently the <code>datetime</code> attribute requires <em>both</em> a date and time. | Currently the <code>datetime</code> attribute requires <em>both</em> a date and a time. | ||
On the other hand, the [[time]] element's datetime attribute allows just a date. | On the other hand, the [[time]] element's datetime attribute allows just a date. | ||
Line 17: | Line 17: | ||
# easier for hand-authoring (per the preferring authors principle of the HTML5 design principles). Authors can more easily add ins/del elements with explicit datetime attributes if they are permitted to specify only the date (they might not know or care about the precise time), e.g. in blog posts that are updated by the author. | # easier for hand-authoring (per the preferring authors principle of the HTML5 design principles). Authors can more easily add ins/del elements with explicit datetime attributes if they are permitted to specify only the date (they might not know or care about the precise time), e.g. in blog posts that are updated by the author. | ||
# avoids artificial precision. Forcing an explicit date and time forces authors to enter artificial precision (e.g. YYYY-MM-DDT00:00:00Z instead of YYYY-MM-DD). Allowing just dates permits authors to convey that a del/ins occurred on a certain day, and that the precise time is unknown or irrelevant. | # avoids artificial precision. Forcing an explicit date and time forces authors to enter artificial precision (e.g. YYYY-MM-DDT00:00:00Z instead of YYYY-MM-DD). Allowing just dates permits authors to convey that a del/ins occurred on a certain day, and that the precise time is unknown or irrelevant. | ||
Example: | |||
<pre><nowiki> | |||
<p>Here is a paragraph of text with some important information. | |||
<del datetime="2010-07-29">That was rushed out hurriedly.</del> | |||
<ins datetime="2010-07-29">Update: here is some new information</ins> | |||
</p> | |||
</nowiki></pre> | |||
Opinions / discusion: | |||
* +1 [[User:Tantek|Tantek Çelik]] - this happens to me often when I have blog-like or other essay content that I update by hand. Since I typically do updates to any particular content about once a day, day-level granularity is sufficient. Picking an arbitrary time seems like being forced to provide "fake" metadata which I don't want to do. | |||
* ... | |||
=== timeref === | |||
Summary: add a new <code>timeref</code> attribute that can be used to reference the <code>id</code> of a local to document <code><time></code> element which is then used as the <code>datetime</code> value of when the deletion or insertion occurred. | |||
Example: | |||
<pre><nowiki> | |||
<p>Here is a paragraph of text with some important information. | |||
<del timeref="change1">That was rushed out hurriedly.</del> | |||
<ins timeref="change1">Update | |||
<time id="change1">2010-07-29</time>: | |||
Here is some new information</ins> | |||
</p> | |||
</nowiki></pre> | |||
Advantages: | |||
* <strong>visible metadata!</strong> the date of the change is shown visibly (as many real world examples do (citations needed), rather than invisibly in a hidden datetime attribute, which encourages higher fidelity metadata. | |||
* <strong>DRY! (don't repeat yourself).</strong> compare the previous example to the timeref one - the timeref example provides the date only <em>once</em> instead of duplicating it. | |||
Opinions / discusion: | Opinions / discusion: | ||
* +1 [[User:Tantek|Tantek Çelik]] | * +1 [[User:Tantek|Tantek Çelik]] | ||
* ... | * ... |
Revision as of 22:39, 29 July 2010
Research, data, use cases, issues, and enhancements related to the HTML5 del
element.
datetime attribute
The del
element has a datetime
attribute that requires an explicit date and time.
dates without times
Summary: the datetime
attribute (on both del and ins elements) should permit just a date value, in addition to permitting explicit dates with times.
- ISO8601 syntax
- YYYY-MM-DD
Currently the datetime
attribute requires both a date and a time.
On the other hand, the time element's datetime attribute allows just a date.
Allowing just a date has the following advantages:
- easier for hand-authoring (per the preferring authors principle of the HTML5 design principles). Authors can more easily add ins/del elements with explicit datetime attributes if they are permitted to specify only the date (they might not know or care about the precise time), e.g. in blog posts that are updated by the author.
- avoids artificial precision. Forcing an explicit date and time forces authors to enter artificial precision (e.g. YYYY-MM-DDT00:00:00Z instead of YYYY-MM-DD). Allowing just dates permits authors to convey that a del/ins occurred on a certain day, and that the precise time is unknown or irrelevant.
Example:
<p>Here is a paragraph of text with some important information. <del datetime="2010-07-29">That was rushed out hurriedly.</del> <ins datetime="2010-07-29">Update: here is some new information</ins> </p>
Opinions / discusion:
- +1 Tantek Çelik - this happens to me often when I have blog-like or other essay content that I update by hand. Since I typically do updates to any particular content about once a day, day-level granularity is sufficient. Picking an arbitrary time seems like being forced to provide "fake" metadata which I don't want to do.
- ...
timeref
Summary: add a new timeref
attribute that can be used to reference the id
of a local to document <time>
element which is then used as the datetime
value of when the deletion or insertion occurred.
Example:
<p>Here is a paragraph of text with some important information. <del timeref="change1">That was rushed out hurriedly.</del> <ins timeref="change1">Update <time id="change1">2010-07-29</time>: Here is some new information</ins> </p>
Advantages:
- visible metadata! the date of the change is shown visibly (as many real world examples do (citations needed), rather than invisibly in a hidden datetime attribute, which encourages higher fidelity metadata.
- DRY! (don't repeat yourself). compare the previous example to the timeref one - the timeref example provides the date only once instead of duplicating it.
Opinions / discusion:
- +1 Tantek Çelik
- ...