add

« Обратно к списку traversing-функций

[редактировать]

add( выражение )

Добавляет в уже существующий набор дополнительные элементы, которые удовлетворяют указанному выражению.
Аргументы:

выражение Строка, Элемент DOM, Массив<Элементов DOM>
Выражение, код HTML для создания элементов на лету.
Примеры:

Поиск всех элементов div и установка им рамки красного цвета. Затем все параграфы добавляются в уже существующий объект jQuery и им устанавливается фон желтого цвета.

    $("div").css("border", "2px solid red")
            .add("p")
            .css("background", "yellow");
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
                    "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
  <script src="http://code.jquery.com/jquery-latest.js"></script>

  <script>
  $(document).ready(function(){

    $("div").css("border", "2px solid red")
            .add("p")
            .css("background", "yellow");

  });
  </script>

  <style>
  div { width:60px; height:60px; margin:10px; float:left; }
  p { clear:left; font-weight:bold; font-size:16px;
      color:blue; margin:0 10px; padding:2px; }
  </style>
</head>
<body>
  <div></div>
  <div></div>

  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <p>Added this... (notice no border)</p>

</body>
</html>
Добавляет в уже существующий набор дополнительные элементы, которые удовлетворяют указанному выражению.

$("p").add("span").css("background", "yellow");
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
                    "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
  <script src="http://code.jquery.com/jquery-latest.js"></script>

  <script>
  $(document).ready(function(){
    $("p").add("span").css("background", "yellow");
  });
  </script>

</head>
<body>

  <p>Hello</p><span>Hello Again</span>
</body>
</html>
Добавляет в уже существующий набор дополнительные элементы, созданные на лету.
$("p").clone().add("<span>Again</span>").appendTo(document.body);
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
                    "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
  <script src="http://code.jquery.com/jquery-latest.js"></script>

  <script>

  $(document).ready(function(){
    $("p").clone().add("<span>Again</span>").appendTo(document.body);
  });
  </script>

</head>
<body>
  <p>Hello</p>
</body>
</html>
Добавляет в уже существующий набор один или более элемент(ов).
$("p").add(document.getElementById("a")).css("background", "yellow");
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
                    "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
  <script src="http://code.jquery.com/jquery-latest.js"></script>

  <script>

  $(document).ready(function(){
    $("p").add(document.getElementById("a")).css("background", "yellow");
  });
  </script>

</head>
<body>

  <p>Hello</p><span id="a">Hello Again</span>
</body>
</html>
Демонстрирует, как добавить элементы в существующую коллекцию.

var collection = $("p");
// capture the new collection
collection = collection.add(document.getElementById("a"));
collection.css("background", "yellow");
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
                    "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
  <script src="http://code.jquery.com/jquery-latest.js"></script>

  <script>

  $(document).ready(function(){
    var collection = $("p");
// capture the new collection
collection = collection.add(document.getElementById("a"));
collection.css("background", "yellow");
  });
  </script>

</head>
<body>

  <p>Hello</p><span id="a">Hello Again</span>
</body>
</html>
Name Type