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