Table Description Reference

This chapter provides a discussion of an overview of the namespace for the table description, and its elements and attributes.

1. Overview

Provides an overview of the namespace for the table description.

1.1. Features and Usage

The namespace for describing tables.

1.2. Namespace URI Reference

The namespace's URI reference of the table description is http://xmlns.xfytec.com/table. In the descriptions below, we use the namespace prefix table: for an element used in table descriptions.

Also, we use the following namespaces and their prefixes in the descriptions below.

  • VC Core
    We use xvcd: as the namespace prefix.
    For more information, see the VC Core Reference.

2. Elements, Attributes and Events Defined within the Table Description's Namespace

This section provides a discussion about elements, attributes, and events defined in the namespace for the table description.

2.1. Table Description

Elements and attributes used to describe the table in the table description's namespace are listed below.

table:table Element

Involves the description of the entire table.

The maximum value of the row-index attribute of the table:row element described within the element determines the number of table rows. Likewise, the maximum value of the table:column element, column-index attribute of the table:cell element described within the element determines the number of table columns.

Attribute:
class

Gives an element a class name. It can be a string.

If omitted, an attribute value is not assumed to be set.

id

Gives an element a unique identifier. It can be an ID value.

If omitted, an attribute value is not assumed to be set.

title

Used to give supplementary information to an element. It can be a string.

If omitted, an attribute value is not assumed to be set.

style

Used to describe a style sheet as an attribute value. It can be CSS format.

If omitted, an attribute value is not assumed to be set.

fix-row-height

Sets whether each row's height can be changed using the mouse. It can be a true/false value. If true is specified, you are unable to change the row height by using the mouse. If false is specified, you are able to change the row height by using the mouse.

If omitted, false is assumed to be set.

fix-column-width

Sets whether each column's width can be changed using the mouse. It can be a true/false value. If true is specified, you are unable to change the column width by using the mouse. If false is specified, you are able to change the column width by using the mouse.

If omitted, false is assumed to be set.

show-row-label

Sets whether row labels are displayed. It can be a true/false value. If true is specified, the row label is displayed. If false is specified, the row label is hidden.

If omitted, true is assumed to be set.

show-column-label

Sets whether column labels are displayed. It can be a true/false value. If true is specified, the column label is displayed. If false is specified, the column label is hidden.

If omitted, true is assumed to be set.

cell-border-color

Sets the cell border color. Describes the attribute in the same way as the color for CSS is specified.

If omitted, silver is assumed to be set.

row-label-width

Specifies the row label width in pixels. The value must be a positive number.

If omitted, 50 is assumed to be set.

column-label-height

Specifies the column label height in pixels. The value must be a positive number.

If omitted, 14.2 is assumed to be set.

row-height

Specifies the row height in pixels. The value must be a positive number. If the width attribute is specified within the table:row attribute described within the element, it takes precedence.

If omitted, 14.2 is assumed to be set.

column-width

Specifies the column width in pixels. The value must be a positive number. If the width attribute is specified within the table:column attribute described within the element, it takes precedence.

If omitted, 80 is assumed to be set.

Content:

The table:table element can contain the following elements.

  • table:head Element
    Only one element can be specified, if needed.
    Optional.
  • table:column Element
    Any number of elements can be specified, if needed.
    Optional.
  • table:row Element
    At least one element needs to be specified. Of one or more elements, as many elements as needed can be specified.

table:title Element

Describes the table heading.

Attribute:
class

Gives an element a class name. It can be a string.

If omitted, an attribute value is not assumed to be set.

id

Gives an element a unique identifier. It can be an ID value.

If omitted, an attribute value is not assumed to be set.

title

Used to give supplementary information to an element. It can be a string.

If omitted, an attribute value is not assumed to be set.

Content:

Within the table:title element, describe the table heading using PCDATA string.

table:style Element

Describes the style sheet applied to the table.

Attribute:
class

Gives an element a class name. It can be a string.

If omitted, an attribute value is not assumed to be set.

id

Gives an element a unique identifier. It can be an ID value.

