ready()

ready( handler )

מחזירה: jQuery

תיאור: מציין פונקציה, שתתבצע כשה מסמך נטען במלוא.

.ready( handler )

הוספה בגרסה: 1.0

handler

פונקציה לביצוע אחרי שמסמך נטען.

לעומת ש- JavaScript מספקת אירוע load עבור הפעלת קוד, כאשר דף מוצג, אירוע הזה לא יופעל עד שכל האובייקטים, כמו למשל, תמונות לא יטענו עד הסוף. ברוב המקריים, סקריפט הזה ניתן להפעלה מייד אחרי שהיררכיה של DOM בנויה סופית. מטפל שנשלח ל- .ready() יבוצע בביטחון אחרי ש- DOM מוכן, לכן, בדרך כלל זה מקום הכי טוב, כדי לצרף מטפלי אירוע אחרים ולהפעיל קוד אחר של jQuery. אם אתם משתמשים בסקריפטים, שתלויים בערכי מאפיינים של CSS, חשוב מאוד לציין קישורים לטבלאות חיצוניים של סגנונות או לשים אלמנטים של סגנון לפני קישור לסקריפט.

במקריים, כאשר קוד תלוי באובייקטים שנטענים (לדוגמה, אם דרוש גודל התמונה), יש לשים קוד במטפל עבור אירוע load.

שיטה .ready() בדרך כלל לא תואמת לתכונה <body onload="">. אם load צריך להיות מופעל, או שלא תשתמשו ב- .ready() או תשתמשו בשיטה jQuery .load() עבור צירוף מטפל אירוע load לחלון או אובייקטים מסוימיים, כמו למשל תמונה.

כל שלושת משפטיים הבאים שקולים:

$(document).ready(handler)
$().ready(handler) (לא מומלץ להשתמש)
$(handler)

קיים גם $(document).bind("ready", handler). שיטה זו עובדת בדומה לשיטה ready, אבל עם חריגה אחת: אם אירוע ready כבר מופעל, ואתם מנסים .bind("ready"), מטפל הזה לא יתבצע.

שיטה .ready() ניתן להפעיל רק עבור אובייקט jQuery שתואם למסמך נוכחי, אז סלקטור יכול להיות מושמט.

שיטה .ready() בדרך כלל משתמש עם פונקציה אנונימית:

$(document).ready(function() {
  // Handler for .ready() called.
});

אם .ready() מופעל אחרי אתחול של DOM, מטפל חדש שנשלח יופעל מייד.

כינוי jQuery

כאשר משתמשים בסיפריה JavaScript אחרת, היינו רוצים לקרוא ל- jQuery.noConflict() כדי למנוע התנגדות שמות. כאשר מופעלת פונקציה הזאת, קיצור $ לא נגיש יותר, מכריח אותנו לכתוב jQuery כל פעם, כאשר בדרך כלל כתבנו $. עם זאת, מטפל שנשלח לשיטה .ready() יכול לקבל ארגומנט, ששולח אובייקט גלובלי jQuery. זה אומר, שאנחנו יכולים לשנות שם האובייקט בתוך התוכן של מטפל שלנו .ready() בלי להשפיע על קוד אחר:

jQuery(document).ready(function($) {
    // קוד המשמש בדרך כלל $ נמצא כאן
});

דוגמאות

דוגמה 1

מציג הודעה כשה DOM מוכן

$(document).ready(function () {
    $("p").text("The DOM is now loaded and can be manipulated.");
});

תוצאת הפעלה קוד לעיל:

נסה זאת בעצמך

קוד מלא:

<!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 type="text/javascript" language="javascript">

$(document).ready(function () {
    $("p").text("The DOM is now loaded and can be manipulated.");
  });
  </script>
  <style>p { color:red; }</style>

</head>
<body>
  <p></p>
</body>
</html>

נסה זאת בעצמך

דוגמה 2

קוד מופעל כשה DOM נטען

$(document).ready(function(){
  // Your code here...
});

דוגמה 3

שימוש ב- $(document).ready() ובכינוי $ כדי לכתוב קוד jQuery ללא כשל, בלי שימוש בכינויים גלובליים:

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

דוגמה 4

בדרך כלל נכתב ככה:

$(function() {
  // Your code here...
});

האם מידע זה היה מועיל?

כן לא