Copies all read/write attributes to the specified element.
Syntax
object.mergeAttributes(oSource [, bPreserve])
Parameters
oSource
Required.
Pointer to an Object that specifies the attributes copied to the object that invokes mergeAttributes.
bPreserve
Optional.
Available as of Microsoft® Internet Explorer 5.5. Pointer to a Boolean that specifies one of the following values:
true
Default. Preserve the identity of the object to which attributes are being merged.
false
Do not preserve the identity of the object to which attributes are being merged.
Return Value
No return value.
Remarks
The mergeAttributes method copies persistent HTML attributes, events, and styles.
In Internet Explorer 5 and earlier, attributes that are read-only, such as ID, are not merged.
As of Internet Explorer 5.5, by choosing not to preserve the identity of the destination object, you can merge all attributes of an object, including ID and NAME.
Example
This example uses the mergeAttributes method to copy attributes, events, and styles from one object to another.
<SCRIPT>
function fnMerge(){
oSource.children[1].mergeAttributes(oSource.children[0]);
}
</SCRIPT>
<SPAN ID=oSource>
<DIV
ID="oDiv"
ATTRIBUTE1="true"
ATTRIBUTE2="true"
onclick="alert('click');"
onmouseover="this.style.color='#0000FF';"
onmouseout="this.style.color='#000000';"
>
This is a sample <B>DIV</B> element.
</DIV>
<DIV ID="oDiv2">
This is another sample <B>DIV</B> element.
</DIV>
</SPAN>
<INPUT
TYPE="button"
VALUE="Merge Attributes"
onclick="fnMerge()"
>
This feature requires Microsoft® Internet Explorer 5 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 method.
