Webpage Workshop: Home » HTML language reference » Inserted text

Inserted text

This element is used to indicate that text has been inserted into the document at a stage after it was originally written.

<ins
    cite="url"
    class="class name(s)"
    datatime="date"
    id="unique identifier"
    lang="language code"
    style="style information"
    title="text"
>
</ins>

Key:
‡ = Required attribute
** = Transitional only

Explanation of attributes

cite: used to denote the hypertext document or other source in which the cited information can be found. This can be a url or even the ISBN of a book; their is no specific type of document this should cite.

class: used to state which class(es) the element belongs to. It is possible to indicate more than one class for an element by separating each class name with a space character. This attribute is normally used in combination with a stylesheet in order to associate the elements with particular styles defined within the stylesheet.

datetime: this is used to define the time at which the information was deleted. It follows the convensions of the ISO-8601 format for specifying times. This takes on the basic format of YYYY-MM-DDThh:mm:ssTZD, where:

The time zone designator can have numerous values. The first is Z, which is used to denote that the time is in UTC. The second format takes on the form +hh:mm, which indicates that the time is hh hours and mm minutes ahead of UTC. The third format is -hh:mm, which indicates that the time is behind that of UTC.

Note that the letter "T" shown in the format of the string does actually appear when quoting a time in this format. An example of this type of date is 2003-09-14T21:43:00+01:00, which in this case means September 14th, 2003, 9:43 P.M., British Summer Time (BST).

id: used to specify a unique alphanumeric identifier to the element. This is usually used in combination with stylesheets in order to apply a style to one particular instance of an element. Only one element, regardless of type, can be given a particular id.

lang: used to indicate the language being used in the text contained within the element. The value of this attribute takes on the form of the ISO standard lanuage abbreviations found in RFC 3066. A list of these codes can be found on the ISO language codes page.

style: used to specify an inline style to apply to the element. The styles defined here override the styles declared in the header section.

title: used to define an advisory text that may be displayed as a tooltip when a mouse is used to hover over the element.

Event handlers

The following event handlers are defined for this element:

Basic example

This text is original <ins>and this was added later</ins>

The above code will display something like:

This text is original and this was added later

Compatibility

Description: Support of inserted text and attributes in various browsers
Test Internet Explorer 6+ Netscape 4 Mozilla and Netscape 6+ Opera 6+ MSN TV (WebTV) Konqeuror 3.0+
Basic element support  Yes  No  Yes  Yes  No 
Attribute: cite  No  No  Yes  No  No 
Attribute: class  Yes  No  Yes  Yes  No 
Attribute: datetime  No  No  Yes  No  No 
Attribute: id  Yes  No  Yes  Yes  No 
Attribute: lang  Yes  No  No  No  No 
Attribute: style  Yes  No  Yes  Yes  No 
Attribute: title  Yes  No  Yes  Yes  No 

Key:
The browser icons are explained in the below list:
Internet Explorer 6+ = Microsoft Internet Explorer 6+
Netscape 4 = Netscape Communicator 4
Mozilla and Netscape 6+ = Mozilla and Netscape Navigator 6+
Opera 7+ = Opera 7+
MSN TV (WebTV) = MSN TV (aka. WebTV)
Konqeuror 3.0+ = Konqueror 3.0+