Table Tags

A table is defined within an elements block, central-page, or overview-page. Tables can be used only by central or overview pages.

Tag

Examples

Status

Notes

table

table id = "tb-product" {

title "Test"

dimension "Product Name"

text column = "Cost" {

value-format "$#,###.00"

}

text column = "Cases" {

background-color "bdfbaf"

}

sort-column "Product Name"

first 20

}

Required Defines the table block. Requires an id tag when defined in an elements block.
alert

alert {

value column = "Cost"

low-threshold 100

high-threshold 100,000

}

Optional

Defines an alert based on the named column and thresholds.

background-color background-color "bdfbaf" Optional Sets the background color for the page background or table column values. Uses a hexadecimal code to identify colors.
border

border

Optional

Applies a border to the element.

bullet bullet column = "Cost" Optional

Defines a bullet based on the named column.

column

text column = "Cost"

text "# of Cases" column = "Cases"

Optional Names a summary in the cPlan or a column-set.
column-set

column-set id = "cs-case_cost" {

text column = "Cost"

text column = "Cases"

}

Optional

Names a previously defined set of columns in a definitions block.

cplan cplan "/cplans/basic_timeseries.cplan" Optional

Indicates the data source. Can include filters.

If a cPlan is not defined, the table uses the cPlan that is used by the page that calls the table.

dimension

dimension "Product Name"

Optional Names the dimension to display on the page. There can be one to many dimensions.
first

first 10

first 20

Optional

Limits the number of values shown.

Typically used with the sort-column tag to display a limited number of the highest or lowest values.

id

table id = "table" {

...

}

Optional Gives the table definition an identifier. Required when the table block is used within an elements block.
image

image id = "logo" {

path "/divetab/images/logo.png"

}

Optional Specifies a graphic to use. A path is required. Images are typically stored within the divetab/images folder.
no-grid-lines no-grid-lines Optional Prevents the appearance of grid lines between values in the client.
no-sort no-sort Optional Specifies that a column is not sorted.
percent

percent = 50

percent = 85

Optional

Identifies the percentage of the display layout allocated for the element.

NOTE: The total percentage must equal 100.

sort-column

sort-column "Cost"

sort-column "Cases" reverse = true

Optional Specifies a column to sort on. Sorts using dimension values by default.
text text "# of Cases" column = "Cases" Optional Specifies the column heading label that displays in the DiveTab client.
title

title "Test"

Optional Labels the table. Appears in the title bar when the page displays.
title-justification

title-justification "left"

title-justification "right"

title-justification "center"

Optional

Aligns the title of the table to the left, right, or center.

By default, the table title is justified to the center of the title bar.

See also: