expando Property

Sets or retrieves a value indicating whether arbitrary variables can be created within the object .

What's New for Microsoft® Internet Explorer 6

This property now applies to the attribute object.

Syntax

object . expando [ = bExpand ]

Possible Values

bExpand

Boolean that specifies or receives one of the following values.

true	Default. Creation of arbitrary variables is allowed.
false	Creation of arbitrary variables is not allowed.

The property is read/write. The property has a default value of true .

Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see About Dynamic Properties .

Remarks

You can extend the properties on an object by creating arbitrary properties with values. You should be careful, however, because you can unintentionally set a property value when scripting in a case-sensitive language such as Microsoft JScript®. For example, if the property value is borderColor and you type the value "bordercolor = 'blue'" , you have, in fact, created another property on the style object called bordercolor with the value 'blue'. If you query the value of the property, the value "blue" is returned. However, the borders for the element do not turn blue.

Microsoft Visual Basic® Scripting Edition (VBScript) does not support expando properties on its native language objects, nor does it cause Internet Explorer to create expando properties on its objects. Internet Explorer supports creation of expando properties on its objects, in any language, through setAttribute .

Setting the expando property of the document object to false precludes the functionality of all expandos within the document.

The following example demonstrates that, by setting the expando property of the document object to false , the document ignores the UNSELECTABLE expando on the span and allows you to select the text.

<HTML>
<HEAD>
<SCRIPT>
// Set the expando property to false.
document. expando = false;
</SCRIPT>
</HEAD>
<BODY>
<DIV> <SPAN id="oSpan" unselectable="on"> This text should be selectable.</SPAN> </DIV>
</BODY>
</HTML>

Using the previous example and setting the expando property of the document object to true , the span will not allow you to select the text.

<HTML>
<HEAD>
<SCRIPT>
// Set the expando property to true.
document. expando = true;
</SCRIPT>
</HEAD>
<BODY>
<DIV> <SPAN id="oSpan" unselectable="on"> This text should not be selectable.</SPAN> </DIV>
</BODY>
</HTML>

Standards Information

There is no public standard that applies to this property.

Applies To

[ Object Name ] Platform Version

Win32:
Win16:
Windows CE:
Unix:
Mac:

attribute , document

Home | Top | Free Ajax Editor | JavaScript Editor

Get Advanced
JavaScript and Ajax Editor,
Validator and Debugger!
1st JavaScript Editor.

→