Manual for RelativeLayers

Geert Bevin

UWYN bvba.

  Rue Victor Cuvelier 57,
  7190 Ecaussinnes,
  Belgium,
  

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA


Table of Contents
Intended audience
I. User's guide
1. Purpose, or how it got started
Being annoyed
Searching a solution
Leaving the existing classes
2. The basics of RelativeLayers
Your first layer
Using the available area
Nested layers
Moving and resizing
Relative positioning
3. Advanced features
Events
Limits
Drag & drop
External source
Dynamic creation
II. Reference
I. Javascript reference
Error handling -- suppression of potential javascript errors.
Browser detection -- detects which browser is interpreting the current page.
Utility functions and classes -- general purpose functions and classes.
Debugging -- eases javascript debugging.
Window related functions -- browser independent access to window related functions.
RelativeLayer -- the RelativeLayer class and its core functionalities
Limits extensions -- define limits for a layer's position.
Drag & drop extension -- reposition a layers through drag & drop.
External layer source extension -- obtain a layer's content from an external source.
II. Tool reference
stripjavascriptcode.pl -- reduces the code size of javascript files.
A. Browser compatibility chart
Index
List of Tables
2-1. Basic example : explanation of the layer creation
2-2. Available area example : explanation of the navigation layer creation
2-3. Available area example : explanation of the second layer creation
2-4. Nested layers example : explanation of the parent layer creation
2-5. Nested layers example : explanation of the nested layer creation
2-6. Moving and resizing example : explanation of the main layer creation
2-7. Moving and resizing example : explanation of the controlling layer creation
A-1. Linux browser compatibility chart
A-2. Windows browser compatibility chart
A-3. Macintosh browser compatibility chart
List of Figures
1-1. Layers defined with a fixed number of pixels, before and after resize of the browser window.
1-2. Layers defined with relative dimensions, before and after resize of the browser window.
1-3. Layers envisioned first with the available area and then clipped to the visible part.
1-4. Layers envisioned first with the visible part and then the available area is defined in a relative manner.
1-5. Layers positioned relative to their parent.
1-6. Layers positioned relative to another layer when needed.
1-7. Lengths defined as a single value.
1-8. Lengths defined as expressions to remember to logical and make it easy to adapt.
2-1. Basic example : definition of the position and size of the visible area.
2-2. Basic example : definition of the position and size of the available area.
2-3. Available area example : definition of the position and size of the visible area of the navigation layer.
2-4. Available area example : definition of the position and size of the visible area of the second layer.
2-5. Available area example : definition of the position and size of the available area of the second layer.
2-6. Nested layers example : definition of the position and size of the visible area of the parent layer.
2-7. Nested layers example : definition of the position and size of the visible area of the nested layer.
2-8. Moving and resizing example : definition of the position and size of the visible area of the main layer.
2-9. Moving and resizing example : definition of the position and size of the visible area of the controlling layer.
1. RelativeLayer definition : explanation the visible area's variables.
2. RelativeLayer definition : explanation the available area's variables.
List of Examples
2-1. Basic example
2-2. Available area example
2-3. Nested layers example
2-4. Move and resize example
2-5. Relative positioning example
3-1. Events example
3-2. Limits example
3-3. Drag & drop example
3-4. External source example
3-5. Dynamic creation example