Функция jQuery

Материал из JQuery

Перейти к: навигация, поиск
jQuery() или $()

Функция jQuery() является, пожалуй основной функцией в библиотеке. Она обычно, вызывается намного чаще других и поэтому для нее существует короткая форма записи — $(). Функция jQuery() позволяет производить поиск элементов на странице, создавать новые элементы по заданному HTML тексту, а так же кое что еще. Возвращает объект jQuery. Существует довольно много вариантов использования функции:

$(condition):jQuery1.0, 1.4
возвращает объект jQuery, представляющий группу элементов, найденных на странице по заданным условиям:
$(selector[, context]) — условия заданы с помощью селектора selector и области поиска context (если она не задана, то областью поиска будет весь документ), которая может быть задана DOM-элементом, jQuery-объектом или объектом документа.(метод добавлен в jQuery-1.0)
$(element|elementArray) — задав DOM-элемент или массив DOM-элементов, вы получите jQuery-объект, который их представляет. (метод добавлен в jQuery-1.0)
$(jQuery object) — задав другой jQuery-объект вы получите его клон. (метод добавлен в jQuery-1.0)
$() — не задав ничего вы получите пустой jQuery-объект. (метод добавлен в jQuery-1.4)
$(htmlText):jQuery1.0, 1.4
возвращает объект jQuery, представляющий элементы заданные html-текстом.
$(html[, ownerDocument]) — в дополнении к html-тексту можно указать объект документа ownerDocument, в который планируется поместить элементы, заданные этим текстом. (метод добавлен в jQuery-1.0)
$(html, props) — если html описывает только один элемент (например, только один параграф <p>), то вторым параметром можно задать ему атрибуты и/или события. Задавать их нужно в виде javascript-объекта, например: $("<p></p>", {"class":"blocks", "onClick":"functName"}). (метод добавлен в jQuery-1.4)
$(callback):jQuery1.0
вызывает функцию callback, когда объектная модель документа (DOM) становится окончательно готовой. Аналог $(document).ready().

Несмотря на то, что функция $() имеет большое количество назначений, самым распространенным является поиск элементов на странице:

Примеры поиска элементов страницы:

$("div") вернет все div-элементы на странице.
$(".someBlock") вернет все элементы с классом someBlock.
$("#content") вернет элемент с идентификатором content.
$("#content2 div.someBlock") вернет div-элементы с классом someBlock, которые находятся внутри элемента с идентификатором content2.
$("div:odd") вернет элементы, находящиеся на странице под нечетными номерами.
$("#content2 div.someBlock") вернет div-элементы с классом someBlock, которые находятся внутри элемента с идентификатором content2.
$("[value = 5]") вернет все элементы с атрибутом value, равным 5.
$("div", document) вернет все div-элементы внутри основного документа.
$("div", frames[0].document) вернет все div-элементы внутри первого фрейма на странице.
$("div", $(".block")) вернет все div-элементы, находящиеся внутри элементов с классом block (обычно, для этого лучше подойдет конструкция $(".block div")).

Примеры различного использования функции $():

//Зададим функцию, которая будет выполнена в момент готовности объектной модели документа
$(function(){
  //Получим объект jQuery представляющий div-элементы на странице
  jqElements = $("div");
 
  //Получим DOM-объект первого div-элемента
  domElement = elements.get(0);
 
  //по имеющимуся объекту DOM создадим объект jQuery, который его представляет
  jqElement = $(domElement);
 
  //Создадим объект jQuery по html-тексту
  newElement = $("<p>Новый-преновый параграф</p>");
 
  //Поместим новый элемент в конец первого div-элемента на странице
  jqElement.append(newElement);
});

Ссылки

Поисковые ключи:
  • функция jquery() (или ее псевдоним $())
  • jquery()