Templat:Prewrap

{{{1}}}

Use, Limitations, and Options

Use

This template makes a preformatted text box with adjusable styles. It wraps long lines while preserving the preformatting of other lines.

The wrapping of long code lines, while preserving other preformats might be useful for Wiki and other code listings. Poetry and lyrics might also make use of it, since they consist largely of preformatted text. In any case, preformatted text can be CSS-styled to a considerable extent and need not be restricted to the style-sheet's default styles. Refer to the options for their use. The format to call the template into use is just:

{{prewrap|width=200px|border=1px solid lightgrey|cbgc=lightyellow|1=Text with its formats here}}

Two typical examples look like this:

The time has come for all good men to come to the aid of the party.   The quick brown fox jumps over the lazy dog 0123456789 times.
1   2   3   4   5
6    7    8    9    0

<table class=toccolours style="margin: 1em 0 0 0; width: 300px; background: #f9f9f9;;" align= left>
<td align=center style="font-weight: bold;">{{{1}}}</td>
<tr>
<td align=left style="font-weight: normal;">{{{2}}}</td>
</tr>
</table>

Notice that the very long unformatted text section and the long table list lines have been wrapped in their specified widths while the other lines which are formatted, have their white-space preserved. This behaviour will be seen only for browsers which support the pre-wrap value of the white-space property.

Limitations

This pre-wrap value is planned for Firefox 3. Versions of Opera after Opera 8 already work well with it. IE6 does not handle it but IE7 is unclear.

This template suffers in the usual way from parameters containing pipe symbols, and the conventional fixes still need applied. For example, to display the code for a Wiki table, be sure to separate the template's closing curly brackets from the closing curly bracket of the table listing with a space. In addition, use the numbered parameter when calling the template into use. HTML symbols are tolerated better.(See the above example).

Be sure to use the <br clear=all> code to force the next box or text line into a clear space. Follow-on material will otherwise float-left and wrap.

Options

Container

align: container page position. left, center, or right, default left
border: box outer all round border, default 1px solid lightgray
height: box height, default auto
width: box width, default auto
overflow: action in event of text overflow; eg scrollbars , default auto

Content

cbgc: content box background color, default transparent
cfc: content text color, default inherit
clh: content height between text lines, default 1.1em
cp: content text padding, default 1em
cff: content font family, default inherit
cfs: content font size, default inherit
cfst: content font style, default normal
ctha: content text horizontal alignment, default left. Options; left,center,right
cfw: content font weight, default normal

The White-space Property

wrap: white-space handling, default pre-wrap. Options are normal, pre, pre-wrap, or nowrap.

Notes on White-space

The normal option resembles the usual Wiki behaviour for white-space, in that it does not generally preserve white-space, except for excess line spacing. The pre option preserves all white-space. The pre-wrap option wraps long lines while preserving all other white-space; this is the choice for Wiki code listings. The nowrap option does not preserve any white-space, not even double line spacing, and places everything into one line.