JavaScript and Frames, Part I: Escaping Frames - | WebReference

JavaScript and Frames, Part I: Escaping Frames -

JavaScript and Frames, Part I (2)

Escaping Frames

When you create a Web page, you expect the user to load it in the browser's main window. You don't want it to be loaded in another site's frame. By adding a simple cross-browser, cross-platform script into the HEAD portion of your document, you can ensure that the page loads in the entire window. Here's the script:

if (window != top) top.location.href = location.href;
// -->

The condition evaluates to true only if window is not equal to top. In other words, if the page's direct window isn't the topmost window in the browser, the condition evaluates to true.

top is the highest window object in the hierarchy. If the topmost page doesn't feature any frames, the object model has only one level of window objects, so top is equal to window. However, if the browser is currently displaying a frame-based document, each child frame has a corresponding window object.

Note that the following expressions would also function properly:

window != parent
self != top

Back to the script. If the page's window isn't the topmost window in the object model, your page is being displayed as a frame in a frame-setting document. In order to escape the frames, you need to set the URL of the upper window to the URL of the current page:

if (window != top) top.location.href = location.href;

Produced by Yehuda Shiran and Tomer Shiran

Created: March 1, 1999
Revised: March 1, 1999