35. XHTML Legacy Edit Module

Contents

This section is normative.

This module defines the traditional HTML elements for marking up inserted and deleted content.

ElementAttributesContent Model
del Common ( Text)*
ins Common ( Text)*

Implementations: RELAX NG, XML Schema

35.1. The del element

The del element is used to indicate that a section of a document has been deleted with respect to a different version of the document (e.g., in draft legislation where lawmakers need to view the changes).

Attributes

The Common collection
A collection of other attribute collections, including: Bi-directional, Core, Edit, Embedding, Events, Forms, Hypertext, I18N, Map, Metainformation, and Role

This example could be from a bill to change the legislation for how many deputies a County Sheriff can employ from 3 to 5.

Example

<p>
  A Sheriff can employ <del>3</del><ins>5</ins> deputies.
</p>

User agents should render deleted text in ways that make the change obvious. For instance, inserted text may appear in a special font, deleted text may not be shown at all or be shown as struck-through or with special markings, etc.

Both of the following examples correspond to November 5, 2001, 8:15:30 am, US Eastern Standard Time.

Example

2001-11-05T13:15:30Z
2001-11-05T08:15:30-05:00

Used with ins, this gives:

Example

<ins datetime="2001-11-05T08:15:30-05:00"
        cite="http://www.example.org/mydoc/comments.html">
Furthermore, the latest figures from the marketing department
suggest that such practice is on the rise.
</ins>

The document "http://www.example.org/mydoc/comments.html" would contain comments about why information was inserted into the document.

Authors may also make comments about deleted text by means of the @title attribute for the del element. User agents may present this information to the user (e.g., as a popup note). For example:

Example

<del datetime="2001-11-05T08:15:30-05:00"
        title="Changed as a result of Steve G's comments in meeting.">
Furthermore, the latest figures from the marketing department
suggest that such practice is on the rise.
</del>

35.2. The ins element

The ins element is used to indicate that a section of a document has been inserted with respect to a different version of the document (e.g., in draft legislation where lawmakers need to view the changes).

Attributes

The Common collection
A collection of other attribute collections, including: Bi-directional, Core, Edit, Embedding, Events, Forms, Hypertext, I18N, Map, Metainformation, and Role

User agents should render inserted text in ways that make the change obvious. For instance, inserted text may appear in a special font.