display-atts attribute group

The "display-atts" attribute group includes attributes whose values may be used for affecting the display of a topic or element.

Attributes

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. 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 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. Some DITA processors or output formats may not be able to support all values.	(50 \| 60 \| 70 \| 80 \| 90 \| 100 \| 110 \| 120 \| 140 \| 160 \| 180 \| 200 \| -dita-use-conref-target)	#IMPLIED	No
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 may not be able to support all values.	(top \| bottom \| topbot \| all \| sides \| none \| -dita-use-conref-target)	#IMPLIED	No
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. This attribute has a similar semantic (1=page width; 0=resize to galley or column). Some DITA processors or output formats may not be able to support all values.	(page \| column \| textline \| spread \| -dita-use-conref-target)	#IMPLIED	No

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. 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 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.

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

(50 | 60 | 70 | 80 | 90 | 100 | 110 | 120 | 140 | 160 | 180 | 200 | -dita-use-conref-target)

#IMPLIED

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 may not be able to support all values.

#IMPLIED

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. This attribute has a similar semantic (1=page width; 0=resize to galley or column).

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

(page | column | textline | spread | -dita-use-conref-target)

#IMPLIED

Example

The "display-atts" attribute group is used within the DITA DTDs and schemas as a common definition for attributes that affect presentation of certain elements. A typical example might be:

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

3.4.1.1 display-atts attribute group

Attributes

Example