If omitted, an attribute value is not assumed to be set.

title

Used to give supplementary information to an element. It can be a string.

If omitted, an attribute value is not assumed to be set.

type

Specifies the type of style sheet language. It can be a MIME-type string.

If omitted, text/css is assumed to be specified.

Content:

Within the table:style element, describes the style sheet applied to a table. Describes the style sheet using style sheet language specified within the type attribute.

table:column Element

Used to assign a label and column format to the table column.

Attribute:
class

Gives an element a class name. It can be a string.

If omitted, an attribute value is not assumed to be set.

id

Gives an element a unique identifier. It can be an ID value.

If omitted, an attribute value is not assumed to be set.

title

Used to give supplementary information to an element. It can be a string.

If omitted, an attribute value is not assumed to be set.

style

Used to describe a style sheet as an attribute value. It can be CSS format.

If omitted, an attribute value is not assumed to be set.

column-index

Specifies column index indicative of the column position. This can be an integer value greater than 1.

If omitted, the column index of the previous table:column element plus one is assumed to be set.

width

Specifies column width. It can be a positive number.

If omitted, the value specified within the column-width attribute of table:table element is applied.

Content:

The elements that can be specified within the table:column element are listed below.

table:row Element

Used to assign a label and row format to the table row.

Attribute:
class

Gives an element a class name. It can be a string.

If omitted, an attribute value is not assumed to be set.

id

Gives an element a unique identifier. It can be an ID value.

If omitted, an attribute value is not assumed to be set.

title

Used to give supplementary information to an element. It can be a string.

If omitted, an attribute value is not assumed to be set.

style

Used to describe a style sheet as an attribute value. It can be CSS format.

If omitted, an attribute value is not assumed to be set.

row-index

Specifies row index indicative of the row position. This can be an integer value greater than 1.

If omitted, the row index of the previous table:row element plus one is assumed to be set.

height

Sets row height. The value must be a positive number.

If omitted, the value specified within the row-height attribute of table:table element is applied.

Content:

The table:row element can contain the following elements.

table:label Element

Used to set a label to table's row and column.

Attribute:
class

Gives an element a class name. It can be a string.

If omitted, an attribute value is not assumed to be set.

id

Gives an element a unique identifier. It can be an ID value.

If omitted, an attribute value is not assumed to be set.

title

Used to give supplementary information to an element. It can be a string.

If omitted, an attribute value is not assumed to be set.

style

Used to describe a style sheet as an attribute value. It can be CSS format.

If omitted, an attribute value is not assumed to be set.

Content:

Within the table:label element, describe the string which will be assigned to table's row and column as a label.

table:cell Element

Element indicative of a cell in the table.

Attribute:
class

Gives an element a class name. It can be a string.

If omitted, an attribute value is not assumed to be set.

id

Gives an element a unique identifier. It can be an ID value.

If omitted, an attribute value is not assumed to be set.

title

Used to give supplementary information to an element. It can be a string.

If omitted, an attribute value is not assumed to be set.

style

Used to describe a style sheet as an attribute value. It can be CSS format.

If omitted, an attribute value is not assumed to be set.

column-index

Specifies column index of the column to which cell belongs. This can be an integer value greater than 1.

If omitted, the column index of the previous table:cell element plus one is assumed to be set.

Content:

Within the table:cell element, you can repeat any number of times to describe the combination of the following contents:

  • table:span Element
    The element can be specified, if needed.
    Optional.
  • table:a Element
    The element can be specified, if needed.
    Optional.
  • table:img Element
    The element can be specified, if needed.
    Optional.
  • table:br Element
    The element can be specified, if needed.
    Optional.
  • PCDATA string
    It can use any string as cell content.
    Optional.
  • external object
    Such object defined in the external namespace as SVC or XHTML may be specified.
    Optional.

table:span Element

Element available generally for any string.

Attribute:
class

Gives an element a class name. It can be a string.

If omitted, an attribute value is not assumed to be set.

id

Gives an element a unique identifier. It can be an ID value.

If omitted, an attribute value is not assumed to be set.

