Table Markup
Table Markup: Dynamic Table Formatting
Table Markup allows dynamically changing the interpretation and presentation of table content, on a cell-by-cell basis, overriding the default interpretation and formatting of table content that was described in Table Basics. Table Markup includes commands for changing the cell type (image or text), the content size, and for inserting row breaks.On This Page
Notes on UsageRow Break Markup
Table Type Markup
Image Fit Markup
Content Size Markup
Notes on Usage
In all cases, Table Markup commands must precede all printable content within their field. It is usually permitted for a field to include more than one Table Markup command; exceptions are noted below.Some examples:
The third example above (in red text) is incorrect, because the printable content ImageTwo is followed by markup which should have preceded it.
Note that Rich Text markup may as usual occur anywhere within a text field's content, as appropriate. Only Table Format markup is required to precede all printable content.
Row Break Markup
{@/} - This markup causes a "row break". The remainder of the row (as drawn on the card) will be empty, and the next content will appear in the leftmost column of the following row.
Important: Row break markup must be the only content in its field.
This is an exception to the usual rule that
printable content may follow Table Markup within a field. Example:
There are several uses for Row Break markup. First, you can leave cells at the end of a row empty and continue on the next row down, without having to insert the right number of commas in your content to denote the empty cells.
Another important use is to combine this markup with the Center-Align Rows option (found in the Table Format dialog). A row will be center-aligned if the option is turned on and the number of cells specified for the row in the content is less than the number of columns in the table. Without the row-break markup, each cell will be given content in left-to-right, top-to-bottom order, so that each row except the last will always be full (even if some cells have empty content). To cut a row short and have it be centered, you must use the row-break markup.
Note that if the table's Center-Align Rows option is selected, then a "short" row may be shifted to the right so that its content appears centered within the table item. This means that cells may not all be placed in aligned columns.
Finally, if you select the cell border option "All cells up to row break" then cells in a row beyond the row break will not be given borders, but empty cells before a row break will get borders. This is different from the option "Non-empty cells only" which will never draw a border around any empty cell.
Table Type Markup
These markup commands effectively change the type of the table:
{@i} makes the table type "Image" for the current cell.
{@i*} makes the table type "Image" for the current and following cells
(until and unless another Table Type markup command is found).
{@t} makes the table type "Text" for the current cell.
{@t*} makes the table type "Text" for the current and following cells
(until and unless another Table Type markup command is found).
Examples:
Note that the forms without an asterisk affect only their own single cell, while those with an asterisk have a continuing effect on subsequent cells.
Image Fit Markup
Image Fit markup dynamically changes the Image Fit setting, either for a specific cell or for all cells following the markup until the next occurrence of Image Fit markup if any. The Image Fit feature affects only image cells, and has no effect on text or on inline images within text.
See Font and Image Effects for more information about Image Fit options.
Content Size Markup
Content Size markup dynamically changes the Content Size, either for a specific cell or for all cells following the markup until the next occurrence of such markup if any.There are five forms for Content Size Markup. In all of them, the w,h portion of the markup must be two comma-separated integer values, which specify the width and height of the new content size in points. Width and height must normally be positive values, but as a special case you may use {0,0} to restore the default content size.
Here are the five forms of content size markup:
The {w,h} form is deprecated. It does not follow the usual rules for Table Type markup: it must be the only content in its cell, and it ignores the Image Fit option you have specified by instead always stretching images to fit. If you have been using this form, please convert your projects soon to instead use the other forms.
We recommend that you use the Content Size controls in the Table Format window and the Image Fit options in the Effects panel, instead of specifying sizes in content because it is simpler and will usually give you what you want. But if you have special needs, specifying sizes in content may be useful to you.
Here's an example of six images, where image3 is smaller than the rest:
In this example, the first markup command {@is*:40,60} sets the new default content size for image1 and all subsequent images (overriding the content size set in the Table Format window). Then the next constraint {@is:20,20} overrides that new default but just for image3. For image4 and the rest, the new default content size of 40,60 (set by the first markup command) continues to be used.