Table of contents

Appendices

7.26 Table Properties

border-after-precedence[top]

XSL Definition:

force

The precedence is higher than any <integer>.

<integer>

A numeric precedence specification. A higher value has a higher precedence than a lower one.

Specifies the precedence of the border specification on this formatting object for the border-after.

border-before-precedence[top]

XSL Definition:

Specifies the precedence of the border specification on this formatting object for the border-before.

See definition of property border-after-precedence ( [border-after-precedence] ).

border-collapse[top]

CSS2 Definition:

CSS2 Reference: [ "border-collapse" property ] http://www.w3.org/TR/REC-CSS2/tables.html#propdef-border-collapse

collapse

The value "collapse" selects the collapsing borders model.

separate

The value "separate" selects the separated borders border model.

This property selects a table's border model. The value "separate" selects the separated borders border model. The value "collapse" selects the collapsing borders model.

XSL modifications to the CSS definition:

XSL adds the following value with the following meaning:

collapse-with-precedence

The value "collapse-with-precedence" selects the collapsing borders model and the use of the border precedence properties for conflict resolution.

border-end-precedence[top]

XSL Definition:

Specifies the precedence of the border specification on this formatting object for the border-end.

See definition of property border-after-precedence ( [border-after-precedence] ).

border-separation[top]

XSL Definition:

<length-bp-ip-direction>

The lengths specify the distance that separates adjacent cell borders in the row-stacking-direction (given by the block-progression-direction of the table), and in the column-stacking-direction (given by the inline-progression-direction of the table).

In the separate borders model, each cell has an individual border. The "border-separation" property specifies the distance between the borders of adjacent cells. This space is filled with the background of the table element. Rows, columns, row groups, and column groups cannot have borders (i.e., user agents must ignore the border properties for those elements).

border-start-precedence[top]

XSL Definition:

Specifies the precedence of the border specification on this formatting object for the border-start.

See definition of property border-after-precedence ( [border-after-precedence] ).

caption-side[top]

CSS2 Definition:

CSS2 Reference: [ "caption-side" property ] http://www.w3.org/TR/REC-CSS2/tables.html#q6

top

Positions the caption box above the table box.

bottom

Positions the caption box below the table box.

left

Positions the caption box to the left of the table box.

right

Positions the caption box to the right of the table box.

This property specifies the position of the caption box with respect to the table box.

Captions above or below a "table" element are formatted very much as if they were a block element before or after the table, except that (1) they inherit inheritable properties from the table, and (2) they are not considered to be a block box for the purposes of any "compact" or "run-in" element that may precede the table.

A caption that is above or below a table box also behaves like a block box for width calculations; the width is computed with respect to the width of the table box's containing block.

For a caption that is on the left or right side of a table box, on the other hand, a value other than "auto" for "width" sets the width explicitly, but "auto" tells the user agent to chose a "reasonable width". This may vary between "the narrowest possible box" to "a single line", so we recommend that users do not specify "auto" for left and right caption widths.

To align caption content horizontally within the caption box, use the "text-align" property. For vertical alignment of a left or right caption box with respect to the table box, use the "vertical-align" property. The only meaningful values in this case are "top", "middle", and "bottom". All other values are treated the same as "top".

XSL modifications to the CSS definition:

Insert the following writing-mode relative values:

before

Positions the caption before the table in the block-progression-direction.

after

Positions the caption after the table in the block-progression-direction.

start

Positions the caption before the table in the inline-progression-direction.

end

Positions the caption after the table in the inline-progression-direction.

The CSS qualifications (1) and (2) do not apply. The last three sentences in the last paragraph (referencing "vertical-align") do not apply.

column-number[top]

XSL Definition:

<integer>

A positive integer. If a negative or non-integer value is provided, the value will be rounded to the nearest integer value greater than or equal to 1.

For an fo:table-column formatting object, it specifies the column-number of the table cells that may use properties from this fo:table-column formatting object by using the from-table-column() function. The initial value is 1 plus the column-number of the previous table-column, if there is a previous table-column, and otherwise 1.

For an fo:table-cell it specifies the number of the first column to be spanned by the table-cell. The initial value is the current column-number. For the first table-cell in a table-row, the current column number is 1. For other table-cells, the current column-number is the column-number of the previous table-cell in the row plus the number of columns spanned by that previous cell.

NOTE: 

There is no requirement for column-numbers to be monotonically increasing from formatting object to formatting object.

column-width[top]

XSL Definition:

<length>

The "column-width" property specifies the width of the column whose value is given by the "column-number" property. This property, if present, is ignored if the "number-columns-spanned" property is greater than 1. The "column-width" property must be specified for every column, unless the automatic table layout is used.

NOTE: 

The use of the "proportional-column-width()" function is only permitted when the fixed table layout is used.

If the use of proportional column widths are desired on a table of an unknown explicit width, the inline-progression-dimension cannot be specified to be "auto". Instead, the width must be specified as a percentage. For example, setting table-layout="fixed" and inline-progression-dimension="100%" would allow proportional column widths while simultaneously creating a table as wide as possible in the current context.

NOTE: 

The result of using a percentage for the width may be unpredictable, especially when using the automatic table layout.

empty-cells[top]

CSS2 Definition: as amended by [http://www.w3.org/Style/css2-updates/REC-CSS2-19980512-errata.html#x79]

CSS2 Reference: [ "empty-cells" property ] http://www.w3.org/TR/REC-CSS2/tables.html#propdef-empty-cells

show

When this property has the value "show", borders are drawn around empty cells (like normal cells).

hide

A value of "hide" means that no borders are drawn around empty cells. Furthermore, if all the cells in a row have a value of "hide" and have no visible content, the entire row behaves as if it had "display: none".

In the separated borders model, this property controls the rendering of borders around cells and the rendering of the background of cells that have no visible content. Empty cells and cells with the "visibility" property set to "hidden" are considered to have no visible content. Visible content includes "&nbsp;" (non-breaking-space) and other whitespace except ASCII CR ("\0D"), LF ("\0A"), tab ("\09"), and space ("\20").

ends-row[top]

XSL Definition:

true

This cell ends a row.

false

This cell does not end a row.

Specifies whether this cell ends a row. This is only allowed for table-cells that are not in table-rows.

number-columns-repeated[top]

XSL Definition:

<integer>

A positive integer. If a negative or non-integer value is provided, the value will be rounded to the nearest integer value greater than or equal to 1.

The "number-columns-repeated" property specifies the repetition of a table-column specification n times; with the same effect as if the fo:table-column formatting object had been repeated n times in the result tree. The "column-number" property, for all but the first, is the column-number of the previous one plus its value of the "number-columns-spanned" property.

NOTE: 

This handles HTML's "colgroup" element.

number-columns-spanned[top]

XSL Definition:

<integer>

A positive integer. If a negative or non-integer value is provided, the value will be rounded to the nearest integer value greater than or equal to 1.

For an fo:table-column the "number-columns-spanned" property specifies the number of columns spanned by table-cells that may use properties from this fo:table-column formatting object using the from-table-column() function.

For an fo:table-cell the "number-columns-spanned" property specifies the number of columns which this cell spans in the column-progression-direction starting with the current column.

number-rows-spanned[top]

XSL Definition:

<integer>

A positive integer. If a negative or non-integer value is provided, the value will be rounded to the nearest integer value greater than or equal to 1.

The "number-rows-spanned" property specifies the number of rows which this cell spans in the row-progression-direction starting with the current row.

starts-row[top]

XSL Definition:

true

This cell starts a row.

false

This cell does not start a row.

Specifies whether this cell starts a row. This is only allowed for table-cells that are not in table-rows.

NOTE: 

The "starts-row" and "ends-row" properties with a "true" value are typically used when the input data does not have elements containing the cells in each row, but instead, for example, each row starts at elements of a particular type.

table-layout[top]

CSS2 Definition:

CSS2 Reference: [ "table-layout" property ] http://www.w3.org/TR/REC-CSS2/tables.html#propdef-table-layout

fixed

Use the fixed table layout algorithm

auto

Use any automatic table layout algorithm

The "table-layout" property controls the algorithm used to lay out the table cells, rows, and columns.

table-omit-footer-at-break[top]

XSL Definition:

true

This property specifies that the footer should be omitted.

false

This property specifies that the footer should not be omitted.

The "table-omit-footer-at-break" property specifies if a table whose last area is not at the end of an area produced by the table should end with the content of the fo:table-footer formatting object or not.

table-omit-header-at-break[top]

XSL Definition:

true

This property specifies that the header should be omitted.

false

This property specifies that the header should not be omitted.

The "table-omit-header-at-break" property specifies if a table whose first area is not at the beginning of an area produced by the table should start with the content of the fo:table-header formatting object or not.