HTML XHTML The Complete Reference
home » reference » appendix a » html element reference

<ins> (Inserted Text)


This element is used to indicate that text has been added to the document.

Standard Syntax


<ins
cite="URL"
class="class name(s)"
datetime="date"
dir="ltr | rtl"
id="unique alphanumeric identifier"
lang="language code"
style="style information"
title="advisory text"
</ins>

Attributes Defined by Internet Explorer


accesskey="key" (5.5)
contenteditable=" false | true | inherit " (5.5)
disabled="false | true" (5.5)
hidefocus="true | false" (5.5)
language="javascript | jscript | vbs | vbscript" (4)
tabindex="number"(5.5)
unselectable="on | off" (5.5)

Standard Event Attributes


onclick, ondblclick, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup

Events Defined by Internet Explorer


onactivate, onbeforedeactivate, onbeforeeditfocus, onblur, oncontrolselect, ondeactivate, onfocus, onmove, onmoveend, onmovestart, onreadystatechange, onresizeend, onresizestart, ontimeerror

Element Specific Attributes


cite
The value of this attribute is a URL that designates a source document or message for the information inserted. This attribute is intended to point to information explaining why the text was changed.

datetime
This attribute is used to indicate the date and time the insertion was made. The value of the attribute is a date in a special format as defined by ISO 8601. The basic date format is

yyyy-mm-ddthh:mm:ssTZD
where the following is true:
yyyy=four-digit year such as 1999
mm=two-digit month (01=January, 02=February, and so on)
dd=two-digit day of the month (01 through 31)
hh=two-digit hour (00 to 23) (24-hour clock not AM or PM)
mm=two-digit minute (00 to 59)
ss=two-digit second (00 to 59)
tzd=time zone designator
The time zone designator is either z, which indicates UTC (Universal Time Coordinate, or coordinated universal time format), or +hh:mm, which indicates that the time is a local time that is hh hours and mm minutes ahead of UTC. Alternatively, the format for the time zone designator could be -hh:mm, which indicates that the local time is behind UTC. Note that the letter "T" actually appears in the string, all digits must be used, and 00 values for minutes and seconds might be required. An example value for the datetime attribute might be 1999-10-6T09:15:00-05:00, which corresponds to March 6, 2001, 9:15 A.M., U.S. Eastern Standard Time.

Example


<ins cite="http://www.bigcompany.com/
      changes/oct99.htm"
date="1999-10-06T09:15:00-05:00">

The penalty clause applies to client lateness as well.
</ins>

Compatibility


HTML 4, 4.01, XHTML 1.0, 1.1
Internet Explorer 4, 5, 5.5, 6
Netscape 6, 7
Opera 4-7

Notes


Browsers can render inserted (<ins>) or deleted (<del>) text in a different style to show the changes that have been made to the document. Eventually, a browser could have a way to show a revision history on a document. User agents that do not understand <del> or <ins> will show the information anyway, so there is no harm in adding information, only in deleting it.

(X)HTML Elements
CSS Properties
Previous: input Next: isindex
< Home | About | Chapters | Examples | Errata | Reference | Site Map >