Note: You are currently viewing documentation for Moodle 3.11. Up-to-date documentation for the latest stable version of Moodle may be available here: Iframe.

Iframe

From MoodleDocs

IFrame (Inline Frame) is piece of HTML code that creates a frame or window within an HTML page to display content from another URL.

In Moodle, it is a good way to display content such as:

  • calendars from external sites such as Google calendar, Microsoft Outlook web calendars, Apple Mobileme calendars etc.
  • web pages with current content: e.g. weather
  • content from network locations outside the current Moodle course e.g. another Moodle course, a network file of html page
  • content from sites which deliver content through iFrames such as Google Picasa web albums, YouTube etc.

NOTE: Screen widths are often 1200 pixels wide so an iFrame up to 1000 pixels is often fine.

The size of the IFrame can be specified in the surrounding HTML page, so that the surrounding page can already be presented in the browser while the IFrame is still being loaded. The IFrame behaves much like an inline image and the user can scroll it out of view. On the other hand, the IFrame can contain its own scroll bar, independent of the surrounding page's scroll bar.

For security reasons, moodle just does not allow you to use iframes everywhere. In general, iframe code is not allowed in Moodle activities to which all class members can contribute, including Assignment submissions, Wiki, Forum, Database, Glossary, and Blog activities. In these activities iframe-embedded video displays in the HTML editor, but will be stripped out when posts or submissions are saved.

Caution: not all browsers recognize IFrame. However, Mozilla Firefox, Opera and Microsoft Internet Explorer introduced contentEditable and designMode, which enables users to edit the contents of the HTML contained in an IFrame. Popular web applications which make use of this feature including Google Docs & Spreadsheets (formerly Writely), JotSpot Live, and Windows Live Hotmail to name a few.

Note: many websites do not allow their pages to be rendered in an iframe (This is mediated via a X-Frame-Options HTTP response header [1]).
There are websites (you can google this) that will check whether your target web address will allow iframe functionality.

Code example

To create an iframe,

  • edit a section header, label, web page or forum post
  • turn on the HTML code display
  • paste the following code somewhere
<iframe height="600" width="900" src="https://docs.moodle.org"> Your browser does not diplay iFrames</iframe>

The following example creates a scrollable window 300 by 600 pixtels and opens up Adobe Reader and the file inside it.

<iframe height="300" width="600" src="http://demo.moodle.org/file.php/2/Media_examples /WQ3.pdf"> Alternative text for browsers that do not understand IFrames </iframe>

Example use

Here is an example of how to insert a PDF file into an assignment using Iframe.

  1. Within your course, upload the PDF into your course files area
  2. Once you've done that click on the file and note its URL address in the browser address bar.
    1. Tip:copy the URL from the browser window, pop it into Notepad. Or open a second browser window and find the pdf file, copy the URL address from that window into the window you have open with the code.
  3. Create a new Assignment (Online Text)
  4. For the description, change the view to HTML view in the editor, and embed the HTML code for an iFrame that points to the PDF URL you noted in step 2.
  5. Change back to WYSIWYG mode and add your question underneath the newly displayed iframe
  6. Save, and that should now let your students view the scrollable PDF in the same window as the one they'll be entering their response into.

This produced:

Iframe example showing scroll bars in a student view

See also