A float is a piece of content that can be repositioned to appear at the top or bottom of a page. This is often used to make the text flow around large objects like images or tables to avoid large areas of empty space on the page and to avoid breaks in the text.

A float is created by capturing some content (typically by using the scan and suppress mapping properties) and using it with the float command.

The position in the content where the float command is issued is called the reference point of the float. The position of the float is subject to the following constraints:

  • A float will always be positioned after its reference point.

  • The width of a float is determined by the layout in effect for its reference point. If the layout page type is changed any pending floats are rendered in the current format before the new format takes effect.

The <float-properties/> command allows you to control aspects of float placement, such as how much space to leave between a float and the page content, and the maximum percentage of a page that can be occupied by floats.