<ILAYER>NN |4| IE n/a HTML n/a  

<ILAYER>...</ILAYER>

HTML End Tag: Required  

An ilayer element is an inline version of the Navigator 4-specific layer element. In some respects, the ilayer element works like the iframe element in Internet Explorer, but an ilayer is automatically regarded as a positionable element in Navigator 4's object model (e.g., like a block-level element with a CSS position: attribute set to relative). As a result, many of the attributes are the same as the layer element and are named according to the Navigator 4 way of positioning, sizing, and stacking positionable elements.

Content for an ilayer element can be read in from a separate file (with the src attribute) or wired into the current document by placing the HTML between the start and end tags. You can include both types of content in the same ilayer element. Content from the src document is rendered first (as its own block-level element), with additional content starting on its own line below the external content's rectangle.

 
Example
 
<ILAYER id="thingy1" src="quotes.html" width="150" height="90"></ILAYER>
 
Object Model Reference
 
[window.]document.layerName
 
Element-Specific Attributes
 
abovebackgroundbelowbgcolorclip
heightidleftnamesrc
topvisibilitywidthz-index
 
Element-Specific Event Handler Attributes
 
HandlerNNIEHTML
onblur4n/an/a
onfocus4n/an/a
onload4n/an/a
onmousedown4Event capture mode only.n/an/a
onmouseout4an/an/a
onmouseover4an/an/a
onmouseup4an/an/a
aboveNN |4| IE n/a HTML n/a  

above="layerID"

Optional  

Names the positionable element that is to be above (in front of) the current ilayer in the stacking order. This is a different way to set the z-index attribute that does not rely on an arbitrary numbering system. If you use the above attribute, do not use the below or z-index attribute for the same ilayer element.

 
Example
 
<ILAYER id="thingy4" src="quotes.html" above="thingy3"></ILAYER>
 
Value

Case-sensitive identifier.

 
Default

None.

 
Object Model Reference
 
[window.]document.layerName.above
backgroundNN |4| IE n/a HTML n/a  

background="URL"

Optional  

Specifies an image file that is used as a backdrop to the text and other content of the ilayer element. Unlike normal images that get loaded into browser content, a background image loads in its original size (without scaling) and tiles to fill the available layer space. Smaller images download faster but are obviously repeated more often in the background. Animated GIFs are also allowable but very distracting to the reader. When selecting a background image, be sure it is very muted in comparison to the main content so that the content stands out clearly. Background images, if used at all, should be extremely subtle.

 
Example
 
<ILAYER id="thingy4" src="quotes.html" background="blueCrinkle.jpg"></ILAYER>
 
Value

Any valid URL to an image file, including complete and relative URLs.

 
Default

None.

 
Object Model Reference
 
[window.]document.layerName.background
belowNN |4| IE n/a HTML n/a  

below="layerID"

Optional  

Names the positionable element that is to be below (behind) the current ilayer in the stacking order. This is a different way to set the z-index attribute that does not rely on an arbitrary numbering system. If you use the below attribute, do not use the above or z-index attribute for the same ilayer element.

 
Example
 
<ILAYER id="thingy4" src="quotes.html" below="thingy5"></ILAYER>
 
Value

Case-sensitive identifier.

 
Default

None.

 
Object Model Reference
 
[window.]document.layerName.below
bgcolorNN |4| IE n/a HTML n/a  

bgcolor="colorTripletOrName"

Optional  

Establishes a fill color (behind the text and other content) for the entire layer rectangle. If you combine a bgcolor and background, any transparent areas of the background image let the background color show through.

 
Example
 
<ILAYER src="quotes.html" bgcolor="tan"></ILAYER>
 
Value

A hexadecimal triplet or plain-language color name. A setting of empty is interpreted as "#000000" (black). See Appendix A for acceptable plain-language color names.

 
Default

Varies with operating system.

 
Object Model Reference
 
[window.]document.layerName.bgColor
clipNN |4| IE n/a HTML n/a  

clip="[leftPixel, topPixel,] rightPixel, bottomPixel"

Optional  

A clipping region is a rectangular view to the full ilayer content. Only content that is within the clipping rectangle can be seen on the page. The default value of the clip attribute is determined by the space required to display the content as it naturally flows into the element. Setting the clip attribute lets you rein in long content that might flow beyond a fixed rectangle desired for the page design.

 
Example
 
<ILAYER src="quotes.html" clip="50,50"></ILAYER>
 
Value

clip attribute values are pixel measures from the top and left edges of the element as it flows in the document. The order of values is clockwise from the left edge, around the rectangle sides: left, top, right, bottom. If you supply only two values, Navigator assumes the left and top values are zero, meaning that you wish to adjust only the right and bottom edges. Thus, a setting of "50,50" means that the clipping region is 50-pixels square, starting at the top-left corner of the layer's rectangle. If you want the same size view, but starting 10 pixels in from the left, the clip attribute setting becomes "10,0,60,50".

 
Default

Naturally flowing viewing area of ilayer content.

 
Object Model Reference
 
[window.]document.layerName.clip.left
[window.]document.layerName.clip.top
[window.]document.layerName.clip.right
[window.]document.layerName.clip.bottom
height, widthNN |4| IE n/a HTML n/a  

height="length" width="length"

Optional  

Define the minimum size of the layer as it flows in the document. When you add content to the layer, however, the attribute settings do not restrict the amount of the content that is visible along either axis. For example, if you display an image in an ilayer that is 120 pixels wide by 90 pixels high, the actual visible size of an ilayer element whose height and width attributes are set to a smaller size expands to allow the full image to appear. The same happens to text or other content: the viewable region expands to allow all content to appear. To restrict the visible portion of the content, set the clip attribute.

