dblatex table-width
Prev | Tables | Next

## dblatex table-width

`<?dblatex `table-width`?>` — Control the Automatic Width of a Table

## Synopsis

    <?dblatex table-width="12cm" ?>

## Description

Set the width of a table. Used only when there is at least one column in the table without a fixed width, the `table-width` has precedence over other determinants of a table's width.

The `table.width` takes the values allowed for the default.table.width param, plus more. The values shared with default.table.width are:

- A valid length (e.g. 15cm),

- A percentage of the page width (e.g. 75%),

- A keyword telling to apply an automatic column width (e.g. autowidth.all).

## Automatic Column Width

If you want to apply an automatic width only to some specific tables you can put the Processing Instruction `<?dblatex table-with="autowidth.`scope`" ?>` in the related tables. The PI has precedence over the `newtbl.autowidth` parameter.

The `scope` can take the following values, like in the `newtbl.autowidth` parameter:

default

  The automatic width (that is, latex is in charge to size the column width) is applied only to columns not having a specified `colspec` colwidth. It includes both undefined `colspec`, and `colspec` without the colwidth attribute.

all

  the automatic width is applied to any column, whether a colspec is provided or not.

In addition to these keywords, `table.width` can also take for its value keywords of the form `autowidth.column: `N``...``, where `N` is the number of the column (counting from 1) which is to have its width automatically sized.

There is no default.

## Context

Recognized in the `table` element.

## See Also

- the section called “Table Width”
- the section called “Local Setting”
- default.table.width
- newtbl.autowidth

Prev | Up | Next
dblatex bgcolor | Home | Lists