Cookies improve the way our website works, by using this website you are agreeing to our use of cookies. For more information see our privacy policy. OK
WordPress Theme & Editor Syntax Highlighter Blog
WordPress Theme & Editor Syntax Highlighter Forum Blog
You are here: Reference > JavaScript > client-side > event handling > objects > boundElements

boundElements collection

Browser support:
Represents a collection of elements bound to the data set on which the current event occurred.

Syntax:

Properties that reference the object:
•event.boundElements

Possible members:

Properties:
length
Returns an integer that specifies the number of elements in the current collection.

This property is read-only.
Methods:
[nameOrIndex]
Returns an element or a collection of elements from the current collection by name or index.

Parameters:

nameOrIndex
Required. A string or a zero-based integer that specifies the element or elements to retrieve.
  • If an integer value is specified, it specifies the index of the element to retrieve.
  • If this parameter is a string, then it specifies a value for the name or id property of the element or elements to retrieve.

Return value:

  • If no match is found, it returns undefined.
  • If exactly one match is found, it returns the matching element.
  • If more than one match is found, it returns a boundElements sub-collection filled with the matching elements. The sub-collection contains the matching elements in source order.
item (nameOrIndex [, subIndex])
Returns an element or a collection of elements from the current collection by name or index.

Parameters:

nameOrIndex
Required. A string or a zero-based integer that specifies the element or elements to retrieve.
  • If an integer value is specified, it specifies the index of the element to retrieve.
  • If this parameter is a string, then it specifies a value for the name or id property of the element or elements to retrieve.
subIndex
Optional. If more than one matching element is found for the index parameter (possible only if it is a string), the item method creates a boundElements sub-collection filled with the matching elements. In that case, the subIndex property specifies the position of the element in the sub-collection to retrieve. In other cases, the subIndex property has no meaning.

Return value:

  • If no match is found, it returns null.
  • If exactly one match is found, it returns the matching element.
  • If more than one match is found, it returns a boundElements sub-collection filled with the matching elements. The sub-collection contains the matching elements in source order.
namedItem (name)
Returns an element or a collection of elements from the current collection by name.

Parameters:

name
Required. String that specifies a value for the name or id property of the element or elements to retrieve.

Return value:

  • If no match is found, it returns null.
  • If exactly one match is found, it returns the matching element.
  • If more than one match is found, it returns a boundElements sub-collection filled with the matching elements. The sub-collection contains the matching elements in source order.
tags
Returns a NodeList collection that contains all elements from the current collection with the specified tag name.
urns
Returns a NodeList collection that contains all elements to which the specified behavior is attached.

Example HTML code 1:

This example illustrates the use of the boundElements collection:
 Code
news.xml 
<head>
    <script type="text/javascript">
        function OnDataFieldChange () {
            alert ("The '" + event.dataFld + "' field of a movie record has changed within the data source object.");

            for (var i = 0; i < event.boundElements.length; i++) {
                var element = event.boundElements[i];
                element.runtimeStyle.border = "2px solid red";
            }
            alert ("The data source is bound to the elements with red border.");
        }
    </script>
</head>
<body>
    <xml id="movies" oncellchange="OnDataFieldChange ();">
    <?xml version="1.0"?>
        <movies>
            <movie>
                <name>Clark Kent</name>
                <jobtitle>Superman</jobtitle>
                <born>1966</born>
            </movie>
            <movie>
                <name>Lois Lane</name>
                <jobtitle>Reporter</jobtitle>
                <born>1964</born>
            </movie>
        </movies>
    </xml>

    Modify the contents of an input field and click outside the field.
    <br /><br />
    <table>
        <tbody>
            <tr>
                <td>Name: <input datafld="name" type="text" datasrc="#movies"/></td>
                <td>Jobtitle: <input datafld="jobtitle" type="text" datasrc="#movies" /></td>
            </tr>
        </tbody>
    </table>
    <br /><br />
    <table width="100%" cellpadding="0px" cellspacing="2px" border="1px" datasrc="#movies" datapagesize="2">
        <thead>
            <tr>
                <th>Name</th>
                <th>Jobtitle</th>
                <th>Born</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td><input datafld="name" /></td>
                <td><input datafld="jobtitle" /></td>
                <td><input datafld="born" /></td>
            </tr>
        </tbody>
    </table>
</body>
Copy Code Print Preview Syntax Highlighter
Did you find this example helpful? yes no

External links:

boundElements (MSDN)
User Contributed Comments

Post Content

Post Content
WordPress Theme & Editor | Index Panel | Syntax Highlighter | Dottoro
Link To Us | Terms of Use | Contact Us | Privacy Policy
© 2024 Dottoro.com. All rights reserved.
HTML
CSS
JavaScript
Appendix