101

I'm trying to detect when an iframe and its content have loaded but not having much luck. My application takes some input in text fields in the parent window and updates the iframe to provide a 'live preview'

I started with the following code (YUI) to detect when the iframe load event occurs.

$E.on('preview-pane', 'load', function(){
    previewBody = $('preview-pane').contentWindow.document.getElementsByTagName('body')[0];
}

'preview-pane' is the ID of my iframe and I'm using YUI to attach the event handler. However, trying to access the body in my callback (upon iframe load) fails, I think because the iframe loads before the event handler is ready. This code works if I delay the iframe loading by making the php script that generates it sleep.

Basically, I'm asking what is the correct approach across browsers to detect when the iframe has loaded and its document is ready?

David Snabel-Caunt
  • 57,804
  • 13
  • 114
  • 132
  • 1
    Starting out with YUI is a bad idea (as well as any other JS library). Why? Because you just can't know what magic that library is doing. If they can't support "load" fully, you'd better do it yourself in clear and readable javascript. – Christian May 24 '11 at 08:22
  • 2
    You can often read the source code of the library @Christian . I find this usually gives you great tips on how to do it yourself regardless of whether you then use their implementation or not. – AJP Mar 06 '13 at 14:07
  • @AJP You misunderstood my point. If you're doing something you're not sure of, it's better to have less code so there's less room for errors. – Christian Mar 06 '13 at 17:43
  • 2
    Depends on how you look at it. I knew that YUI's event handling worked at the time, so I didn't have to worry about that part of the code. I also knew how to write my own addEvent handler, not that it worked any better than YUI with regard to this problem. – David Snabel-Caunt Mar 06 '13 at 18:17
  • Seems ironic that jQuery isn't mentioned anywhere, even though the question and the second most voted answer talk just about jQuery. Shouldn't the tag be present? – Nico Feb 26 '14 at 11:08
  • 1
    @Nico The question refers to YUI and $ is an alias to YUI's Dom wrapper. – David Snabel-Caunt Feb 26 '14 at 11:10
  • Excuse me, it just seemed so similar... And last question is pure jQuery – Nico Feb 26 '14 at 13:22

6 Answers6

80

to detect when the iframe has loaded and its document is ready?

It's ideal if you can get the iframe to tell you itself from a script inside the frame. For example it could call a parent function directly to tell it it's ready. Care is always required with cross-frame code execution as things can happen in an order you don't expect. Another alternative is to set ‘var isready= true;’ in its own scope, and have the parent script sniff for ‘contentWindow.isready’ (and add the onload handler if not).

If for some reason it's not practical to have the iframe document co-operate, you've got the traditional load-race problem, namely that even if the elements are right next to each other:

<img id="x" ... />
<script type="text/javascript">
    document.getElementById('x').onload= function() {
        ...
    };
</script>

there is no guarantee that the item won't already have loaded by the time the script executes.

The ways out of load-races are:

  1. on IE, you can use the ‘readyState’ property to see if something's already loaded;

  2. if having the item available only with JavaScript enabled is acceptable, you can create it dynamically, setting the ‘onload’ event function before setting source and appending to the page. In this case it cannot be loaded before the callback is set;

  3. the old-school way of including it in the markup:

    <img onload="callback(this)" ... />

Inline ‘onsomething’ handlers in HTML are almost always the wrong thing and to be avoided, but in this case sometimes it's the least bad option.

alex
  • 479,566
  • 201
  • 878
  • 984
bobince
  • 528,062
  • 107
  • 651
  • 834
  • Thanks. My solution checks the readyState (if exists), then the body elements innerHTML length to see if it has loaded. If not, attaches the load event handler. Seems to work ok – David Snabel-Caunt Apr 15 '09 at 15:12
  • 9
    -1 - inline events are not "bad", that's just the current fad. In fact, inline events are easier to debug and understand, unlike their magic counterparts (which, on the other hand, are easier to attach, stack and use seamlessly). – Christian May 24 '11 at 08:24
  • 1
    @Christian, inline events are also the best option when you need to attach an event to every element of a very long list. Since you're already looping to build the list on the server side, it's much more efficient to attach the inline-event as well. – haknick Aug 19 '11 at 23:08
  • 18
    @haknick Wouldn't you want to use a single event listener on the list, and use an event delegate? *This* would be more efficient. – David Snabel-Caunt Dec 07 '11 at 10:47
  • This solution works: http://stackoverflow.com/a/11874986/1260020 If you want to use clean javascript go for the interval solution and inside the interval access iframe's content using one of the methods mentioned in the same thread. – simo Aug 31 '12 at 15:56
  • 4
    This would not work if the iframe is cross-domain. The script inside iframe cannot access parent window. – Sudheer Someshwara Jul 08 '13 at 15:11
49

See this blog post. It uses jQuery, but it should help you even if you are not using it.

Basically you add this to your document.ready()

$('iframe').load(function() {
    RunAfterIFrameLoaded();
});
Mark Amery
  • 143,130
  • 81
  • 406
  • 459
kgiannakakis
  • 103,016
  • 27
  • 158
  • 194
14

For those using React, detecting a same-origin iframe load event is as simple as setting onLoad event listener on iframe element.

<iframe src={'path-to-iframe-source'} onLoad={this.loadListener} frameBorder={0} />

Farzad Yousefzadeh
  • 2,461
  • 1
  • 20
  • 27
3

For anyone using Ember, this should work as expected:

<iframe onLoad={{action 'actionName'}}  frameborder='0' src={{iframeSrc}} />
Max Wallace
  • 3,609
  • 31
  • 42
1
  1. This code detects when iframe content has loaded Without jquery:

Credit Biranchi's answer

    // wait for the doc to load (wait for the class 'iframe...' to load) before sending the script
    checkIframeLoaded()
    
    function checkIframeLoaded() {
        // console.log(" function checked")
        // Get a handle to the iframe element
        var iframe = document.getElementsByClassName("docs-texteventtarget-iframe")[0];
        console.log("iframe", iframe)
        // check if the iframe is loaded or not (= undefined = null)
        if (iframe == null) {
            // If we are here, it is not loaded. Set things up so we check the status again in 1000 milliseconds
            window.setTimeout(checkIframeLoaded, 1000);
        } else {
            var iframeDoc = iframe.contentDocument || iframe.contentWindow.document;
            // Check if loading is completed
            if (iframeDoc.readyState == 'complete') {
    
                // The loading is complete, call the function we want executed once the iframe is loaded
                iframeDoc.addEventListener("keydown", dispatchkeyboard, false);
            } else {
                // even if the iframe is loaded the "readystate may not be completed yet" so we need to recall the function.
                window.setTimeout(checkIframeLoaded, 1000);
            }
        }
    }
    
  
  1. This code works with jquery:

Credit: gilles bousquet's answer

    // use jquery to detect when iframe is loaded but doesn't work offline
    // (this code needs jQuery because it use the "$" below). if you use it; add this require in the ===usercript=== section
    //  @require    http://ajax.googleapis.com/ajax/libs/jquery/1/jquery.min.js

    var editingIFrame = $('iframe.docs-texteventtarget-iframe')[0];
   if (editingIFrame) {
        console.log("inside doc.getele")
        editingIFrame.contentDocument.addEventListener("keydown", dispatchkeyboard, false);
    }
    
JinSnow
  • 1,553
  • 4
  • 27
  • 49
0
jQuery(document).ready(function () {
    jQuery('iframe').load(function() {
        console.log(jQuery(this))
    });
})
Mahdi Bashirpour
  • 17,147
  • 12
  • 117
  • 144