 | JavaScript | |||
|---|---|---|---|---|
| Prev | Home | Up | Next |
| Availability: |
| |||||||
| Inherits from: | Window object | |||||||
| JavaScript syntax: | - | myFrame = frame | ||||||
| - | myFrame = frames[anIndex] | |||||||
| IE | myFrame = myDocument.all.aFrameID | |||||||
| IE | myFrame = myDocument.all.tags("FRAME")[anIndex] | |||||||
| IE | myFrame = myDocument.all[aName] | |||||||
| - | myFrame = myDocument.getElementById(anElementID) | |||||||
| - | myFrame = myDocument.getElementsByName(aName)[anIndex] | |||||||
| - | myFrame = myDocument.getElementsByTagName("FRAME")[anIndex] | |||||||
| IE | myFrame = myDocument.parentWindow | |||||||
| - | myFrame = myFrameArray[anIndex] | |||||||
| - | myFrame = parent | |||||||
| - | myFrame = self | |||||||
| - | myFrame = top | |||||||
| - | myFrame = window | |||||||
| HTML syntax: | <FRAME> | |||||||
| Argument list: | anIndex | A reference to an element in a collection | ||||||
| aName | An associative array reference | |||||||
| anElementID | The ID value of an Element object | |||||||
| Object properties: | borderColor, className, dataFld, dataSrc, defaultStatus, frameBorder, height, isTextEdit, lang, language, longDesc, marginHeight, marginWidth, name, noResize, parent, parentElement, parentTextEdit, scrolling, sourceIndex, src, style, tagName, title, top | |||||||
| Object methods: | close(), contains(), getAttribute(), removeAttribute(), setAttribute() | |||||||
| Event handlers: | onAfterPrint, onBeforePrint, onBeforeUnload, onBlur, onDragDrop, onError, onFocus, onHelp, onLoad, onMouseMove, onMove, onResize, onScroll, onUnload | |||||||
| Collections: | all[], attributes[], children[] | |||||||
The methods and properties of a frame are the same as those for a window object.
Note that MSIE supports a FRAME object as opposed to a Frame object for the management of frames within a frame-set.
DOM level 2 adds the following properties:
contentDocument
Be aware that if you store a reference to a frame object and the frame is closed, if you don't dispose of the reference to the frame object then it cannot be garbage collected. A frame object with no associated frame is not much use unless you need to keep the object persistent due to having added some properties to it. If this is the case, then arguably the frame object was the wrong place to put such things.
| Property | JavaScript | JScript | N | IE | Opera | NES | ECMA | DOM | CSS | HTML | Notes |
|---|---|---|---|---|---|---|---|---|---|---|---|
| borderColor |  | 3.0  | | 4.0 | | | | | | | - |
| className | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | |  |
| dataFld | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| dataSrc | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| defaultStatus | 1.0 | 1.0 | 2.0 | 3.02 | | | | | | | - |
| frameBorder | 1.5 | 3.0 | 6.0 | 4.0 | | | | 1 | | | - |
| height | | 3.0 | | 4.0 | | | | | | | |
| isTextEdit | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| lang | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| language | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| longDesc | 1.5 | | 6.0 | | | | | 1 | | | - |
| marginHeight | 1.5 | 3.0 | 6.0 | 4.0 | | | | 1 | | | - |
| marginWidth | 1.5 | 3.0 | 6.0 | 4.0 | | | | 1 | | | - |
| name | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | - |
| noResize | 1.5 | 3.0 | 6.0 | 4.0 | | | | 1 | | | - |
| parent | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | | | | - |
| parentElement | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| parentTextEdit | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| scrolling | 1.5 | 3.0 | 2.0 | 3.0 | | | | 1 | | | |
| sourceIndex | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| src | 1.5 | 3.0 | 2.0 | 3.0 | | | | 1 | | | - |
| style | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| tagName | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| title | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| top | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | | | | readonly |
| Method | JavaScript | JScript | N | IE | Opera | NES | ECMA | DOM | CSS | HTML | Notes |
|---|---|---|---|---|---|---|---|---|---|---|---|
| close() | 1.0 | 1.0 | 2.0 | 3.02 | | | | | | | |
| contains() | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| getAttribute() | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| removeAttribute() | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| setAttribute() | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| Event name | JavaScript | JScript | N | IE | Opera | NES | ECMA | DOM | CSS | HTML | Notes |
|---|---|---|---|---|---|---|---|---|---|---|---|
| onAfterPrint | | 5.0 | | 5.0 | | | | | | | - |
| onBeforePrint | | 5.0 | | 5.0 | | | | | | | - |
| onBeforeUnload | | 3.0 | | 4.0 | | | | | | | - |
| onBlur | 1.1 | 3.0 | 3.0 | 4.0 | 3.0 | | | | | | |
| onDragDrop | 1.2 | | 4.0 | | | | | | | | - |
| onError | 1.1 | 3.0 | 3.0 | 4.0 | 3.0 | | | | | | |
| onFocus | 1.0 | 3.0 | 2.0 | 4.0 | 3.0 | | | | | | |
| onHelp | | 3.0 | | 4.0 | | | | | | | |
| onLoad | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | | | | |
| onMouseMove | 1.2 | 3.0 | 4.0 | 4.0 | | | | | | 4.0 | |
| onMove | 1.2 | | 4.0 | | | | | | | | - |
| onResize | 1.2 | 3.0 | 4.0 | 4.0 | | | | | | | |
| onScroll | | 3.0 | | 4.0 | | | | | | | - |
| onUnload | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | | | | |
| Prev | Home | Next |
| frame | Up | Frame.borderColor |
JavaScript Programmer's Reference, Cliff Wootton Wrox Press (www.wrox.com) Join the Wrox JavaScript forum at p2p.wrox.com Please report problems to support@wrox.com © 2001 Wrox Press. All Rights Reserved. Terms and conditions. | ||