Setting the height and width attributes to specific sizes is helpful when you are creating a colored or patterned rectangle (via the bgcolor or background attributes) to act as an underlying layer beneath some other positioned content. Without content pushing on the edges of the ilayer, the height and width attributes set the clipping region to their sizes.

 
Example
 
<ILAYER bgcolor="yellow" height="100" width="100"></ILAYER>
 
Value

Positive integer values (optionally quoted) or percentage values (quoted). You can reduce both values to zero to not only hide the element (which you can also do with the visibility attribute), but prevent the element from occupying any page space.

 
Default

Naturally flowing viewing area of ilayer content.

 
Object Model Reference
 
[window.]document.layerName.height
[window.]document.layerName.width
idNN |4| IE n/a HTML n/a  

id="elementIdentifier"

Optional  

A unique identifier that distinguishes this element from all the rest in the document. This is the identifier used as values for the above and below attributes. Scripts also use the id attribute value as the ilayer element's name for object references.

 
Example
 
<ILAYER id="oldYeller" bgcolor="yellow" height="100" width="100"></ILAYER>
 
Value

Case-sensitive identifier.

 
Default

None.

 
Object Model Reference
 
[window.]document.layerName.name
langNN 3 IE 4 HTML 4  

lang="languageCode"

Optional  

The language being used for the element's attribute values and content. A browser can use this information to assist in proper rendering of content with respect to details such as treatment of ligatures (when supported by a particular font or required by a written language), quotation marks, and hyphenation. Other applications and search engines might use this information to aid the selection of spell-checking dictionaries and the creation of indices.

 
Example
 
<SPAN lang="de">Deutsche Bundesbahn</SPAN>
 
Value

Case-insensitive language code.

 
Default

Browser default.

 
Object Model Reference
 
[window.]document.getElementById(elementID).lang
left, topNN |4| IE n/a HTML n/a  

left="pixelCount" top="pixelCount"

Optional  

Define the positioned offset of the left and top edges of the layer relative to the spot in the document where the ilayer element would normally appear. The precise location relative to the page varies because an ilayer element is an inline layer, which means it can start anywhere within normally flowing HTML content. When you set either of these attributes, Navigator 4 preserves the space in the document where the ilayer element appears, rather than cinch up surrounding content to fill space vacated by the element that has shifted its location. You are therefore likely to set these attributes for an ilayer only when attempting to accomplish a look tailored to very customized content (perhaps an ilayer amid inflow images).

 
Example
 
<ILAYER bgcolor="yellow" left="10" top="50"></ILAYER>
 
Value

Positive integer values (optionally quoted).

 
Default

0

 
Object Model Reference
 
[window.]document.layerName.left
[window.]document.layerName.top
nameNN |4| IE n/a HTML n/a  

name="elementIdentifier"

Optional  

A unique identifier that distinguishes this element from all the rest in the document. This is the identifier used as values for the above and below attributes. The name attribute is interchangeable with the id attribute for object references.

 
Example
 
<ILAYER name="oldYeller" bgcolor="yellow" height="100" width="100"></ILAYER>
 
Value

Case-sensitive identifier.

 
Default

None.

 
Object Model Reference
 
[window.]document.layerName.name
srcNN |4| IE n/a HTML n/a  

src="URL"

Optional  

To load the content of an external HTML file into an ilayer element, assign the URL of that file to the src attribute. Any HTML content between the ilayer start and end tags is rendered on the page after the content loaded from the src URL. If you omit the src attribute, only content between the tags is rendered. Scripts can change the corresponding object property (src) after the document has loaded to dynamically change content within the ilayer element (without reloading the main document).

 
Example
 
<ILAYER src="quotes.html"></ILAYER>
 
Value

A complete or relative URL.

 
Default

None.

 
Object Model Reference
 
[window.]document.layerName.src
top  

  

See left.

visibilityNN |4| IE n/a HTML n/a  

visibility="visibilityConstant"

Optional  

Determines whether Navigator 4 displays the ilayer element. The default behavior is for a layer to inherit the visibility attribute of its next outermost (parent) layer. For an ilayer element that is part of the basic document body, this means that the layer is seen by default (the base layer is always visible). To hide a layer when the page loads, set the visibility attribute to "hidden". You need to set the attribute to "show" only if the ilayer element is nested within another layer with a visibility value that is set to (or is inherited as) "hidden".

Regardless of the visibility attribute setting, an ilayer element always occupies its normal inflow space in the document. This allows Navigator 4 to change the visibility on the fly (via scripting) without reloading the document. (Navigator 4 does not automatically reflow changed content.)

 
Example
 
<ILAYER src="quotes.html" visibility="hidden"></ILAYER>
 
Value

One of the accepted constants: hidden | inherit | visible.

 
Default

inherit

 
Object Model Reference
 
[window.]document.layerName.visibility
width  

  

See height.

z-indexNN |4| IE n/a HTML n/a  

z-index="layerNumber"

Optional  

Controls the positioning of layers along the Z-axis (front-to-back) of the document relative to the next outermost layer container. When the z-index values of two or more positionable elements within the same container (such as the base document layer) are identical numbers, the loading order of the elements in the HTML source code controls the stacking order, with the later elements stacked in front of earlier ones. The default z-index value for all positionable elements is zero. Therefore, if you want only one positionable element to appear in front of all the others that stack in their default order, you simply assign any positive value (even 1) to that stand-out element. Stacking order of positionable elements can be changed on-the-fly via scripting. See also the above and below attributes.

 
Example
 
<ILAYER src="quotes.html" z-index="1"></ILAYER>
 
Value

Any integer.

 
Default

0

 
Object Model Reference
 
[window.]document.layerName.zIndex