Click here to Skip to main content
15,742,655 members
Articles / Programming Languages / Javascript
Tip/Trick
Posted 2 Sep 2013

Stats

221.1K views
19 bookmarked

JavaScript's $(document).ready vs. $(window).load

Rate me:
Please Sign up or sign in to vote.
4.38/5 (10 votes)
16 Sep 2013CPOL2 min read
A most common event

Introduction

A common question on (web) programming forums for beginners, you can find the "How do I perform various actions as soon as the page loads on the client side in JavaScript?"

These questions will mostly be answered by either "Use document.ready" or "Use window.load" sporadically.

It is quite common that people need to attach some actions to the Page_Load event on the client side. However there are two main functions that I frequently see mixed with each other when served to the beginning programmer, confusing when to use which.

Misusing document.ready and window.load can at times be irrelevant but on other occasions may prove critically wrong programming, especially when UI manipulation is crucial!

document.ready (jQuery)

document.ready will execute right after the HTML document is loaded property, and the DOM is ready.

DOM: The Document Object Model (DOM) is a cross-platform and language-independent convention for representing and interacting with objects in HTML, XHTML and XML documents.

JavaScript
$(document).ready(function()
{
   // executes when HTML-Document is loaded and DOM is ready
   alert("(document).ready was called - document is ready!");
});

document.ready (a jQuery event) will fire when all the elements are in place, and they can be referenced in the JS code, but the content is not necessarily loaded.

 Warning - If you want to use the Height, Width properties of an image for example, then document.ready is a deal braker!!

JavaScript
// Another interesting approach for this event:
document.observe("dom:loaded", function() 
{
   // do_stuff();
});

* See more on document.observe on prototypejs.org

window.load (Built-in JavaScript)

The window.load however will wait for the page to be fully loaded, this includes inner frames, images etc.

JavaScript
$(window).load(function() 
{
   // executes when complete page is fully loaded, including all frames, objects and images
   alert("(window).load was called - window is loaded!");
});  

* window.load is a built-in JavaScript method, it is known to have some quirks in old browsers (IE6, IE8, old FF and Opera versions) but will generally work in all of them.

window.load can be used in the body's onload event like this (but I would strongly suggest you avoid mixing code like this in the HTML, as it is a source for confusion later on):

HTML
<html>

 <head>

  <script>
   function foo()
   {
    alert("Page loaded!");
   }
  </script>

 </head>

 <body onload="foo()">
  <h1>I didn't do it!</h1>
 </body>

</html> 

 Warning - Do not confuse the load method of the window element with the jQuery AJAX's load method!!!

JavaScript
// This is the AJAX load
$("#MyDivID").load("content_page.txt"); 

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Chief Technology Officer
United States United States
Senior dish washing consultant for over 25 years!

Comments and Discussions

 
QuestionA better one ...you can find below Pin
KK Kod6-May-15 6:06
KK Kod6-May-15 6:06 

[Please see a better explanation Here]

A good Try man ..
Keep it up ..but the article is a bit confusing.
AnswerRe: A better one ...you can find below Pin
Member 140750622-Dec-18 17:47
Member 140750622-Dec-18 17:47 
GeneralMy vote of 1 Pin
KK Kod6-May-15 6:02
KK Kod6-May-15 6:02 
Generalmy vote 5 Pin
Paulo Augusto Kunzel21-Oct-13 0:14
professionalPaulo Augusto Kunzel21-Oct-13 0:14 
GeneralRe: my vote 5 Pin
Joezer BH21-Oct-13 1:23
professionalJoezer BH21-Oct-13 1:23 
GeneralMy vote of 5 Pin
Carsten V2.016-Sep-13 6:10
Carsten V2.016-Sep-13 6:10 
GeneralRe: My vote of 5 Pin
Joezer BH16-Sep-13 20:23
professionalJoezer BH16-Sep-13 20:23 
SuggestionAlternative... Pin
Nitij16-Sep-13 5:02
professionalNitij16-Sep-13 5:02 
NewsRe: Alternative... Pin
Joezer BH16-Sep-13 20:27
professionalJoezer BH16-Sep-13 20:27 
GeneralRe: Alternative... Pin
Nitij16-Sep-13 21:11
professionalNitij16-Sep-13 21:11 
GeneralMy vote of 4 Pin
Dholakiya Ankit2-Sep-13 23:10
Dholakiya Ankit2-Sep-13 23:10 
GeneralRe: My vote of 4 Pin
Joezer BH3-Sep-13 3:33
professionalJoezer BH3-Sep-13 3:33 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.