FRAMESET | NN n/a IE 4 DOM 1 | ||
The FRAMESET object reflects the FRAMESET element. While Navigator knows about framesets as objects, it treats a frameset like any other window object. Internet Explorer 3 and later also observe this behavior. Therefore, for cross-platform access to FRAMESET properties and methods, see the window object listing in this chapter. But if you need access to the properties listed in this section, you must access the FRAMESET object via its frameset ID. Be aware that references to frameset objects shown in this section may not work properly in the Windows 95 version of Internet Explorer 4. Also, the windowRef placeholder may be filled with parent or top if the reference is in a script contained by a child frame. | |||
HTML Equivalent<FRAMESET> | |||
Object Model Reference
|
border | NN n/a IE 4 DOM n/a | ||
Read/Write | |||
Thickness of the spaces between frames in a frameset in pixels. Only the outermost FRAMESET element of a system of nested framesets responds to the border property setting. Internet Explorer 4 treats the default thicknesses for Windows and Macintosh differently, so be aware that the same value may look different on each operating system platform. | |||
Exampletop.document.all.myFrameset.border = 4 | |||
Value An integer value. A setting of zero eliminates the border entirely. While the value is supposed to represent the precise pixel thickness of borders in the frameset, this is not entirely true for all operating systems or browsers. | |||
|
borderColor | NN n/a IE 4 DOM n/a | ||
Read/Write | |||
Color of borders between frames of the frameset. The borderColor property of an individual frame overrides the FRAMESET object's setting | |||
Exampleparent.document.all.myFrameset.borderColor = "salmon" | |||
Value A hexadecimal triplet or plain-language color name. A setting of empty is interpreted as "#000000" (black). |
|||
|
cols | NN n/a IE 4 DOM 1 | ||
Read/Write | |||
Defines the sizes or proportions of the column arrangement of frames in a frameset. Column size is defined in one of three ways: An absolute pixel size A percentage of the width available for the entire frameset A wildcard (*) to represent all available remaining space after other pixels and percentages have been accounted for Exercise extreme care when scripting a change to this property. Altering the composition of a frameset on the fly might disrupt scripts that communicate across frames. Reducing the number of columns may destroy documents whose scripts or objects support scripts in other frames or the parent. It is safest to maintain the same number of columns, but use this property to adjust the widths of existing frame columns. | |||
Exampleparent.document.all.framesetter.cols = "40%,60%" | |||
Value Comma-separated list (as a string) of pixel, percentage, or wildcard (*) values. Internet Explorer 4 for the Macintosh exhibits incorrect behavior with some combinations that include a wildcard value. | |||
|
frameBorder | NN n/a IE 4 DOM n/a | ||
Read/Write | |||
Controls whether the frameset displays borders between frames. Adjusting this property does not dynamically change the border visibility in Internet Explorer 4. | |||
Exampleparent.document.all.framesetter.frameBorder = "no" | |||
Value Internet Explorer 4 accepts the string values of 1 (on) and 0 (off) as well as yes and no. | |||
|
frameSpacing | NN n/a IE 4 DOM n/a | ||
Read/Write | |||
The amount of spacing in pixels between frames within a frameset. | |||
Exampleparent.document.all.framesetter.frameSpacing = 5 | |||
Value Integer. | |||
|
rows | NN n/a IE 4 DOM 1 | ||
Read/Write | |||
The sizes or proportions of the row arrangement of frames in a frameset. See the cols property for additional details of selecting values for the rows property. | |||
Exampledocument.all.myFrameset.rows = "20%, 300, *" | |||
Value String of comma-delimited list of pixel or percentage values, or the * wildcard character. | |||
|