jQuery


« Обратно на страницу Ядро jQuery

jQuery(выражение, [контекст] )

Эта функция принимает строку, содержащую CSS селектор, которая затем используется для поиска соответствующих элементов. Вся функциональность jQuery сосредоточена вокруг данной функции. В самом элементарном случае использования этой функции происходит передача выражения (обычно состоящего из CSS), которое потом используется для поиска всех элементов соответствующих выражению.

По умолчанию, если не указано никакого контекста, $() ищет элементы DOM в контексте текущего HTML документа. Если Вы все же указываете контекст (например элемент DOM или объект jQuery), то выражение будет сравниваться с его содержимым.

Для того, чтобы ознакомиться с допустимым синтаксисом выражений, обратитесь к главе Селекторы.

Аргументы:

выражение Строка

Выражение для поиска.
контекст (необязательно) Элемент, jQuery

Элемент DOM, документ или объект jQuery для использования в качестве контекста.
Примеры:

Поиск всех дочерних элементов «p» элемента div. 

$("div > p").css("border", "1px solid gray");
<!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 > p").css("border", "1px solid gray");
  });
  </script>

</head>
<body>
  <p>one</p> <div><p>two</p></div> <p>three</p>

</body>
</html>
Поиск всех элементов типа radio в пределах первой формы в документе.

$("input:radio", document.forms[0]);
Поиск всех элементов div в документе XML, который получен в качестве ответа от AJAX.
$("div", xml.responseXML);
Name Type


jQuery( html, [документ] )

На лету создает элементы DOM из предоставленной строки чистого HTML.

Простые элементы, такие как «<div/>», создаются посредством document.createElement. Все остальные случаи обрабатываются путем присоединения строки к свойству .innerHTML элемента div. Строка HTML не может содержать недопустимые в составе div элементы, такие как html, head, body а также элементы заголовков (title).

Аргументы:
html Строка

Строка HTML кода для создания элементов на лету. Примечание: это относится к HTML, но никак не к XML.
документ (необязательно) документ

Документ, в котором будут созданы новые элементы.
Примеры:

Динамическое создание элемента div со всем его содержимым и присоединение его к телу документа HTML (body). Создается элемент и его свойство innerHTML устанавливается в соответствии с заданной разметкой. Достаточно гибко.

$("<div><p>Hello</p></div>").appendTo("body")
Name Type

jQuery( элементы )

Использование функциональности jQuery для одного или нескольких элемента(ов) DOM.

Эта функция получает XML документы и объекты Window как действительные аргументы, хотя на самом деле они не являются элементами DOM.

Может приниматься и другой объект jQuery, фактически возвращаемый $(other.get()).
Аргументы:
элементы Элемент, Массив элементов

Элементы DOM, которые будут включены в объект jQuery.
Примеры

Изменяет цвет фона страницы на черный.

$(document.body).css( "background", "black" );

Скрывает все элементы ввода в пределах формы.

$(myForm.elements).hide()
Name Type

jQuery( вызов )

Сокращение для $(document).ready().

Позволяет Вам указать функцию, которая будет выполнена в момент окончания загрузки документа DOM. Данная функция ведет себя также как и $(document).ready(), поэтому следовало бы её использовать для обработки других операций на Вашей странице, которые зависят от готовности документа DOM.

У Вас может быть сколько угодно событий $(document).ready в документе. Обратитесь к разделу ready(Функция) для более детальной информации о событии готовности.

Аргументы:

вызов Функция

Функция, выполняемая когда документ DOM загружен.
Примеры:

Выполняет функцию, когда документ DOM готов к использованию.

$(function(){
  // Document is ready
});
Использование как $(document).ready(), так и аргумента для написания отказоустойчивого кода jQuery при помощи псевдонима $, не полагаясь на глобальный псевдоним.

jQuery(function($) {
  // Your code using failsafe $ alias here...
});
Name Type

Взято с «http://docs.jquery.com/Core/jQuery«