title

Used to give supplementary information to an element. It can be a string.

If omitted, an attribute value is not assumed to be set.

style

Used to describe a style sheet as an attribute value. It can be CSS format.

If omitted, an attribute value is not assumed to be set.

Content:

Within the table:span element, you can repeat any number of times to describe the combination of the following contents:

table:a Element

Used to set a link anchor.

Attribute:
class

Gives an element a class name. It can be a string.

If omitted, an attribute value is not assumed to be set.

id

Gives an element a unique identifier. It can be an ID value.

If omitted, an attribute value is not assumed to be set.

title

Used to give supplementary information to an element. It can be a string.

If omitted, an attribute value is not assumed to be set.

style

Used to describe a style sheet as an attribute value. It can be CSS format.

If omitted, an attribute value is not assumed to be set.

href

Specifies the linked document and the position of the document. It can be a URL string. It is not required to set the source for a link.

If omitted, an attribute value is not assumed to be set.

target

Specifies the name of the target frame which opens the destination document.

If omitted, it opens the destination document in the current frame. (If the current document is being edited, it may be opened in a new window. )

Content:

The following content can be specified within the table:a element:

  • table:span Element
    The element can be specified, if needed.
    Optional.
  • table:img Element
    The element can be specified, if needed.
    Optional.
  • table:br Element
    The element can be specified, if needed.
    Optional.
  • PCDATA string
    It can use any string as element content.
    Optional.

table:img Element

Used to embed image data.

Attribute:
class

Gives an element a class name. It can be a string.

If omitted, an attribute value is not assumed to be set.

id

Gives an element a unique identifier. It can be an ID value.

If omitted, an attribute value is not assumed to be set.

title

Used to give supplementary information to an element. It can be a string.

If omitted, an attribute value is not assumed to be set.

style

Used to describe a style sheet as an attribute value. It can be CSS format.

If omitted, an attribute value is not assumed to be set.

src (mandatory)

Specifies the location where image data, which will be embedded in the document, exists. It can be a URL string.

align

Specifies the spatial relationship between an image data and a string. Specify one of the following:

top
Aligns the image data's top with the string's top.
middle
Aligns the image data's middle with the string's baseline.
bottom
Aligns the image data's bottom with the string's baseline.
left
Position the image data at the left. The string wraps around the right side of the image data.
right
Position the image data at the right. The string wraps around the left side of the image data.

If omitted, bottom is assumed to be set.

width

Specifies the image data width in pixels. The value must be a positive number.

If omitted, the width of the image data is retrieved and used to determine the width.

height

Specifies the height of image data in pixels. The value must be a positive number.

If omitted, the height of the image data is retrieved and used to determine the width.

border

Specifies the thickness of the frame displayed around image data in pixels. The value must be a positive number.

If omitted, 0 is assumed to be set.

hspace

Specifies the size of area at the right and the left of image data in pixels. The value must be a positive number.

If omitted, 0 is assumed to be set.

vspace

Specifies the size of area at the top and the down of image data in pixels. The value must be a positive number.

If omitted, 0 is assumed to be set.

Content:

The table:img element is empty.

table:br Element

Used to break a line within a cell.

Attribute:

No attributes for the element.

Content:

The table:br element is empty.

2.2. Event Element

The event elements defined in the table description namespace are listed below. You don't write an event element to describe your XVCD. Describes the event elements with platform.

table:column-width-changed event

Indicates that the table's column width is changed. This event occurs in the table:table element.

Attribute:
column-index (mandatory)

Specifies the column index whose column width is changed. This can be an integer value greater than 1.

width (mandatory)

Sets the changed column width in pixels. The value must be a positive number.

Content:

The table:column-width-changed element is empty.

table:row-height-changed event

Indicates that the table's row height is changed. This event occurs in the table:table element.

Attribute:
row-index (mandatory)

Specifies the row index whose row height is changed. This can be an integer value greater than 1.

height (mandatory)

Sets the changed row height in pixels. The value must be a positive number.

Content:

The table:row-height-changed element is empty.