<xmod:listviewstyle>

NOTE: As of version 4, this tag is generated behind-the-scenes by XMod based on settings you specify in the Template Designer. It is provided to help explain the tag's properties and for those situations where you need to generate template code outside XMod's user interface.

 

LIST VIEW TEMPLATE CONTROL: This tag is used to style the list. There should be only one of these tags in a template. This tag can only be used in a List View template.

 

ATTRIBUTES:

width

Width of the list. See "borderwidth" for list of valid values (Optional)

height

Height of the list. See "borderwidth" for list of valid values (Optional)

backcolor

Specifies the background color of the list. Valid HTML color values are valid for this attribute (Optional)

forecolor

Specifies the color to use for the text in the item. HTML color values are valid. (Optional) New to Version 4.0

bordercolor

Specifies the color to use for the list border. Valid HTML color values are valid for this attribute. (Optional)

borderwidth

Specifies the width, of the border.  (Optional)
Values can be specified in various measurements:

  • Pixel (px) "1px"

  • Point (pt) "1pt"

  • Centimeter (cm) "1cm"

  • Millimeter (mm) "1mm"

  • Inch (in) "1in"

  • Em (em) "1em"

borderstyle

How the border line should be drawn. (Optional)
Valid values are:

  • none (default)

  • dotted

  • dashed

  • solid

  • groove

  • double

  • ridge

  • inset

  • outset

Please note that not all border styles may be recognized by all browsers.

cellpadding

The padding within cells (numeric value) (Optional)

cellspacing

The spacing between cells (numeric value) (Optional)

gridlines

Determines which lines to show. (Optional)
Valid values: none, horizontal, vertical, both

showheader

If "true", the header will be shown. If "false", the header will be hidden.(Optional) Default is "false"

showfooter

If "true", the footer will be shown. If "false", the footer will be hidden.(Optional) Default is "false"

pagertemplate

Deprecated as of version 4.0. Use <xmod:pagerstyle> instead.

Allows template builder to specify page info label ("Page XX or XX") using placeholders {Page} and {PageCount} as placeholders. This gives the template builder the ability to style the info and translate into non-English languages. You can use HTML as long as you use entities for < (&lt;) > (&gt;) " (&quot;) and a special "fake" entity for a forward slash (for closing tags) / (&fwdslash;)
(new to version 1.2)

showpager

If "true" the pager will be shown. If "false", the pager will be hidden. (Optional) Default is "true" (new to version 1.2)

prevtext

Deprecated as of version 4.0. Use <xmod:pagerstyle> instead.

Allows you to override the default text used for the "previous page" link (new to version 1.2)

nexttext

Deprecated as of version 4.0. Use <xmod:pagerstyle> instead.

Allows you to override the default text used for the "next page" link (new to version 1.2)

repeatdirection

Specifies whether the list displays vertically or horizontally. Valid values are: vertical and horizontal. If the value is vertical, items in the list are displayed in columns, loaded from top to bottom then left to right (assuming repeatcolumns > 1). If the value is horizontal, items in the list are loaded from left to right (if repeatcolumns > 1) and then top to bottom.  (Optional) Default value is "vertical"
(new to version 3.0)

repeatcolumns

Specifies the number of columns to display in the list. This attribute works in conjunction with repeatdirection. Valid values are numeric values greater than or equal to 0 (zero). If the value is "0" and repeatdirection is "horizontal" then all items are displayed in a single row. If repeatdirection is "vertical" then items are displayed in a single column.. A value of 5 would instruct XMod to display its items in 5 columns.
(new to version 3.0)

showdetailsinline

If true, XMod will show detail views on the same page as the list view. If not specified or if false, XMod will function as it has in prior versions, displaying details on a separate page.
(new to version 3.0)

class

Specifies the CSS class to be applied to the list view, as a whole. (Optional) (new to version 3.2)

align

Determines the horizontal alignment of the list view. Valid values are:

  • left

  • right

  • justify

  • center

(Optional) Default value is left

(new to version 3.2)

 

EXAMPLE

<xmod:listviewstyle bordercolor="blue" borderwidth="1px" borderstyle="dashed" gridlines="both" cellpadding="5" cellspacing="3" width="400px" showheader="true" pagertemplate="Page {Page} or {PageCount} prevtext="&lt;&lt;Prev" nextext="Next&gt;&gt;" />

 

<xmod:listviewstyle borderwidth="1px" borderstyle="solid" bordercolor="#000000" showheader="true" showpager="false" repeatdirection="horizontal" repeatcolumns="3" gridlines="both"/>

 

The above example would display a table similar to this:

Item 1

Item 2

Item 3

Item 4

Item 5

Item 6

Item 7

Item 8

Item 9

 

<xmod:listviewstyle borderwidth="1px" borderstyle="solid" bordercolor="#000000" showheader="true" showpager="false" repeatdirection="vertical" repeatcolumns="3" gridlines="both"/>

 

The above example would display a table similar to this:

Item 1

Item 4

Item 7

Item 2

Item 5

Item 8

Item 3

Item 6

Item 9