Retrieves a collection of attributes of the object.
Syntax
[
oColl
= ] object.attributes |
[ oObject = ] object.attributes(iIndex) |
Possible Values
oColl
| Zero-based array of attributes applied to the object. |
oObject | Reference to an individual item in the array of elements contained by the object. |
iIndex | Required. Integer that specifies the zero-based index of the item to be returned. |
Members Table
The following table lists the members exposed by the
attributes
object.
Attributes/Properties
Property | Description |
---|
length |
Sets or retrieves the number of objects in a collection. |
Methods
Method | Description |
---|
getNamedItem |
Gets an attribute specified with the name property by using the attributes collection. |
getNamedItem |
Gets an attribute specified with the name property,
by using the attributes collection. |
item |
Gets an attribute for an element from the attributes collection. |
removeNamedItem |
Removes an attribute specified with the name property from an element by using the attributes collection. |
removeNamedItem |
Removes an attribute specified with the name property from an element by using the attributes collection. |
setNamedItem |
Adds an attribute to an element by using an attributes collection. |
setNamedItem |
Adds an attribute to an element by using an attributes collection. |
Remarks
The expando properties of an object are included in the attributes collection of the object as of Microsoft Internet Explorer 6. To access the expando properties of an object in earlier versions of Internet Explorer, use the Microsoft JScript for...in construct.
The attributes collection does not expose the style object. Use the cssText property of the object's style property to retrieve the persistent representation of the cascading styles associated with an object.
Unlike other DHTML collections, such as all and children, the attributes collection is static. Modifications to the properties of an object are not automatically reflected by an existing reference to the attributes collection of that object.
In Internet Explorer 6, This collection now applies to the attribute object.
Example
This example shows how to iterate through the collection of attributes of the specified object, displaying the name and value of the attributes as well as the language of the attribute (HTML or script).
<SCRIPT>
function ShowAttribs(oElem)
{
txtAttribs.innerHTML = '';
// Retrieve the collection of attributes for the specified object.
var oAttribs = oElem.attributes;
// Iterate through the collection.
for (var i = 0; i < oAttribs.length; i++)
{
var oAttrib = oAttribs[i];
// Print the name and value of the attribute.
// Additionally print whether or not the attribute was specified
// in HTML or script.
txtAttribs.innerHTML += oAttrib.nodeName + '=' +
oAttrib.nodeValue + ' (' + oAttrib.specified + ')<BR>';
}
}
</SCRIPT>
Standards Information
This collection is defined in
World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 .
Applies To
|
A,
ABBR,
ACRONYM,
ADDRESS,
APPLET,
AREA,
attribute,
B,
BASE,
BASEFONT,
BDO,
BGSOUND,
BIG,
BLOCKQUOTE,
BODY,
BR,
BUTTON,
CAPTION,
CENTER,
CITE,
CODE,
COL,
COLGROUP,
COMMENT,
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,
LEGEND,
LI,
LINK,
LISTING,
MAP,
MARQUEE,
MENU,
nextID,
OBJECT,
OL,
OPTION,
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 |
See Also
About the W3C Document Object Model