Web | This Site

jQuery Tutorial
jQuery UI
jQuery References
jQuery Resources
Selected Reading
© 2011 TutorialsPoint.COM

| Home |  | References |  | Discussion Forums |  | About TP

# jQuery - map( callback ) Method

# Description:

The map( callback ) method translates a set of elements in the jQuery object into another set of values in a jQuery array which may, or may not contain elements.

You could use this method to build lists of values, attributes, css values - or even perform special, custom, selector transformations.

# Syntax:

Here is the simple syntax to use this method:

    selector.map( callback )

## Parameters:

Here is the description of all the parameters used by this method:

- callback: The function to execute on each element in the set.

# Example:

Following is a simple example a simple showing the usage of this method:

    <html>
    <head>
    <title>the title</title>
       <script type="text/javascript"
       src="/jquery/jquery-1.3.2.min.js"></script>
       <script type="text/javascript" language="javascript">

       $(document).ready(function(){
          var mappedItems = $("li").map(function (index) {
          var replacement = $("<li>").text($(this).text()).get(0);
          if (index == 0) {
            // make the first item all caps
            $(replacement).text($(replacement).text().toUpperCase());
          } else if (index == 1 || index == 3) {
            // delete the second and fourth items
            replacement = null;
          } else if (index == 2) {
            // make two of the third item and add some text
            replacement = [replacement,$("<li>").get(0)];
            $(replacement[0]).append("<b> - A</b>");
            $(replacement[1]).append("Extra <b> - B</b>");
          }

          // replacement will be an dom element, null,
          // or an array of dom elements
          return replacement;
        });
        $("#results").append(mappedItems);

      });
      </script>
      <style>
         body { font-size:16px; }
         ul { float:left; margin:0 30px; color:blue; }
         #results { color:red; }
      </style>
    </head>
    <body>
      <ul>
        <li>First</li>
        <li>Second</li>
        <li>Third</li>
        <li>Fourth</li>
        <li>Fifth</li>
      </ul>
      <ul id="results">
      </ul>
    </body>
    </html>

To understand it in better way you can Try it yourself.

Advertisement

Online Image Processing

Indian Baby Names