Welcome Sign in
Microsoft Developer Network
Click to Rate and Give Feedback
MSDN
MSDN Library
Web Development
HTML and CSS
Properties
 sourceIndex Property
sourceIndex Property

Retrieves the ordinal position of the object, in source order, as the object appears in the document's all collection.

Syntax

HTMLN/A
Scripting[ iIndex = ] object.sourceIndex

Possible Values

iIndexInteger that receives the ordinal position.

The property is read-only. The property has no default value.

Example

This example uses the sourceIndex property to identify the previous and next elements in the all collection.

<SCRIPT>
function fnHandler(){
   // Retrieve the element that fired the event.
   var oElement=event.srcElement;
   var iIndex=oElement.sourceIndex;
   var sTagName=oElement.tagName;
   if(sTagName=="!"){
      sTagName="COMMENT";
   }
   oVal1.innerText=iIndex;
   oVal2.innerText=sTagName;
   if(iIndex-1>0){
      sTagName=document.all[iIndex-1].tagName;
      if(sTagName=="!"){
         sTagName="COMMENT";
      }   
      oVal3.innerText=sTagName;
   }
   else{
      oVal3.innerText="Cannot read.";
   }
   if(iIndex+1<document.all.length){
      sTagName=document.all[iIndex+1].tagName;
      if(sTagName=="!"){
         sTagName="COMMENT";
      }   
      oVal4.innerText=sTagName;
   }
   else{
      oVal4.innerText="Cannot read.";
   }
}
</SCRIPT>

<BODY onmousemove="fnHandler()">
<TABLE>
<TR><TD>Source Index:</TD><TD ID=oVal1></TD></TR>
<TR><TD>Object Name:</TD><TD ID=oVal2></TD></TR>
<TR><TD>Previous Object:</TD><TD ID=oVal3></TD></TR>
<TR><TD>Next Object:</TD><TD ID=oVal4></TD></TR>
</TABLE>
</BODY>
This feature requires Microsoft® Internet Explorer 4.0 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Standards Information

There is no public standard that applies to this property.

Applies To

A, ABBR, ACRONYM, ADDRESS, APPLET, AREA, B, BASE, BASEFONT, BDO, BGSOUND, BIG, BLOCKQUOTE, BODY, BR, BUTTON, CAPTION, CENTER, CITE, CODE, COL, COLGROUP, COMMENT, CUSTOM, DD, DEL, DFN, DIR, DIV, DL, DT, EM, EMBED, FIELDSET, FONT, FORM, FRAME, FRAMESET, HEAD, hn, HR, HTML, I, IFRAME, IMG, INPUT type=button, INPUT type=checkbox, INPUT type=file, INPUT type=hidden, INPUT type=image, INPUT type=password, INPUT type=radio, INPUT type=reset, INPUT type=submit, INPUT type=text, INS, KBD, LABEL, LI, LINK, LISTING, MAP, MARQUEE, MENU, META, nextID, NOBR, OBJECT, OL, P, PLAINTEXT, PRE, Q, S, SAMP, SCRIPT, SELECT, SMALL, SPAN, STRIKE, STRONG, SUB, SUP, TABLE, TBODY, TD, TEXTAREA, TFOOT, TH, THEAD, TITLE, TR, TT, U, UL, VAR, XMP
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
caution - unstable selection      Mr. Raymond Kenneth Petry ... Thomas Lee   |   Edit   |  

Preliminary:

When using this property to sequence through elements,

the sourceIndex of the selected element may be lower than that of the element selected,

thus halting sequential progress in a frenglish auto loop ...

eg. (reduction from a large document with maybe-1000 of these)
<DL><DIV>
<DT>...<DD>...<DT>...</DT><DL><DT>...</DT></DL><DT><B>frenglish</B><DT>...</DT>
</DIV></DL>

Selecting 'frenglish' from tags('B') will drop to select its enclosing <DT></DT>, and loop-halt.

[I've also seen this occur in descending-order, but haven't traced it yet. Ray.]

[Equally apparent is that Ctrl-B fails to return such a spot to non-bold.]

Tags What's this?: Add a tag
Flag as ContentBug
© 2008 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker