Retrieves the ordinal position of the object, in source order, as the object appears in the document's all collection.
Syntax
HTMLN/AScripting[ iIndex = ] object.sourceIndex
Possible Values
iIndexInteger that receives the ordinal position.The property is read-only. The property has no default value.
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.
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>
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, Element Constructor
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.]