Skip to main content

Embedding Responsive iframes in your Drupal site

Implementing iframe elements can be troublesome for both content editors and developers, that's even before trying to make them responsive. After some recent project work I'm here to tell you there is an easy way to handle them.

by nick.schuch /

Components

Responsive child page

For this project the child page was themed so it was already responsive and fit the entire width of the page so it would work with any iframe size.

The initial setup is straight forward:

  1. Download Link iframe formatter module and enable.
  2. Assign a link field to a content type so the content editor doesn't have to worry about markup.
  3. Setup the display of the link field to "Link iframe formatter"

We now have the initial ground work complete. Now comes the fun part, making the iframe responsive.

Responsive iframes libraray

For our recent project we chose the Responsive iframes library. It's simple (the code can be read through in about 5min) and initial implementation is very simple.

  1. <!-- Activate responsiveness in the "child" page -->
  2. <scriptsrc="/js/jquery.responsiveiframe.js"></script>
  3. <script>
  4. var ri = responsiveIframe();
  5. ri.allowResponsiveEmbedding();
  6. </script>
  7. <!-- Corresponding code in the "parent" page -->
  8. <scriptsrc="/js/jquery.js"></script>
  9. <scriptsrc="/js/jquery.responsiveiframe.js"></script>
  10. <script>
  11. ;(function($){
  12. $(function(){
  13. $('#myIframeID').responsiveIframe({ xdomain:'*'});
  14. });
  15. })(jQuery);
  16. </script>

Note: The above was taken from the Responsive iframe project page.

Issues we had to overcome

Page elements updating

Responsive iframe library triggers a resize when the screen size changes. With this in mind we ran into an issue where the child (the page we are displaying in the iframe) would have elements update and add additional height, causing elements to disappear in the borders of the iframe. After reading through the library and some googling I ended up with the following solution. The following is javascript that is added to the child page. It watches for changes in the DOM and sends notifications to the parent.

// When fields are updated (invalid content).
$('form').bind('DOMNodeInserted DOMSubtreeModified DOMNodeRemoved', function(event) {
  ri.messageParent();
})

Disable scrolling to top of page

By default, if the iframe size updates the parent page scrolls to the top, we don't want that. After reading through the code I was able to use the following as a solution on the parents end:

$("#myIframeID").responsiveIframe({ scrollToTop: false });

Note: This is an update to the existing javascript.

How to determine if the child page is in an iframe

We had a requirement to set some css for the child iframe. In this case we only wanted to set the style when the child was in the iframe. Since we cannot set css from the parent, we came up with the following solution.

if (window.self != window.top) {
  $("html").css('overflow' , 'hidden');
}

Conclusion

Here are some simple elements that ended up making the project work a success. Please let me know approaches you have taken in the comments below.