User:CFCF/sanbdox/dropimage

{{documentation|content=

Usage
Template name: DROPIMAGE. Place text for a heading in parameter one position. Place definitions for images, galleries, or text in parameter two position. The content hides initially, and drops when the show or down-arrow link button is clicked. The link toggles to collapse and expand the drop control.

The initial width of the control is not necessarily the dropped width, since the control expands to display the contents. The width option sets the initial width. The drop's contents can contain hyperlinks, and the template can be nested.

Three simple examples of its use, with results, are shown:

Image example code:  

Gallery example code: '''

Limitations
The width option sets the initial width of the control. It expands on opening, and has been observed to involve some overlap of adjacent structures. This can be avoided by care in basic layout. The width option should obviously be set to avoid an overtight fitting of the caption.

The content cannot be a Wikitext table, since the pipe symbols confuse the code; use an HTML table instead. Even when the pipe symbol problem is overcome, by using HTML or problem-fixing templates, there will be problems in assigning table styles. For these reasons, avoid the use of tables within DROPIMAGE. A selection of other templates related to this exists in WikiBooks.

Bear in mind that the use of &lt;pre&gt;&lt;/pre&gt;  tags will be needed for preformatted text layout, and if the block of text itself has these same tags within it, the literals should be used to replace the  ones within the text. (ie: use these instead;  &amp;lt;pre&amp;gt; and &amp;lt;/pre&amp;gt;). This avoids the corrupted functioning which would otherwise result.

Note that for all table-based structures, a white background default is preferred over a transparent one, to avoid the appearance of any heading underlines showing through the table. (See style sheets for more).

The template might benefit from being remade as an HTML table since it would be less sensitive to certain enclosures. In addition, in the event that the source classes become faulty, the control would work well as a collapsible table using the class collapsible.

Container

 * width:  initial width of the container, (closed), not including borders (default, 300px)
 * align:  horizontal alignment of container (default, left); (Options,left,right,or center)
 * border: the container border (default, 1px solid black) (Options; in form width,type,color)
 * padding: the padding for the container (default, 0px); (Options,points,pixels,em,etc. )
 * background: background color of container,(seen for padding > 0px), Options;Any, Default;white

Heading

 * hff:    heading font family (face) (default, Arial); (Options,many named faces )
 * hfs:    heading font size (default, 10pt); (Options,points,pixels,em,etc.)
 * hfw:    heading font weight(default, normal); (Options,normal or bold )
 * hbgc:   heading background color (default, white); (Color options, any, hex or rgb or named )
 * hfc:    heading font color; (default, black); (Options,any, hex or rgb or named  )
 * hhta:   heading horizontal text alignment (default, center); (Options,left,right,center,justify)
 * hp:     heading text padding (default, 5px); (Options,points,pixels,em,etc.)

Content

 * cff:    content font family (face) (default, Arial); (Options,many named faces )
 * cfs:    content font size (default, 10pt); (Options,points,pixels,em,etc. )
 * cfw:    content text font weight(default, normal); (Options,normal or bold )
 * cbgc:   content background color (default, white); (Options,any, hex or rgb or named  )
 * cfc:    content font color; (default, black); (Options,any, hex or rgb or named  )
 * chta:   content horizontal text alignment (default, left); (Options,left,right,center,justify )
 * cp:     content text padding (default, 10px); (Options,points,pixels,em,etc. )

}}