DITA Resource Center

Display attribute group

The display attribute group includes attributes whose values can be used for affecting the display of many elements.
@expanse
Determines the horizontal placement of the element. Allowable values are:
page
Places the element on the left page margin for left-to-right presentation, or right page margin for right-to-left presentation.
column
Aligns the element with the current column margin
textline
Aligns the element with the left (for left to right presentation) or right (for right to left presentation) margin of the current text line and takes indention into account.
spread
Indicates that, if possible, the object should be rendered across a multi-page spread. If the rendition target does not have anything corresponding to spreads then spread has the same meaning as "page".
-dita-use-conref-target
See Using the -dita-use-conref-target value for more information.

In DITA tables, in place of the @expanse attribute used by other DITA elements, the @pgwide attribute is used in order to conform to the OASIS Exchange Table Model. The @pgwide attribute has a similar semantic (1=page width; 0=resize to galley or column).

Some DITA processors or output formats might not be able to support all values.

@frame
Specifies which portion of a border should surround the element. Allowable values are:
top
Draw a line before the element
bottom
Draw a line after the element
topbot
Draw a line both before and after the element
all
Draw a box around the element
sides
Draw a line at each side of the element
none
Don't draw any lines around this element
-dita-use-conref-target
See Using the -dita-use-conref-target value for more information.

Some DITA processors or output formats might not be able to support all values.

@scale
Specifies a percentage, selected from an enumerated list, that is used to resize fonts in relation to the normal text size. This attribute is primarily useful for print-oriented display.

The @scale attribute provides an acknowledged style-based property directly on DITA elements. For the <table> and <fig> elements, the intent of the property is to allow authors to adjust font sizes on the content of the containing element, primarily for print accommodation. An <image> in these contexts is to be scaled only by its own direct scale property. If not specifically scaled, such an <image> is unchanged by the scale property of its parent <table> or <fig>.

Allowable values are 50, 60, 70, 80, 90, 100, 110, 120, 140, 160, 180, 200, and -dita-use-conref-target. Some DITA processors or output formats might not be able to support all values.

Was this page helpful?