• Section
    Layout Field ...
     
  • Token
    Pos
     
  • Description
    It is always a little bit difficult, to generate a smooth layout in HTML-Documents. One of the preferred ways for may webmasters is, to place the single elements in a HTML-Table. WWWdb does the same. The Pos-parameter creates a coordinate which has three parts:
    1. the line in the table
    2. the column of the table
    3. the sequence inside the column
    This coordinates can be passed absolute or relative to its predecessor.

    Here an example of absolute adressing in the form <Line>.<Col>.<Seq>:
     
    0.0.0 0.0.1 0.0.2 0.1.0------------------------
    0.1.1------------------------ 
    0.1.2------------------------
    0.2.0 ...
    1.0.0 ... 1.1.0 ... 1.2.0 ...
    2.0.0 ... 2.1.0 ... 2.2.0 ...

    But in many cases, absolute adressing is not so good to handle, because the insertion of rows and columns is much work, wehn you have to renumber all rows/columns. Here we need the relative adressing, which gives us the possibility to pass the difference to the previous item.

    Here an example of relative adressing in the form <[+]Line>.<[+]Col>.<[+]Seq> (in italic is the corresponding absolute address):
     
    0.0.0 [0.0.0]
    0.0.+1 [0.0.1]
    0.+1.0  [0.1.0] 0.+1.0 [0.2.0]
    - +1.+1.0 [1.1.0] +0.+1.0 [1.2.0]
    - - -
    +2.0.0 [3.0.0] - +0.+2.+0 [3.2.0]
    +0.+0.1 [3.2.1]
    +0.+0.+2 [3.2.3]

    As you can see, absolute and relative addressing can be mixed. If you want to have a field spanning mor then a row or column, then you can also pass spanning-information. Here an example of relative adressing in the form <[+]Line[+Line-Span]>.<[+]Col[+Col-Span]>.<[+]Seq>
     
     
    0.0.0 0.+1+1.0 
    +0.+0.+1
    +1.0+2.0
    +1+1.0.0 +0.+1.0 -
    +1.+2.+0 -

    With this functionality, you can place your fields almost as you like.
     
     

  • Values
    The general Syntax is:

    <[+]Line[+Line-Span]>.<[+]Col[+Column-Span]>.<[+]Seq>
     
     

  • Notes
    When using relative adressing, the order of the entries in the config file is important, because it defines the design! If an entry has no Pos-attribute it will be appended at the end of the form.
     
  • See also
    Layout Field->*
     
  • Example
    ; use the form     Label left of field with absolute adressing
    [Layout Label field_one]
    Pos = 1.0.0
    ...
    [Layout Field field_one]
    Pos = 1.1.0
    ...

    ; use the form     Label over the field with relative adressing
    [Layout Label field_two]
    Pos = +1.0.0
    ...
    [Layout Field field_two]
    Pos = +1.0.0
    ...

    ; Span this label over the whole form (four columns)
    [Layout Label header]
    Pos = +1.0+3.0