urns method

Artigo
10/13/2015

Retrieves a collection of all objects to which a specified behavior is attached.

Syntax

*object.*urns(urn)

Parameters

urn
Type: VARIANT

Variant of type String that specifies the behavior's URN.

Return value

Type: Object

Returns a collection of objects if successful, or null otherwise.

Standards information

There are no standards that apply here.

Remarks

This method returns an empty collection if no element has the specified behavior attached to it.

Use the length property on the collection to determine the number of elements it contains, and the item method to obtain a particular item in the collection.

Examples

The following example shows how to use the urns method to retrieve a collection of all elements currently attached to the specified behavior and then display a comma-delimited list of these element IDs in a message box.

<script type="text/javascript">
var coll  = document.all.urns("URN1");
var sText = '';
if (coll != null)
{
    for (i=0; i<coll.length; i++) 
       sText += coll.item(i).id + ', ';
    window.alert (sText);
}
</script>

Compartilhar via