<FRAMESET>...</FRAMESET>

Description

<Related pages>

	How do I load a page in another frame?
	Can I protect my pages from being framed by someone else?
	How can I maintain the layout of my frames?
	How can I change two or more pages when a link is clicked?

Container for creating a document that consists of several frames. This means that the page is constructed from more than one HTML document. A browser that supports frames will show each HTML document in its own frame (window).

A framed document has no BODY element because every frame shows the contents of a separate HTML page. Inside this element only the FRAMESET, FRAME and NOFRAMES elements are valid.

The FRAMESET element can be nested inside other FRAMESET elements. In this case the complete subframe is placed in the space that would be used for the corresponding frame if this had been a FRAME element instead of a nested FRAMESET.

It is possible to design a FRAMESET that will recurse infinitely stacking the same FRAMESET inside itself. Consider the following example:

 <FRAMESET rows="50%,50%">
  <FRAME src="parents_url">
  <FRAME>
 </FRAMESET>

This has been prevented. Any frame that attempts to assign its SRC url to be the same as the url of any of its ancestors will be treated as if it has no SRC url at all (basically a blank frame).

DTD

<![ %HTML.Frameset; [
<!ELEMENT FRAMESET - - ((FRAMESET|FRAME)+ & NOFRAMES?) -- window subdivision-->
<!ATTLIST FRAMESET
  %coreattrs;                          -- id, class, style, title --
  rows        %MultiLengths; #IMPLIED  -- list of lengths,
                                          default: 100% (1 row) --
  cols        %MultiLengths; #IMPLIED  -- list of lengths,
                                          default: 100% (1 col) --
  onload      %Script;       #IMPLIED  -- all the frames have been loaded  --
  onunload    %Script;       #IMPLIED  -- all the frames have been removed --
  >
]]>

Attributes

Core attributes: class id style title

BORDER
Give every frame a border of a number of pixels. This value can only be set in the outermost frameset.

BORDERCOLOR
Give the border of the frame a color. Because frame borders are shared, the browser must resolve any border color conflicts.

Any attribute appearing in the outermost FRAMESET has the lowest priority.
This attribute is overridden by any attribute used in a nested FRAMESET element.
Finally, any BORDERCOLOR attribute in the current FRAME element overrides all previous FRAMESET element uses.

If there is a conflict for two colors of equal priority both set on the same edge, the behavior is undefined.

COLS
This attribute determines the number of columns the frameset should have. A frameset can have the COLS attribute or the ROWS attribute, but not both.
The attribute takes as its value a comma separated list of values. These values can be absolute pixel values, percentage values between 1 and 100, or relative scaling values. The number of columns is implicit in the number of elements in the list. Since the total width of all the columns must equal the width of the window, column widths might be normalized to achieve this. A missing COLS attribute is interpreted as a single column arbitrarily sized to fit.

Syntax of value list :

value: A simple numeric value is assumed to be a fixed size in pixels. This is the most dangerous type of value to use since the size of the viewer's window can and does vary substantially. If fixed pixel values are used, it will almost certainly be necessary to mix them with one or more of the relative size values described below. Otherwise the client engine will likely override your specified pixel value to ensure that the total proportions of the frame are 100% of the width and height of the user's window.
value%: This is a simple percentage value between 1 and 100. If the total is greater than 100 all percentages are scaled down. If the total is less than 100, and relative-sized frames exist, extra space will be given to them. If there are no relative-sized frames, all percentages will be scaled up to match a total of 100%.
value*: The value on this field is optional. A single '*' character is a "relative-sized" frame and is interpreted as a request to give the frame all remaining space. If there exist multiple relative-sized frames, the remaining space is divided evenly among them. If there is a value in front of the '*', that frame gets that much more relative space. "2*,*" would give 2/3 of the space to the first frame, and 1/3 to the second.

FRAMEBORDER
Provides the option to display or not display a border for included frames. Possible values are YES and NO.

FRAMESPACING
Creates additional space between frames. The value specifies a border of the supplied number of pixels around the frame.

ONBLUR
Specifies JavaScript code to execute when the window containing the frameset loses focus. This means that it will be executed when you change the active window to another window than the one which contains the frameset.

ONFOCUS
Specifies JavaScript code to execute when the window containing the frameset gets focus. This means that it will be executed when you change the active window to the window which contains the frameset.

ONLOAD
Specifies JavaScript code to execute when the frameset is loaded. This code will be executed after the pages within the frameset have been fully loaded.

ONUNLOAD
Specifies JavaScript code to execute when the frameset is unloaded. This code will be executed before you leave the page which contains the frameset.

ROWS
This attribute determines the number of rows the frameset should have. A frameset can have the COLS attribute or the ROWS attribute, but not both.
The attribute takes as its value a comma separated list of values. These values can be absolute pixel values, percentage values between 1 and 100, or relative scaling values. The number of rows is implicit in the number of elements in the list. Since the total height of all the rows must equal the height of the window, row heights might be normalized to achieve this. A missing ROWS attribute is interpreted as a single row arbitrarily sized to fit.

Syntax of value list :

value: A simple numeric value is assumed to be a fixed size in pixels. This is the most dangerous type of value to use since the size of the viewer's window can and does vary substantially. If fixed pixel values are used, it will almost certainly be necessary to mix them with one or more of the relative size values described below. Otherwise the client engine will likely override your specified pixel value to ensure that the total proportions of the frame are 100% of the width and height of the user's window.
value%: This is a simple percentage value between 1 and 100. If the total is greater than 100 all percentages are scaled down. If the total is less than 100, and relative-sized frames exist, extra space will be given to them. If there are no relative-sized frames, all percentages will be scaled up to match a total of 100%.
value*: The value on this field is optional. A single '*' character is a "relative-sized" frame and is interpreted as a request to give the frame all remaining space. If there exist multiple relative-sized frames, the remaining space is divided evenly among them. If there is a value in front of the '*', that frame gets that much more relative space. "2*,*" would give 2/3 of the space to the first frame, and 1/3 to the second.

Examples

Go and visit another <A href="FRAME1.html">framed</A> document.

Go and visit another framed document.