Home
Graphics and figures
Image alignment, placement, and sizing
The align, placement, width, and height attributes of the image element are used to specify the placement and size of images when generated to an output delivery format.

Introduction
Information types and topics
Topics are the building blocks of modular documents, and organising topics by semantic information types is one of the architectural features of DITA.
DITA map files
Syntax and mark-up
Language and punctuation
Graphics and figures
- Figures and images
  Images are placed in topic content using the image element. The image element can stand alone, or can be contained within a figure (fig) element.
- Image file formats
  Where there is no strong reason to choose another image file format, you should use SVG or PNG file formats in DITA topics.
- Image alignment, placement, and sizing
  The align, placement, width, and height attributes of the image element are used to specify the placement and size of images when generated to an output delivery format.
- Images in titles
  Images in topic, figure, and other titles, while technically valid, should not be used.
- Callouts
  Callouts with keys, rather than text labels, should be used when identifying parts of an illustration.
- Localising graphics
  Where possible, graphics that include text should be managed in SVG format to simplify localisation.
- Multimedia in DITA topics
  The object element is used to embed multimedia in DITA topics.
- Figures containing tables
  Simple tables can be contained within figures instead of, or in addition to, images.
- Image maps
  The imagemap element is used to define image maps (hotspot graphics) in DITA topics.
- WAI compliance
  So that output from your DITA source meets accessibility responsibilities, you must include alternative text representations of all images in DITA content.
Cross-referencing
Cross-references are a means of binding individual topics into a coherent and navigable document.
Content re-use
Metadata, conditional processing, and indexing
The DITA documentation process
DITA authoring concepts
Moving from style-based authoring to a structured authoring methodology such as DITA requires a radically different approach to writing.

Image alignment, placement, and sizing

The align, placement, width, and height attributes of the image element are used to specify the placement and size of images when generated to an output delivery format.

The placement of the image on the output page or screen is defined in the placement and align attributes. The placement attribute can be set to inline (placing the image inline with the text in the paragraph in which it is placed) or break (placing the image in its own block, with space above and below it). The align attribute has valid values of left, right, center and current. These values specify how the image will be aligned on the page or screen. The align attribute only has an effect if the placement is set to break.

To display the image in its own block, use the image element independently of a paragraph element, set the placement attribute to break, and the alignment to left, right, or center.

To display an image within a paragraph or other block element, set the placement attribute to inline, and either omit the align attribute or set it to current (to inherit the alignment settings of the element in which the image is contained).

The image element includes height and width attributes. These attributes are used to store the intended display height and width of the image in the output, expressed in one of a variety of units, including pixels (px), centimetres (cm), points (pt) and inches (in).