[Функция] ready(fn)
Раздел "Events"
Данная функция позволяет связать выполнение определенной функции с моментом, когда документ DOM готов к использованию и манипуляции.
fn: выполняемая функция, когда структура DOM готова к использованию
function (eventObject) {
this; // элемент
}
Вероятно данная функция, одна из важнейших функций, включённых в модуль событий, так как функция весьма ускоряет время ответа вашего приложения.
В дальнейшем данная функция заменит событие window.onload, и присоединяемые к нему функции. При использовании данного метода, связанная функция будет вызвана немедленно после того как DOM будет готов для чтения и манипуляции, то есть тогда, когда 99.99% всего JavaScript кода необходимо запускать.
Функция содержит один аргумент передаваемый обработчику события ready: ссылка на jQuery функцию.
Вы можете назвать этот аргумент как угодно и вследствие этого применять $ псевдоним без риска конфликта имён. Вы можете использовать столько событий $(document).ready на вашей странице, сколько пожелаете.
Функция будет выполняться в том порядке, в котором вы её добавляли. Примечание: Пожалуйста, будьте уверены, что все ваши листы стилей подключены перед скриптами (особенно те которые используются данной функцией). Применяя данную функцию, будьте уверены, что все ваши стили загружены и готовы до того как код jQuery начнёт использоваться.
Пример:
Вывести сообщение, когда DOM структура загрузится.
"jQuery"
$(document).ready(function () {
$("p").text("DOM загружен и может быть использован.");
});
"Живой пример jQuery"
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<link href="http://test-drupal.ru/themes/slyweb/css/jqueryiframe.css"
rel="stylesheet" type="text/css"/>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.5.0/jquery.min.js"></script>
<script>
$(document).ready(function(){
$(document).ready(function () {
$("p").text("DOM загружен и может быть использован.");
});
});
</script>
</head>
<body class="iframe">
<p>
</p>
</body>
</html>
<style>
p { color:red; }
</style>
Пример:
Для выполнения кода, когда DOM структура загружаена, укажите следующее:
"jQuery"
$(document).ready(function(){
// Ваш код...
});
Пример:
Чтобы использовать оба - сокращение для $(document).ready() и аргумент устанавливающий ошибкоустойчивый код jQuery, использующий $ псевдоним, не полагаясь на глобальный псевдонимом, укажите:
"jQuery"
jQuery(function($) {
// Ваш код, использующий ошибкоустойчивый $ псевдоним...
});
Пример:
"jQuery"
$(function() {
// Ваш код...
});
Версия jQuery 1.4.2
Документ создан 2010-08-21
