Display attributes is a parameter entity declaration in the topic DTD that includes attributes whose values may be used for affecting the display of a topic or its selection by search tools.

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


Name Description Data Type Default Value Required?
scale Specifies a percentage, selected from an enumerated list, that is used to resize fonts in relation to the normal text size. DITA processing does not support this attribute for XHTML output.

The scale attribute provides an acknowledged style-based property directly on DITA elements. It will be deprecated in favor of external style specifications. 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 accomodation. 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.

(50 | 60 | 70 | 80 | 90 | 100 | 110 | 120 | 140 | 160 | 180 |200) #IMPLIED No
frame Specifies which portion of a border should surround the element. Allowable values are:
Draw a line before the element
Draw a line after the element
Draw a line both before and after the element
Draw a box around the element
Draw a line at each side of the element
Don't draw any lines around this element
DITA processing for XHTML output supports only top, bottom, and topbot rules.
(top | bottom | topbot | all | sides | none) #IMPLIED No
expanse Determines the horizontal placement of the element.

For PDF, allowable values are: "page" places the element on the left page margin; "column" aligns the element with the current column margin; "textline" aligns the element with the left margin of the current text line and takes indention into account.

For XHTML, allowable values are textline only. The table surrounds the table data. Column and page set the table width to 100%.

For DITA tables, this attribute is replaced instead by pgwide="0 or 1".

(page | column | textline) #IMPLIED No


The %display-atts; parameter entity is used within the DITA dtds as a common definition for attributes that affect presentation of certain elements. Not all of these capabilities have been provided yet for DITA topic processing. A typical example might be:

<codeblock scale="90" frame="topbot" expanse="page">
/* a long sample program */
Do forever
  Say "Hello, World"

OASIS DITA Language Specification v1.0 -- 09 May 2005
Copyright (c) OASIS Open 2005. All Rights Reserved.