[Show/Hide Right Column]

Defines and formats sections of a page or text.
Print
Tags: plugin div syntax
TOC Previous page Parent page Next page

Plugin Div

This Wiki Plugin defines and formats sections of a page or text.

Usage and Parameters

To use this plugin in a wiki page, use the syntax:

Syntax for the DIV plugin
{DIV(type=div|span|pre|b|i|tt|p|blockquote, bg= , width= , align=left|center|justify,  float=left|right, class= , id= )} your content {DIV}

Parameter Accepted values Default Effect Required? Since
type div
span
pre
b
i
tt
p
blockquote 		div div: defines a block (division or section) that can be formatted
span: defines a span of inline text that can be formatted
pre: preserves spaces and line breaks and uses a fixed-width font
b: bold text
i: italic text
tt: Teletype font
p: defines a paragraph with space before and after itself
blockquote: formats a long quotation with margins and space before and after 		n
bg valid HTML color name
(example: brown)
valid HTML color code
(example: #A52A2A)
click here for valid color names and codes 		none Sets the background color n
width number of pixels
(example: 200px)
percent
(example: 50%) 		none Sets the width of the element n
align right
center
justify 		left Aligns text within the element n
float left
right 		float is set to none Determines alignment of entire element n
clear left
right
both 		clear is set to none Items are not allowed to wrap around the side(s) this parameter is set to.
See next section on Controlling "Wrapping" for more information.		 n 4.0
class valid CSS class none Apply custom CSS class to the element n
id text string none Sets the element id n 2.0

Controlling "Wrapping"

If this plugin is used and the float parameter is used to align a block, then other elements on the page may "wrap" around that block. To avoid this or otherwise control the wrapping, the DIV plugin needs to be followed by another plugin or code that sets the clear property. Here are three ways to do this where all wrapping is stopped:

MethodSyntax to avoid all wrapping
PluginDiv
(starting with version 4)		 {DIV(clear=both)}{DIV}
PluginTag {TAG(tag=br style=clear:both)}{TAG}
Dynamic Variable Establish a variable like %clear% and set to <br style="clear: both" /> . To set its value, click on NaV the first time.

The clear property can also be set to "right" or "left" as needed for desired effect.

Examples

Type=div

This code, 

{DIV(float=right width=200px bg=#FFEBCD align=center)} This section is a "div" that is 200 pixels wide, has a nice blanched almond background color, aligns to the right because float=right, with text that aligns center because align=center.{DIV}

Would produce:

This section is a "div" that is 200 pixels wide, has a nice blanched almond background color, aligns to the right because float=right, with text that aligns center because align=center.

Type=span

This code, 

With type=span, the text remains inline. {DIV(type=span bg=yellow)} This text is in a "span" that is that is highlighted yellow.{DIV} And this text is after the span.

Would produce:
With type=span, the text remains inline. This text is in a "span" that is that is highlighted yellow. And this text is after the span.

tipDifference between "div" and "span"
These types are similar, but one of the main differences is that the "span" type can be used for inline text whereas the "div" type cannot.

Type=pre

This code, 

{DIV(type=pre align=justify bg=#D8BFD8 width=600px)} Using "pre" displays text in a fixed-width font, preserves     spaces and any

line breaks (enter was hit twice before "line"). 
The width only controls the color, not the text. {DIV}

Would produce:

 Using "pre" displays text in a fixed-width font, preserves     spaces and any

line breaks (enter was hit twice before "line").
The width only controls the color, not the text.

noteNote
PluginCode or the Wiki-Syntax Text "~np~ your content ~/np~" can also be used for similar effects and to display code without processing it.

Type=blockquote

This code, 

{DIV(type=blockquote width=150px align=justify)} Notice that blockquote indents the text. Here the width has been set at 150 pixels and the text is justified.{DIV}

Would produce:

Notice that blockquote indents the text. Here the width has been set at 150 pixels and the text is justified.

Type=b, i, tt,

These types are used to format text. Here are some examples:

TypeSyntaxResult
b {DIV(type=b bg=#F08080)}This text is bold and the background is misty rose.{DIV} This text is bold and the background is misty rose.
i {DIV(type=i float=right)}This text is italic and floats right.{DIV} This text is italic and floats right.
tt {DIV(type=tt)}This text is in teletype font.{DIV} This text is in teletype font.

noteNote
Consider using Wiki-Syntax Text if you just need simple text formatting and don't need other formatting like a background color or special alignment.

Contributors to this page: lindon2331 points  , sylvie4333 points  and Rick7121 points  .
Page last modified on Saturday 03 July, 2010 22:08:03 UTC by lindon2331 points .

SourceHistorySlides

Find by Page Name

Exact match

Keywords

The following is a list of keywords that should serve as hubs for navigation within the Tiki documentation and should correspond to development keywords (bug reports and feature requests):