NAME

       wml::std::box - Easily Create Rectangular Box

SYNOPSIS

        #use wml::std::box

        <box [attributes]>
        ...
        </box>

DESCRIPTION

       The "<box>" container tag puts its body into a nice rectangular box which itself is build via a HTML
       "<table>" construct.

ATTRIBUTES

       "header"
           This  attribute switches between two totally different box variants.  When it is present, a headlined
           box is created by the use of one single table but with space GIFs. When this attribute is  missing  a
           standard box is created by the use of two nested tables but without any space GIFs.

       "bgcolor"
           This sets the background color of the box.

       "fgcolor"
           This sets the foreground (text) color of the box.

       "bdcolor"
           This  sets  the  color  for  the  border  of  the  box. The effect of this attribute is the automatic
           generation of a nested table construct to achieve the optical effect.

       "bdspace"
           This sets the space between the border and the body of the box in pixels.  Default is 4 pixel.

       "bdwidth"
           This sets the border width in pixels. Default is 1 pixel.

       "width"
           This sets the total table width in pixels. Default is no specific width for the standard box and  300
           pixels  for the headlined box (because the headlined variant needs to know a fixed size to create the
           GIFs accordingly).

       "summary"
           Add a description of this table.  This attribute is recommended in HTML 4.0.

EXAMPLE

        <box bdcolor="#000000" bdwidth=1 bdspace=10
             bgcolor="#ffffff" fgcolor="#000000">
        Foo Bar Quux
        </box>

        <box header="Foo Bar Quux Header"
             bdcolor="#000000" bdwidth=1 bdspace=10
             bgcolor="#ffffff" fgcolor="#000000">
        Foo Bar Quux
        </box>

AUTHOR

        Ralf S. Engelschall
        rse@engelschall.com
        www.engelschall.com

REQUIRES

        Internal: P1, P2

SEE ALSO

       HTML "<table>" tag.

EN Tools                                           2020-11-29                                   wml::std::box(3)