<ILAYER>

The <ILAYER> element (currently only supported by the Navigator component of Netscape Communicator) allows in-line 'layers' to be produced in document. As fixed-position layers (see <LAYER>), they can contain any normal HTML content and are positioned relative to the point where they occur within the document.

NAME
The NAME attribute can be supplied to uniquely identify the layer for scripting purposes. By default, all layers are unnamed.

LEFT
LEFT specifies the layers relative x coordinate, in pixels, where "0" (the default value) is the point in the document where the <ILAYER> element occurs. The LEFT attribute can be given negative, or positive values, displaying the in-line layer 'floating' above other document content.

TOP
The TOP attribute specifies the relative y coordinate in pixels, where "0" (again, the default value) is the top-most point at which the <ILAYER> element occurs.

SRC
The SRC attribute can be used to reference a separate document that contains the content of the layer. Currently (for Communicator pre-release 2), the document referenced must not include <HEAD> or <BODY> elements.

Z-INDEX
The Z-INDEX attribute is mutually exclusive with the ABOVE and BELOW attributes. It is supplied with a numerical value which determines the layers z-order setting (which determines how various layers overlap each other). The Z-INDEX attribute is generally more useful when using exact positioning with layers, using the <LAYER> element. See <LAYER> for more details.

ABOVE
The ABOVE attribute (mutually exclusive with Z-INDEX and BELOW attributes) can be used to specify the layer immediately above the current layer. The ABOVE attribute is generally more useful when using exact positioning with layers, using the <LAYER> element. See <LAYER> for more details.

BELOW
Similar to the ABOVE attribute (and mutually exclusive with it and the Z-INDEX attribute), the BELOW attribute specifies the layer to be displayed immediately below the current layer, with the same restrictions as the ABOVE attribute. The BELOW attribute is generally more useful when using exact positioning with layers, using the <LAYER> element. See <LAYER> for more details.

WIDTH
The WIDTH attribute can be specified (with a pixel value) to set the width of the layer, to determine how the content of the layer is wrapped within the layer. Layer heights are automatically defined according to the content of the layer. (NOTE : Not currently supported in preview release 2 of Communicator)

CLIP
The CLIP attribute can be used to specify a certain portion of the layer as being visible. Anything outside the CLIP region is transparent and won't be displayed. It accepts 4 pixel values (comma delimited) which are used to set the CLIP rectangles left, top, right and bottom coordinates. Left and right values start from the left hand edge of the layer, while top and bottom values start from the top of the layer. If only two values are supplied, then the left and top coordinates are set to 0. For example :

specifies a clipping region of 40 (x direction) by 10 (y direction) pixels for the layer, starting at the position 10,10 (x,y), while :

specifies a clipping region of 50 (x direction) by 20 (y direction) pixels for the layer, starting at the position 0,0 (x,y).

VISIBILITY
The VISIBILITY attribute controls whether the layer is currently visible or not. It can accept values of show, hide or inherit. Show and hide explicitly set the layers visibility, while inherit makes the current layer inherit the VISIBILITY of its parent layer(s) (layers can be nested). If the current layer is a parent layer (or contains no child layers), 'show' and 'inherit' are identical, since the layer will be visible (unless VISIBILITY="hide" is used).

BGCOLOR
BGCOLOR can be used to set the background colour of the current layer. By default, layers are transparent, specifying a BGCOLOR makes the layer opaque, using the colour specified. Any standard rrgggbb triplet, or a named colour can be used. For more details on document colouring, see the <BODY> element.

BACKGROUND
The BACKGROUND attribute can be used to reference a background image for the layer. Note that is the image used is wider than the layers WIDTH attribute value (see above), then the width of the layer will be extended to display the image fully.