7 Formatting Properties

7.1 Description of Property Groups

The following sections describe the properties of the XSL formatting objects.

A number of properties are copied from the CSS2 specification. In addition, the CSS2 errata all apply. See [CSS2].

• The first eight sets of property definitions have been arranged into groups based on similar functionality and the fact that they apply to many formatting objects. In the formatting object descriptions the group name is referred to rather than referring to the individual properties.

  • Common Absolute Position Properties

    This set of properties controls the position and size of formatted areas with absolute positioning.

  • Common Aural Properties

    This group of properties controls the aural rendition of the content of a formatting object. They appear on all formatting objects that contain content and other formatting objects that group other formatting objects and where that grouping is necessary for the understanding of the aural rendition. An example of the latter is fo:table-and-caption.

  • Common Border, Padding, and Background Properties

    This set of properties controls the backgrounds and borders on the block-areas and inline-areas.

  • Common Font Properties

    This set of properties controls the font selection on all formatting objects that can contain text.

  • Common Hyphenation Properties

    Control of hyphenation for line-breaking, including language, script, and country.

  • Common Margin Properties-Block

    These properties set the spacing and indents surrounding block-level formatting objects.

  • Common Margin Properties-Inline

    These properties set the spacing surrounding inline-level formatting objects.

• The remaining properties are used on a number of formatting objects. These are arranged into clusters of similar functionality to organize the property descriptions. In the formatting object description the individual properties are referenced.

  • Area Alignment Properties

    Properties that control the alignment of inline-areas with respect to each other, particularly in relation to the mixing of different baselines for different scripts. In addition, there are two properties: "display-align" and "relative-align" that control the placement of block-areas.

  • Area Dimension Properties

    Properties that control the dimensions of both block-areas and inline-areas.

  • Block and Line-related Properties

    Properties that govern the construction of line-areas and the placement of these line-areas within containing block-areas.

  • Character Properties

    Properties that govern the presentation of text, including word-spacing, letter-spacing, and word-space treatment and suppression.

  • Color-related Properties

    Properties that govern color and color-model selection.

  • Float-related properties

    Properties governing the placement of both side-floats (start- and end-floats) and before-floats ("top" floats in "lr-tb" writing-mode).

  • Keeps and Breaks Properties

    Properties that control keeps and breaks across pages, columns, and lines, including widow and orphan control and keeping content together.

  • Layout-related Properties

    These properties control what is "top" ("reference-orientation") as well as clipping, overflow, and column-spanning conditions.

  • Leader and Rule Properties

    Properties governing the construction of leaders and horizontal rules.

  • Properties for Links

    Properties governing the presentation and actions associated with links.

  • Properties for Markers

    Properties governing the creation and retrieval of markers. Markers are used typically for "dictionary" headers and footers.

  • Properties for Number to String Conversions

    Properties used in the construction of page-numbers and other formatter-based numbering.

  • Pagination and Layout Properties

    These properties govern the sequencing, layout, and instantiation of pages, including: the page size and orientation, sizes of regions on the page-master, the identification and selection of page-masters, division of the body region into columns, and the assignment of content flows to layout regions.

  • Table Properties

    Properties governing the layout and presentation of tables.

  • Writing-mode-related Properties

    Properties related to various aspects of "directionality" and writing-mode influencing block-progression-direction and inline-progression-direction.

  • Miscellaneous Properties

    These properties did not reasonably fit into any of the other categories.

• Shorthand Properties

  Shorthand properties that are part of the complete conformance set. Shorthands expand to the individual properties that may be used in place of shorthands.

7.2 XSL Areas and the CSS Box Model

This section describes how to interpret property descriptions which incorporate the CSS2 definition of the same property. In CSS2, "boxes" are generated by "elements" in the same way that XSL areas are generated by formatting objects. Any references in the CSS2 definition to "boxes" are to be taken as referring to "areas" in the XSL area model, and where "element" appears in a CSS2 definition it should be taken to refer to a "formatting object".

The position and size of a box are normally taken to refer to the position and size of the area's content-rectangle. Additional correspondences between the CSS2 Box Model and the XSL Area Model are contained in the following table.

Box margins map to area traits in accordance with the description of how area traits are computed from property values in[5 Property Refinement / Resolution].

7.3 Common Accessibility Properties

7.3.1 "source-document"

XSL Definition:

Values have the following meanings:

none

The source document is transient, unknown, or unspecified.

<uri>

A list of space-separated URIs, indicating the XML document(s) used as input to the stylesheet.

This property provides a pointer back to the original XML document(s) used to create this formatting object tree. It is useful for alternate renderers (aural readers, etc.) whenever the structure of the formatting object tree is inappropriate for that renderer.

7.3.2 "role"

XSL Definition:

It is used by all formatting objects that can be contained in fo:flow or fo:static-content (all formatting objects that can be directly created from an XML source element).

Values have the following meanings:

none

Indicates that no semantic tag is cited by this formatting object.

<string>

The value is a string representing a semantic that may be used in rendering this formatting object. It can, for example, be an element name in some known semantic vocabulary, such as HTML, or a particular Web Accessibility Initiative (WAI) semantic vocabulary.

This provides a hint for alternate renderers (aural readers, etc.) as to the role and potential alternate presentation of the content of this formatting object.

This property is not inherited, but all subsidiary nodes of this formatting object that do not bear a role property should utilize the same alternate presentation properties. (It is not inherited because knowledge of the start and end of the formatting object subtree generated by the element may be needed by the renderer.)

7.4 Common Absolute Position Properties

7.4.1 "absolute-position"

7.4.2 "top"

XSL modifications to the CSS definition:

See definition of property left ([7.4.5 "left"]).

7.4.3 "right"

XSL modifications to the CSS definition:

See definition of property left ([7.4.5 "left"]).

7.4.4 "bottom"

XSL modifications to the CSS definition:

See definition of property left ([7.4.5 "left"]).

7.4.5 "left"

XSL modifications to the CSS definition:

These properties set the position of the content-rectangle of the associated area.

If both "top" and "bottom" are specified, the height of the content-rectangle is overridden. If both "left" and "right" are specified, the width of the content-rectangle is overridden.

7.5 Common Aural Properties

7.5.1 "azimuth"

7.5.2 "cue-after"

7.5.3 "cue-before"

7.5.4 "elevation"

7.5.5 "pause-after"

7.5.6 "pause-before"

7.5.7 "pitch"

7.5.8 "pitch-range"

7.5.9 "play-during"

7.5.10 "richness"

7.5.11 "speak"

7.5.12 "speak-header"

7.5.13 "speak-numeral"

7.5.14 "speak-punctuation"

7.5.15 "speech-rate"

7.5.16 "stress"

7.5.17 "voice-family"

7.5.18 "volume"

7.6 Common Border, Padding, and Background Properties

The following common-border-padding-and-background-properties are taken from CSS2. Those "border", "padding", and "background" properties that have a before, after, start, or end suffix are writing-mode relative and are XSL-only properties.

7.6.1 "background-attachment"

XSL modifications to the CSS definition:

The last paragraph in the CSS description does not apply.

7.6.2 "background-color"

XSL modifications to the CSS definition:

XSL adds an "icc-color" function as a valid value of this property.

7.6.3 "background-image"

7.6.4 "background-repeat"

XSL modifications to the CSS definition:

"Horizontal" and "vertical" are defined relative to the reference-orientation; "horizontal" is "left" to "right", and "vertical" is "top" to "bottom".

NOTE:

Thus for a rotated area the tiling is also rotated. It is, however, independent of the writing-mode.

7.6.5 "background-position-horizontal"

7.6.6 "background-position-vertical"

7.6.7 "border-before-color"

7.6.8 "border-before-style"

7.6.9 "border-before-width"

XSL modifications to the CSS definition:

The following value type has been added for XSL:

<length-conditional>

A compound value specifying the width and any conditionality of the border for the before-edge.

The .length component is a <length>. The .conditionality component may be set to "discard" or "retain" to control if the border should be 0 or retained if it's associated edge is a leading-edge in a reference-area for areas generated from this formatting object that have an is-first value of "false". See [4.3 Spaces and Conditionality] for further details. The initial value of the .conditionality component is "retain".

NOTE:

If the border-style is "none" the computed value of the width is forced to "0pt".

7.6.10 "border-after-color"

7.6.11 "border-after-style"

7.6.12 "border-after-width"

XSL modifications to the CSS definition:

The following value type has been added for XSL:

<length-conditional>

A compound value specifying the width and any conditionality of the border for the after-edge.

The .length component is a <length>. The .conditionality component may be set to "discard" or "retain" to control if the border should be 0 or retained if it's associated edge is a trailing-edge in a reference-area for areas generated from this formatting object that have an is-last value of "false". See [4.3 Spaces and Conditionality] for further details. The initial value of the .conditionality component is "retain".

NOTE:

If the border-style is "none" the computed value of the width is forced to "0pt".

7.6.13 "border-start-color"

7.6.14 "border-start-style"

7.6.15 "border-start-width"

7.6.16 "border-end-color"

7.6.17 "border-end-style"

7.6.18 "border-end-width"

7.6.19 "border-top-color"

7.6.20 "border-top-style"

7.6.21 "border-top-width"

7.6.22 "border-bottom-color"

7.6.23 "border-bottom-style"

7.6.24 "border-bottom-width"

7.6.25 "border-left-color"

7.6.26 "border-left-style"

7.6.27 "border-left-width"

7.6.28 "border-right-color"

7.6.29 "border-right-style"

7.6.30 "border-right-width"

7.6.31 "padding-before"

XSL modifications to the CSS definition:

The following value type has been added for XSL:

<length-conditional>

A compound value specifying the width and any conditionality of the padding for the before-edge.

The .length component is a <length>. The .conditionality component may be set to "discard" or "retain" to control if the padding should be 0 or retained if it's associated edge is a leading-edge in a reference-area for areas generated from this formatting object that have an is-first value of "false". See [4.3 Spaces and Conditionality] for further details. The initial value of the .conditionality component is "retain".

7.6.32 "padding-after"

XSL modifications to the CSS definition:

The following value type has been added for XSL:

<length-conditional>

A compound value specifying the width and any conditionality of the padding for the after-edge.

The .length component is a <length>. The .conditionality component may be set to "discard" or "retain" to control if the padding should be 0 or retained if it's associated edge is a trailing-edge in a reference-area for areas generated from this formatting object that have an is-last value of "false". See [4.3 Spaces and Conditionality] for further details. The initial value of the .conditionality component is "retain".

7.6.33 "padding-start"

7.6.34 "padding-end"

7.6.35 "padding-top"

7.6.36 "padding-bottom"

7.6.37 "padding-left"

7.6.38 "padding-right"

7.7 Common Font Properties

The following common-font-properties all are taken from CSS2. The reference to CSS2 is: http://www.w3.org/TR/REC-CSS2/fonts.html

NOTE:

Although these properties reference the individual properties in the CSS specification, it is recommended that you read the entire font section of the CSS2 specification.

7.7.1 "font-family"

XSL modifications to the CSS definition:

<string>

The names are syntactically expressed as strings.

NOTE:

See the expression language for a two-argument "system-font" function that returns a characteristic of a system-font. This may be used, instead of the "font" shorthand, to specify the name of a system-font.

7.7.2 "font-size"

7.7.3 "font-stretch"

7.7.4 "font-size-adjust"

7.7.5 "font-style"

XSL modifications to the CSS definition:

The following value type has been added for XSL:

backslant

Specifies a font that is classified as "backslant" in the UA's font database.

7.7.6 "font-variant"

7.7.7 "font-weight"

7.8 Common Hyphenation Properties

7.8.1 "country"

XSL Definition:

Values have the following meanings:

none

Indicates the country is unknown or is not significant to the proper formatting of this object.

<country>

A country-specifier in conformance with [RFC1766].

Specifies the country to be used by the formatter in language-/locale-coupled services, such as line-justification strategy, line-breaking, and hyphenation.

NOTE:

This may affect line composition in a system-dependent way.

The country may be the country component of any RFC 1766 code (these are derived from ISO 3166).

7.8.2 "language"

XSL Definition:

Values have the following meanings:

none

Indicates the language is unknown or is not significant to the proper formatting of this object.

<language>

A language-specifier in conformance with [RFC1766].

Specifies the language to be used by the formatter in language-/locale-coupled services, such as line-justification strategy, line-breaking, and hyphenation.

NOTE:

This may affect line composition in a system-dependent way.

The language may be the language component of any RFC 1766 code (these are derived from the ISO 639 language codes).

7.8.3 "script"

XSL Definition:

Values have the following meanings:

auto

Indicates that the script is determined using codepoint ranges in the text of the document.

NOTE:

This provides the automatic differentiation between Kanji, Katakana, Hiragana, and Romanji used in JIS-4051 and similar services in some other countries/languages.

none

Indicates the script is unknown or is not significant to the proper formatting of this object.

<script>

A script specifier in conformance with [ISO15924].

Specifies the script to be used by the formatter in language-/locale-coupled services, such as line-justification strategy, line-breaking, and hyphenation.

NOTE:

This may affect line composition in a system-dependent way.

The script may be any ISO 15924 script code.

7.8.4 "hyphenate"

XSL Definition:

Values have the following meanings:

false

Hyphenation may not be used in the line-breaking algorithm for the text contained in this object.

true

Hyphenation may be used in the line-breaking algorithm for the text contained in this object.

Specifies whether hyphenation is allowed during line-breaking when the formatter is formatting this formatting object.

7.8.5 "hyphenation-character"

XSL Definition:

Values have the following meanings:

<character>

Specifies the Unicode character to be presented when a hyphenation break occurs. The styling properties of this character are those inherited from its containing flow object.

7.8.6 "hyphenation-push-character-count"

XSL Definition:

Values have the following meanings:

<integer>

If a negative or non-integer value is specified, it will be rounded to the nearest integer greater than zero.

The hyphenation-push-character-count is a positive integer specifying the minimum number of characters in a hyphenated word after the hyphenation character. This is the minimum number of characters in the word pushed to the next line after the line ending with the hyphenation character.

7.8.7 "hyphenation-remain-character-count"

XSL Definition:

Values have the following meanings:

<integer>

If a negative or non-integer value is specified, it will be rounded to the nearest integer greater than zero.

The hyphenation-remain-character-count is a positive integer specifying the minimum number of characters in a hyphenated word before the hyphenation character. This is the minimum number of characters in the word left on the line ending with the hyphenation character.

7.9 Common Margin Properties-Block

7.9.1 "margin-top"

XSL modifications to the CSS definition:

• Margin-top is provided for compatibility with CSS.

• Details on the mapping of CSS "margin" properties for XSL are given in [5 Property Refinement / Resolution].

7.9.2 "margin-bottom"

XSL modifications to the CSS definition:

• Margin-bottom is provided for compatibility with CSS.

• Details on the mapping of CSS "margin" properties for XSL are given in [5 Property Refinement / Resolution].

7.9.3 "margin-left"

XSL modifications to the CSS definition:

• Margin-left is provided for compatibility with CSS.

• Details on the mapping of CSS "margin" properties for XSL are given in [5 Property Refinement / Resolution].

7.9.4 "margin-right"

XSL modifications to the CSS definition:

• Margin-right is provided for compatibility with CSS.

• Details on the mapping of CSS "margin" properties for XSL are given in [5 Property Refinement / Resolution].

7.9.5 "space-before"

XSL Definition:

Values have the following meanings:

<space>

Specifies the minimum, optimum, and maximum values for the space before any areas generated by this formatting object and the conditionality and precedence of this space.

Specifies the value of the space-specifier for the space before the areas generated by this formatting object. A definition of space-specifiers, and the interaction between space-specifiers occurring in sequence are given in [4.3 Spaces and Conditionality].

NOTE:

A common example of such a sequence is the "space-after" on one area and the "space-before" of its next sibling.

7.9.6 "space-after"

XSL Definition:

Values have the following meanings:

<space>

Specifies the minimum, optimum, and maximum values for the space after any areas generated by this formatting object and the conditionality and precedence of this space.

Specifies the value of the space-specifier for the space after the areas generated by this formatting object. A definition of space-specifiers, and the interaction between space-specifiers occurring in sequence are given in [4.3 Spaces and Conditionality].

NOTE:

A common example of such a sequence is the "space-after" on one area and the "space-before" of its next sibling.

7.9.7 "start-indent"

XSL Definition:

Values have the following meanings:

<length>

For each block-area generated by this formatting object, specifies the distance from the start-edge of the content-rectangle of the containing reference-area to the start-edge of the content-rectangle of that block-area.

This property may have a negative value, which indicates an outdent.

7.9.8 "end-indent"

XSL Definition:

Values have the following meanings:

<length>

For each block-area generated by this formatting object, specifies the distance from the end-edge of the content-rectangle of that block-area to the end-edge of the content-rectangle of the containing reference-area.

This property may have a negative value, which indicates an outdent.

7.10 Common Margin Properties-Inline

This group also includes all the properties in the common-margin-properties-block group except space-before, space-after, start-indent, and end-indent.

7.10.1 "space-end"

XSL Definition:

Values have the following meanings:

<space>

Specifies the minimum, optimum, and maximum values for the space after any areas generated by this formatting object and the conditionality and precedence of this space.

Specifies the value of the space-specifier for the space after the areas generated by this formatting object. A definition of space-specifiers, and the interaction between space-specifiers occurring in sequence are given in [4.3 Spaces and Conditionality].

NOTE:

A common example of such a sequence is the "space-end" on one area and the "space-start" of its next sibling.

7.10.2 "space-start"

XSL Definition:

Values have the following meanings:

<space>

Specifies the minimum, optimum, and maximum values for the space before any areas generated by this formatting object and the conditionality and precedence of this space.

Specifies the value of the space-specifier for the space before the areas generated by this formatting object. A definition of space-specifiers, and the interaction between space-specifiers occurring in sequence are given in [4.3 Spaces and Conditionality].

NOTE:

A common example of such a sequence is the "space-end" on one area and the "space-start" of its next sibling.

7.11 Area Alignment Properties

7.11.1 "alignment-adjust"

XSL Definition:

The "alignment-adjust" property allows more precise alignment of elements, such as graphics, that do not have a baseline-table or lack the desired baseline in their baseline-table. With the "alignment-adjust" property, the position of the baseline identified by the "baseline-identifier" can be explicitly determined.

Values for the property have the following meaning:

auto

For a glyph, the alignment-point is the intersection of the start-edge of the allocation-rectangle of the glyph-area and the baseline identified by the "baseline-identifier" property if this baseline exists in the font from which the glyph comes. For other inline-areas, the alignment-point is at the intersection of the start-edge of the border-rectangle and the baseline identified by the "baseline-identifier" property if this baseline exists in the baseline-table for the dominant-baseline for the inline-area. If the baseline-identifier does not exist in the baseline-table for the glyph or other inline-area, then the User Agent may either use heuristics to determine where that missing baseline would be or may use the dominant-baseline as a fallback. For areas generated by a fo:external-graphic, or fo:instream-foreign-object, the alignment point is at the intersection of the start-edge and after-edge of the allocation-rectangle of the area.

<percentage>

The computed value of the property is this percentage multiplied by the area's computed "height" if the area is generated by an fo:external-graphic or fo:instream-foreign-object, the "font-size" if the area was generated by an fo:character, and the "line-height" otherwise. The alignment-point is on the start-edge of the allocation-rectangle of the area being aligned. Its position along the start-edge relative to the intersection of the dominant-baseline and the start-edge is offset by the computed value. The offset is opposite to the shift-direction if that value is positive and in the shift-direction if that value is negative value). A value of "0%" makes the dominant-baseline the alignment point.

<length>

The alignment-point is on the start-edge of the allocation-rectangle of the area being aligned. Its position along the start-edge relative to the intersection of the dominant-baseline and the start-edge is offset by <length> value. The offset is opposite to the shift-direction if that value is positive and in the shift-direction if that value is negative. A value of "0cm" makes the dominant-baseline the alignment point.

7.11.2 "baseline-identifier"

XSL Definition:

This property specifies how an object is aligned with respect to its parent. It also determines a default alignment point for the object, which may be adjusted by other properties.

The initial value of the "baseline-identifier" property depends on the kind of object on which it is being used. For fo:character, the initial value is the dominant-baseline of the script to which the character belongs. If there is no unambigous script identifier then the initial value is the dominant-baseline of the parent area. For all other objects, the initial value is "baseline".

For the values below, the alignment-point defaults to the baseline with the same name as the value. That is, for the value "ideographic" the alignment-point is the "ideographic" baseline of the object being aligned.

NOTE:

See [7.11.1 "alignment-adjust"] for a description of how the alignment point is determined.

Values have the following meanings:

baseline

The alignment-point of the object being aligned is aligned with the dominant-baseline of the parent area.

before-edge

The alignment-point of the object being aligned is aligned with the "before-edge" baseline of the parent area.

text-before-edge

The alignment-point of the object being aligned is aligned with the "text-before-edge" baseline of the parent area.

middle

The alignment-point of the object being aligned is aligned with the "middle" baseline of the parent area.

after-edge

The alignment-point of the object being aligned is aligned with the "after-edge" baseline of the parent area.

text-after-edge

The alignment-point of the object being aligned is aligned with the "text-after-edge" baseline of the parent area.

ideographic

The alignment-point of the object being aligned is aligned with the "ideographic" baseline of the parent area.

alphabetic

The alignment-point of the object being aligned is aligned with the "alphabetic" baseline of the parent area.

hanging

The alignment-point of the object being aligned is aligned with the "hanging" baseline of the parent area.

mathematical

The alignment-point of the object being aligned is aligned with the "mathematical" baseline of the parent area.

7.11.3 "baseline-shift"

XSL Definition:

The "baseline-shift" property allows repositioning of the dominant-baseline relative to the dominant-baseline of the parent area. The shifted object might be a sub- or superscript. Within the shifted object, the whole baseline-table is offset; not just a single baseline. The amount of the shift is determined from information from the parent area, the sub- or superscript offset from the nominal font of the parent area, percent of the "line-height" of the parent area or an absolute value.

Values for the property have the following meaning:

baseline

There is no baseline shift; the dominant-baseline remains in its original position.

sub

The dominant-baseline is shifted to the default position for subscripts. The offset to this position is determined by the font data for the nominal font as adjusted by the dominant baseline-table font-size. If there is no applicable font data the User Agent may use heuristics to determine the offset.

super

The dominant-baseline is shifted to the default position for superscripts. The offset to this position is determined by the font data for the nominal font as adjusted by the dominant baseline-table font-size. If there is no applicable font data the User Agent may use heuristics to determine the offset.

<percentage>

The computed value of the property is this percentage multiplied by the computed "line-height" of the parent area. The dominant-baseline is shifted in the shift-direction (positive value) or opposite to the shift-direction (negative value) of the parent area by the computed value. A value of "0%" is equivalent to "baseline".

<length>

The dominant-baseline is shifted in the shift-direction (positive value) or opposite to the shift-direction (negative value) of the parent area by the <length> value. A value of "0cm" is equivalent to "baseline".

NOTE:

Although it may seem that "baseline-shift" and "alignment-adjust" properties are doing the same thing, there is an important although, perhaps, subtle difference. For "alignment-adjust" the percentage values refer to the "line-height" of the element being aligned. For "baseline-shift" the percentage values refer to the "line-height" of the parent. Similarly, it is the "sub" and "super" offsets of the parent that are used to align the shifted baseline rather than the "sub" or "super" offsets of the element being positioned. To ensure a consistent sub- or superscript position, it makes more sense to use the parent as the reference rather than the subscript element which may have a changed "line-height" due to "font-size" changes in the sub- or superscript element.

Using the "alignment-adjust" property is more suitable for positioning objects, such as graphics, that have no internal textual structure. Using the "baseline-shift" property is intended for sub- and superscripts where the positioned object may itself be a textual object. The baseline-shift provides a way to define a specific baseline offset other than the named offsets that are defined relative to the dominant-baseline. In addition, having "baseline-shift" makes it easier for tool to generate the relevant properties; many formatting programs already have a notion of (temporary) baseline shift.

7.11.4 "display-align"

XSL Definition:

This property specifies the alignment, in the block-progression-direction, of the areas that are the children of a reference-area.

Values for the property have the following meaning:

auto

If the "relative-align" property applies to this formatting object the "relative-align" property is used. If not, this value is treated as if "before" had been specified.

before

The before-edge of the allocation-rectangle of the first child area is placed coincident with the before-edge of the content-rectangle of the reference-area.

center

The child areas are placed such that the distance between the before-edge of the allocation-rectangle of the first child area and the before-edge of the content-rectangle of the reference-area is the same as the distance between the after-edge of the allocation-rectangle of the last child area and the after-edge of the content-rectangle of the reference-area.

after

The after-edge of the allocation-rectangle of the last child area is placed coincident with the after-edge of the content-rectangle of the reference-area.

7.11.5 "dominant-baseline"

XSL Definition:

The "dominant-baseline" property is used to re-determine the dominant-baseline and re-establish the font-size used with the baseline-table. This property can also be used to explicitly set the dominant-baseline when the "auto" value would give an incorrect result.

Values for the property have the following meaning:

auto

If this property occurs on a block-level formatting object, the dominant-baseline is set using the rules for "autosense-script" below. Otherwise, the dominant-baseline and the baseline-table remain the same as that of the parent area. If the "baseline-shift" value actually shifts the baseline, then the baseline-table font-size is set to the current "font-size", otherwise the baseline-table font-size remains the same as that of the parent area. If there is no parent area, the dominant-baseline is set to be the "lower" baseline, the baseline-table is set for that baseline, and the baseline-table font-size is set to the current "font-size".

autosense-script

The dominant-baseline and the baseline-table are set as follows. Use the first character descendant, as determined by the post-order traversal of the refined formatting object tree, which has an unambigous script identifier to determine the dominant script of the element's content. Using the nominal font for the element, set the "dominant-baseline" (and, correspondingly, the dominant baseline-table) to the default baseline, in the current writing-mode, for the dominant script. If there is no such character, then set the "alphabetic" baseline as the dominant-baseline.

no-change

The dominant-baseline, the baseline-table, and the baseline-table font-size remain the same as that of the parent area.

reset-size

The dominant-baseline and the baseline-table remain the same, but the baseline-table font-size is changed to the value of the "font-size" property on this formatting object. This re-scales the baseline-table for the current "font-size".

ideographic

The dominant-baseline is set to the "ideographic" baseline using the baseline-table and baseline-table font-size of the parent area, the baseline-table is changed to correspond to the "ideographic" baseline, and the baseline-table font-size is changed to the value of the "font-size" property on this formatting object.

alphabetic

The dominant-baseline is set to the "alphabetic" baseline using the baseline-table and baseline-table font-size of the parent area, the baseline-table is changed to correspond to the "alphabetic" baseline, and the baseline-table font-size is changed to the value of the "font-size" property on this formatting object.

hanging

The dominant-baseline is set to the "hanging" baseline using the baseline-table and baseline-table font-size of the parent area, the baseline-table is changed to correspond to the "hanging" baseline, and the baseline-table font-size is changed to the value of the "font-size" property on this formatting object.

mathematical

The dominant-baseline is set to the "mathematical" baseline using the baseline-table and baseline-table font-size of the parent area, the baseline-table is changed to correspond to the "mathematical" baseline, and the baseline-table font-size is changed to the value of the "font-size" property on this formatting object.

If there is no baseline-table in the nominal font or if the baseline-table lacks an entry for the desired baseline, then the User Agent may use heuristics to determine the position of the desired baseline.

7.11.6 "relative-align"

XSL Definition:

This property specifies the alignment, in the block-progression-direction, between two or more areas. If the "display-align" property applies to this formatting object and has a value other than "auto" this property is ignored.

Values for the property have the following meaning:

before

For an fo:table-cell: for each row, the first child area of all the cells that start in the row and that have this value is placed such that the before-edge of the content-rectangle is placed at the same distance from the row grid. In addition, at least, one of these first child areas of the cells has to be placed with the before-edge of its allocation-rectangle coincident with the before-edge of the content-rectangle of the table-cell.

For an fo:list-item the before-edge of the first area descendant generated by the fo:list-item-label is placed coincident with the before-edge of the area generated by the fo:list-item. Similarly the before-edge of the first area descendant generated by the fo:list-item-body is placed coincident with the before-edge of the area generated by the fo:list-item.

baseline

For an fo:table-cell: for each row, the first child area of all the cells that start in the row and that have this value is placed such that the dominant-baseline, as specified on the fo:table-row, of the first line is placed at the same distance from the row grid. In addition, at least, one of these first child areas of the cells has to be placed with the before-edge of its allocation-rectangle coincident with the before-edge of the content-rectangle of the table-cell.

NOTE:

That is, for all applicable cells the baseline of all the first lines are all aligned and placed the minimum distance down in the block-progression-direction. It should be noted that the start-edges of the content-rectangles of the cells need not align.

For an fo:list-item the distance between the baseline of the first line-area of the first area descendant generated by the fo:list-item-label is the same as the distance between the baseline of the first line-area of the first area descendant generated by the fo:list-item-body. In addition, at least, one of these first area descendants has to be placed such that the before-edge of its allocation-rectangle is coincident with the before-edge of the content-rectangle of the list-item.

7.12 Area Dimension Properties

7.12.1 "block-progression-dimension"

7.12.2 "content-height"

XSL Definition:

Values have the following meanings:

auto

The content-height should be the intrinsic content-height.

<length>

An absolute size for the content-height. This value implies a certain scaling factor to be applied onto the content.

<percentage>

A percentage representing a scaling factor for the content-height.

Specifies the content-height of some object (e.g., an external graphic). If the value is a percentage, the value of this property is the percentage applied to the intrinsic height.

7.12.3 "content-width"

XSL Definition:

Values have the following meanings:

auto

The content-width should be the intrinsic content-width.

<length>

An absolute size for the content-width. This value implies a certain scaling factor to be applied onto the content.

<percentage>

A percentage representing a scaling factor for the content-width.

Specifies the content-width of some object (e.g., an external graphic). If the value is a percentage, the value of this property is the percentage applied to the intrinsic width.

7.12.4 "height"

XSL modifications to the CSS definition:

In XSL, this property is mapped to either "inline-progression-dimension" or "block-progression-dimension", based on the applicable values of the "writing-mode" and "reference-orientation" properties. Details on the mapping are given in [5 Property Refinement / Resolution].

For a discussion of the "height" property in tables see: http://www.w3.org/TR/REC-CSS2/tables.html

7.12.5 "inline-progression-dimension"

7.12.6 "max-height"

XSL modifications to the CSS definition:

In XSL, this property is mapped to either "inline-progression-dimension" or "block-progression-dimension", based on the applicable values of the "writing-mode" and "reference-orientation" properties. Details on the mapping are given in [5 Property Refinement / Resolution].

7.12.7 "max-width"

XSL modifications to the CSS definition:

In XSL, this property is mapped to either "inline-progression-dimension" or "block-progression-dimension", based on the applicable values of the "writing-mode" and "reference-orientation" properties. Details on the mapping are given in [5 Property Refinement / Resolution].

7.12.8 "min-height"

XSL modifications to the CSS definition:

In XSL, this property is mapped to either "inline-progression-dimension" or "block-progression-dimension", based on the applicable values of the "writing-mode" and "reference-orientation" properties. Details on the mapping are given in [5 Property Refinement / Resolution].

7.12.9 "min-width"

XSL modifications to the CSS definition:

In XSL, this property is mapped to either "inline-progression-dimension" or "block-progression-dimension", based on the applicable values of the "writing-mode" and "reference-orientation" properties. Details on the mapping are given in [5 Property Refinement / Resolution].

7.12.10 "scaling"

XSL Definition:

Values have the following meanings:

uniform

Scaling should preserve the aspect ratio.

non-uniform

Scaling need not preserve the aspect ratio.

Specifies whether scaling needs to preserve the intrinsic aspect ratio.

7.12.11 "scaling-method"

XSL Definition:

Values have the following meanings:

auto

The User Agent is free to choose either resampling, integer scaling, or any other scaling method.

integer-pixels

The User Agent should scale the image such that each pixel in the original image is scaled to the nearest integer number of device-pixels that yields an image less-then-or-equal-to the image size derived from the content-height, content-width, and scaling properties.

resample-any-method

The User Agent should resample the supplied image to provide an image that fills the size derived from the content-height, content-width, and scaling properties. The user agent may use any sampling method.

This property is used to indicate a preference in the scaling/sizing tradeoff to be used when formatting bitmapped graphics.

NOTE:

This is defined as a preference to allow the user agent the flexibility to adapt to device limitations and to accommodate over-constrained situations involving min/max dimensions and scale factors.

7.12.12 "width"

XSL modifications to the CSS definition:

In XSL, this property is mapped to either "inline-progression-dimension" or "block-progression-dimension", based on the applicable values of the "writing-mode" and "reference-orientation" properties. Details on the mapping are given in [5 Property Refinement / Resolution].

7.13 Block and Line-related Properties

7.13.1 "hyphenation-keep"

XSL Definition:

Values have the following meanings:

auto

No restriction applies. The word may be hyphenated at the end of any region.

column

Both parts of a hyphenated word shall lie within a single column.

page

Both parts of a hyphenated word shall lie within a single page.

Controls whether hyphenation can be performed on the last line that fits in a given reference-area.

7.13.2 "hyphenation-ladder-count"

XSL Definition:

Values have the following meanings:

no-limit

Any number of successive lines may be hyphenated.

<integer>

An integer greater than or equal to 1.

Specifies a limit on the number of successive hyphenated line-areas the formatter may generate in a block-area.

7.13.3 "last-line-end-indent"

XSL Definition:

Values have the following meanings:

<length>

The "last-line-end-indent" is specified as a length.

<percentage>

The "last-line-end-indent" is specified as a percentage of the block's content-rectangle inline-progression-dimension.

Specifies an indent to be applied to the end-edge of the last (or only) line-area contained in a block-area. It is added to the block's end-edge. Positive values indent the edge, negative values outdent the edge.

7.13.4 "line-height"

XSL modifications to the CSS definition:

XSL adds the following value with the following meanings:

<space>

The difference between the inline-area's actual height and the line-height's space-specifier's three lengths are each divided by 2.0 and the result is used to set three half-leading values (optimum, minimum, and maximum).

Negative values for line-height.minimum, line-height.optimum, and line-height.maximum are invalid and will be interpreted as 0pt.

If the value of line-height.maximum is less than the value of line-height.optimum, it is treated as if the value of line-height.optimum had been specified. If the value of line-height.minimum is greater than the value of line-height.optimum, it is treated as if the value of line-height.optimum had been specified.

The line-height.conditionality setting can be used to control the half-leading above the first line or after the last line that is placed in a reference-area.

The line-height.precedence setting can be used to control the merging of the half-leading with other spaces.

The space-before and space-after space-specifiers are set to the value of the half-leading. A definition of space-specifiers, and the interaction between space-specifiers occurring in sequence are given in [4.3 Spaces and Conditionality].

If line-height is specified using <length>, <percentage>, or <number>, the formatter shall convert the single value to a space-specifier with the subfields interpreted as follows:

• line-height.minimum: the resultant computed value (as a length) of the <length>, <percentage>, or <number>.

• line-height.optimum: the resultant computed value (as a length) of the <length>, <percentage>, or <number>.

• line-height.maximum: the resultant computed value (as a length) of the <length>, <percentage>, or <number>.

• line-height.precedence: force.

• line-height.conditionality: retain

7.13.5 "line-height-shift-adjustment"

XSL Definition:

Values have the following meanings:

consider-shifts

In determining the line-height, include the adjusted top-edge and bottom-edge of any characters that have a baseline-shift.

disregard-shifts

In determining the line-height, include the unshifted top-edge and bottom-edge of any characters that have a baseline-shift.

This property is used to control whether the line-height is adjusted for content that has a baseline-shift.

NOTE:

This property can be used to prevent superscript and subscript characters from disrupting the line-spacing.

7.13.6 "line-stacking-strategy"

XSL Definition:

Values have the following meanings:

line-height

Matches CSS's line-height and positioning strategy. (Uses the per-inline-height-rectangle as described in the area model.)

font-height

Uses the block's font height as adjusted by the font-height-override-before and font-height-override-after properties. (Uses the nominal-requested-line-rectangle as described in the area model.)

max-height

Uses the adjusted maximum ascender-heights and maximum descender-depth for the actual fonts and inline-areas placed on the line. This value may be further influenced by the line-height-shift-adjustment property. (Uses the maximal-line-rectangle as described in the area model).

Selects the strategy for positioning adjacent lines, relative to each other.

7.13.7 "linefeed-treatment"

XSL Definition:

Values have the following meanings:

ignore

Specifies that any character flow object whose Unicode character code is #xA shall be discarded.

preserve

Specifies no special action.

treat-as-space

Specifies that any character flow object whose Unicode character code is #xA shall be treated by subsequent XSL processing (including collapsing) and the formatter as if its Unicode character code were #x20.

The "linefeed-treatment" property specifies the treatment of linefeeds (#xA characters).

7.13.8 "space-treatment"

XSL Definition:

Values have the following meanings:

ignore

Specifies that any character flow object whose character is classified as "white space" in XML, except for #xA (linefeed) characters (since their treatment is determine by the linefeed-treatment property), shall be discarded.

preserve

Specifies no special action.

The "space-treatment" property specifies the treatment of space (#x20) and other whitespace characters except for linefeeds (#xA characters).

7.13.9 "text-align"

XSL modifications to the CSS definition:

Values have the following meanings:

start

Specifies that the content is to be aligned on the start-edge in the inline-progression-direction.

center

Specifies that the content is to be centered in the inline-progression-direction.

end

Specifies that the content is to be aligned on the end-edge in the inline-progression-direction.

justify

Specifies that the contents is to be expanded to fill the available width in the inline-progression-direction.

The last (or only) line of any block will be aligned in accordance with the "text-align-last" property value. If this line is to be justified specify "text-align-last='justify'".

inside

If the page binding edge is on the start-edge, the alignment will be start. If the binding is the end-edge, the alignment will be end. If neither, use start alignment.

outside

If the page binding edge is on the start-edge, the alignment will be end. If the binding is the end-edge, the alignment will be start. If neither, use end alignment.

left

Interpreted as "text-align='start'".

right

Interpreted as "text-align='end'".

<string>

Specifies a string on which cells in a table column will align (see the section, in the CSS2 recommendation, on horizontal alignment in a column for details and an example). This value applies only to table cells. If set on other elements, it will be treated as "start".

This property describes how inline content of a block is aligned.

7.13.10 "text-align-last"

XSL Definition:

Values have the following meanings:

relative

If text-align is justify, then the alignment of the last line will be start. If text-align is not justify, text-align-last will use the value of text-align.

start

Specifies that the content is to be aligned on the start-edge in the inline-progression-direction.

center

Specifies that the contents is to be centered in the inline-progression-direction.

end

Specifies that the content is to be aligned on the end-edge in the inline-progression-direction.

justify

Specifies that the contents is to be expanded to fill the available width in the inline-progression-direction.

inside

If the page binding edge is on the start-edge, the alignment will be start. If the binding is the end-edge, the alignment will be end. If neither, use start-side.

outside

If the page binding edge is on the start-edge, the alignment will be end. If the binding is the end-edge the alignment will be start. If neither, use end alignment.

left

Interpreted as "text-align-last='start'".

right

Interpreted as "text-align-last='end'".

<string>

Specifies a string on which cells in a table column will align (see the section, in the CSS2 recommendation, on horizontal alignment in a column for details and an example). This value applies only to table cells. If set on other elements, it will be treated as "start".

Specifies the alignment of the last line-area in a block.

7.13.11 "text-indent"

XSL modifications to the CSS definition:

The "text-indent" property specifies an adjustment to the start-indent of the first line-area in a block-area. This indent is added to the block's start-indent.

A negative value specifies a hanging indent (outdent) on the first line.

7.13.12 "white-space-collapse"

XSL Definition:

Values have the following meanings:

false

Specifies no special action.

true

Specifies, for any character flow object such that:

• its character is classified as "white space" in XML, and

• it is not a preserved linefeed (due to linefeed-treatment="preserve" ), and

• the immediately preceding (non-ignored) flow object was a character flow object also with a character of class white-space or the immediately following (non-ignored) flow object is a preserved linefeed,

that flow object shall be ignored.

The "white-space-collapse" property specifies the treatment of consecutive white-space. The effect is as follows: after all ignored white-space is discarded and all "treat-as-space" white-space is turned into a space, all resulting runs of two or more consecutive spaces are replaced by a single space, then any remaining space immediately adjacent to a remaining linefeed is also discarded. An implementation is free to use any algorithm to achieve an equivalent effect.

7.13.13 "wrap-option"

XSL Definition:

Values have the following meanings:

nowrap

No line-wrapping will be performed.

In the case when lines are longer than the available width of the content-rectangle, the overflow will be treated in accordance with the "overflow" property specified on the reference-area.

wrap

Line-breaking will occur if the line overflows the available block width. No special markers or other treatment will occur.

Specifies how line-wrapping (line-breaking) of the content of the formatting object is to be handled.

7.14 Character Properties

7.14.1 "character"

XSL Definition:

Values have the following meanings:

<character>

Specifies the Unicode character to be presented.

7.14.2 "letter-spacing"

XSL modifications to the CSS definition:

The following value type has been added for XSL:

<space>

This allows the user to specify a range of adjustments in addition to the default space between characters.

The minimum and maximum values specify the limits of the adjustment.

Default space between characters is defined to be 0pt, i.e., glyph-areas stacked with no extra space between the allocation-rectangles of the glyph-areas. The inline-progression-dimension of the glyph-area is obtained by formatting the fo:character.

For an fo:character that in the Unicode database is classified as "Alphabetic" the start-space and end-space traits are each set to a value as follows:

• For "normal": .optimum = "the normal spacing for the current font" / 2, .maximum = auto, .minimum = auto, .precedence = force, and .conditionality = discard. A value of auto for a component implies that the limits are User Agent specific.

• For a <length>: .optimum = <length> / 2, .maximum = .optimum, .minimum = .optimum, .precedence = force, and .conditionality = discard.

• For a <space>: a value that is half the value of the "letter-spacing" property for the numeric components and the value for the .precedence and .conditionality components. The initial values for .precedence is "force" and for .conditionality "discard".

The CSS statement that "Conforming user agents may consider the value of the 'letter-spacing' property to be 'normal'." does not apply in XSL, if the User Agent implements the "Extended" property set.

NOTE:

If it is desired that the letter-space combine with other spaces that have less than forcing precedence, then the value of the letter-space should be specified as a <space> with precedence less than force which implies that space combines according to the space resolution rules described in [4.3 Spaces and Conditionality].

The algorithm for resolving the adjusted values between word-spacing and letter-spacing is User Agent dependent.

7.14.3 "suppress-at-line-break"

XSL Definition:

This property applies only to fo:character and determines if the character's presentation shall be suppressed if it occurs at the beginning or end of a line.

All characters that have this property (including spaces) that appear at beginning or end of a line are suppressed. There may be multiple characters that are suppressed on a given line.

This property has the following values:

auto

The value of this property is determined by the Unicode value of the object's character property. The character at codepoints u+0020 is treated as if 'suppress' had been specified. All other characters are treated as if 'retain' had been specified.

This value does not automatically suppress the presentation of the non-breaking-space (u+00a0), the fixed spaces (u+2000 through u+200a), or the ideographic-space (u+3000).

suppress

If the glyph-area generated by the fo:character is first or last in a line-building partition (see section [4.10.2 Line-building]) then it is deleted rather than being placed in the area tree, together with all adjacent areas with a suppress-at-line-break value of suppress. Otherwise it is retained and placed in the area tree.

retain

The glyph-area generated by the fo:character shall be placed in the area tree whether or not it is first or last in a line-building partition.

7.14.4 "text-decoration"

XSL modifications to the CSS definition:

XSL adds the following values with the following meanings:

no-underline

Turns off underlining, if any.

no-overline

Turns off overlining, if any.

no-line-through

Turns off line-through, if any.

no-blink

Turns off blinking, if any.

7.14.5 "text-shadow"

7.14.6 "text-transform"

XSL modifications to the CSS definition:

There are severe internationalization issues with the use of this property. It has been retained for CSS compatibility, but its use is not recommended in XSL.

7.14.7 "treat-as-word-space"

XSL Definition:

This property determines if the character shall be treated as a word-space or as a normal letter.

This property has the following values:

auto

The value of this property is determined by the Unicode codepoint for the character.

As the default behavior:

• The characters at codepoints u+0020 and u+00a0 are treated as if 'yes' had been specified. All other characters are treated as if 'no' had been specified.

• This property does not automatically apply word-spacing to the fixed spaces (u+2000 through u+200a) or the ideographic-space (u+3000).

• This default behavior can be overridden by information in the font used for formatting the character, which can specify additional characters that may be treated as "word-spaces".

yes

This inline-progression-dimension of the character shall be adjusted as described in the "word-spacing" property.

no

This character shall not have a word-spacing adjustment applied.

7.14.8 "word-spacing"

XSL modifications to the CSS definition:

The following value type has been added for XSL:

<space>

This allows the user to specify a range of adjustments in addition to the default space between words.

The minimum and maximum values specify the limits of the adjustment.

Default space between words is defined to be the inline-progression-dimension of the glyph-area obtained by formatting the current fo:character whose treat-as-wordspace trait has the value "yes".

For fo:character whose treat-as-word-space trait has the value "yes", the start-space and end-space traits are each set to a value as follows:

• For "normal": .optimum = ("the normal inter-word-space, as defined by the current font and/or the UA" - "the inline-progression-dimension of the glyph-area obtained by formatting the fo:character") / 2, .maximum = .optimum, .minimum = .optimum, .precedence = force, and .conditionality = discard.

• For a <length>: .optimum = <length> / 2, .maximum = .optimum, .minimum = .optimum, .precedence = force, and .conditionality = discard.

• For a <space>: a value that is half the value of the "word-spacing" property for the numeric components and the value for the .precedence and .conditionality components. The initial values for .precedence is "force" and for .conditionality "discard".

NOTE:

If it is desired that the word-space combine with other spaces that have less than forcing precedence, then the value of the word-space should be specified as a <space> with precedence less than force which implies that space combines according to the space resolution rules described in [4.3 Spaces and Conditionality].

The algorithm for resolving the adjusted values between word-spacing and letter-spacing is User Agent dependent.

NOTE:

The "word-spacing" property only affects the placement of glyphs and not the shape that may be associated with the characters. For example, adjusting a "_" treated as a word-space does not lengthen or shorten the "_" glyph.

7.15 Color-related Properties

7.15.1 "color"

XSL modifications to the CSS definition:

XSL adds an "icc-color" function as a valid value of this property.

7.15.2 "color-profile-name"

XSL Definition:

<name>

Specifies the name of a color-profile for internal references.

7.15.3 "rendering-intent"

XSL Definition:

"rendering-intent" permits the specification of a color-profile rendering-intent other than the default. "rendering-intent" is applicable primarily to color-profiles corresponding to CMYK color spaces. The different options cause different methods to be used for translating colors to the color gamut of the target rendering device.

Values have the following meanings:

auto

This is the default behavior. The user-agent determines the best intent based on the content type. For image content containing an embedded profile, it shall be assumed that the intent specified within the profile is the desired intent. Otherwise, the user agent shall use the current profile and force the intent, overriding any intent that might be stored in the profile itself.

perceptual

This method, often the preferred choice for images, preserves the relationship between colors. It attempts to maintain relative color values among the pixels as they are mapped to the target device gamut. Sometimes pixel values that were originally within the target device gamut are changed in order to avoid hue shifts and discontinuities and to preserve as much as possible the overall appearance of the scene.

relative-colorimetric

Leaves colors that fall inside the gamut unchanged. This method usually converts out of gamut colors to colors that have the same lightness but fall just inside the gamut.

saturation

Preserves the relative saturation (chroma) values of the original pixels. Out of gamut colors are converted to colors that have the same saturation but fall just inside the gamut.

absolute-colorimetric

Disables white point matching when converting colors. This option is generally not recommended.

7.16 Float-related Properties

7.16.1 "clear"

XSL modifications to the CSS definition:

A start-float is defined to mean an area with area-class "xsl-side-float" that was generated by an fo:float with property "float" specified as "left" or "start".

An end-float is defined to mean an area with area-class "xsl-side-float" that was generated by an fo:float with property "float" specified as "left" or "start".

A side-float is defined to mean either a start-float or an end-float.

An area is defined "to clear" a side-float if the before-edge of the area's border-rectangle is positioned to be after the after-edge of the float.

A block-level formatting object is defined "to clear" a side-float if the areas generated by the formatting object clear the side-float.

In XSL this property applies to block-level formatting objects and fo:float.

Values have the following meanings:

start

Specifies that the areas generated by the formatting object must clear every start-float that is a child of the reference-area generated by the nearest ancestor formatting object that generates a reference-area, and that was generated by a formatting object that is before this formatting object, using pre-order traversal order of the formatting object tree.

end

Specifies that the areas generated by the formatting object must clear every end-float that is a child of the reference-area generated by the nearest ancestor formatting object that generates a reference-area, and that was generated by a formatting object that is before this formatting object, using pre-order traversal order of the formatting object tree.

left

Interpreted as "clear='start'".

right

Interpreted as "clear='end'".

both

Specifies that the areas generated by the formatting object must clear every side-float that is a child of the reference-area generated by the nearest ancestor formatting object that generates a reference-area, and that was generated by a formatting object that is before this formatting object, using pre-order traversal order of the formatting object tree.

none

This property does not impose any constraints.

When a block-level formatting object is constrained by the "clear" property, its space-before property component values may be altered as necessary for each area that it generates, in order to meet the constraint. The alterations are constrained to produce the minimum additional space required to meet the constraint of the "clear" property.

NOTE:

Depending on how near a side-float's after-edge is to the after-edge of its parent reference-area, a block-level formatting object may not be able to generate an area that is a child of the same parent reference-area of the side-float. In this case the first block-area generated by the formatting object must be placed in one of the following columns in the same region or in one of the following pages.

7.16.2 "float"

XSL modifications to the CSS definition:

The following values have been added for XSL: "before", "start", and "end".

In XSL this property applies only to fo:float

Values have the following meanings:

before

Specifies that the block-areas generated by the fo:float shall be with area-class "xsl-before-float", and shall be descendants of a "before-float-reference-area" generated by a conditional sub-region of a region-body.

start

Specifies that the block-areas generated by the fo:float shall be with area-class "xsl-side-float" and shall be placed so that their start-edge coincides with the start-edge of the nearest ancestor reference-area.

end

Specifies that the block-areas returned by the fo:float shall be with area-class "xsl-side-float" and shall be placed so that their end-edge coincides with the end-edge of the nearest ancestor reference-area.

left

Interpreted as "float='start'".

right

Interpreted as "float='end'".

none

Specifies that the block-areas generated by the fo:float shall be normal.

This property determines the area-class trait of the block-areas returned by the fo:float, which control the placement and parent of these block-areas.

7.17 Keeps and Breaks Properties

Page breaks only apply to descendants of the fo:flow formatting object, and not within absolutely positioned areas, or out-of-line areas. In descendants of fo:flow formatting objects, column breaks apply, and a column break in the last (or only) column implies a page break; column breaks in static-content apply except for those in the last (or only) column which are ignored.

The semantics of keeps and breaks are further described in [4.11 Keeps and Breaks].

7.17.1 "break-after"

XSL Definition:

Values for these properties have the following meanings:

auto

No break shall be forced.

NOTE:

Page breaks may occur as determined by the formatter's processing as affected by the "widow", "orphan", "keep-with-next", "keep-with-previous", and "keep-together" properties.

column

Imposes a break-after condition with a context consisting of column-areas.

page

Imposes a break-after condition with a context consisting of page-areas.

even-page

Imposes a break-after condition with a context consisting of even page-areas (a blank page may be generated if necessary).

odd-page

Imposes a break-after condition with a context consisting of odd page-areas (a blank page may be generated if necessary).

Specifies that the last area generated by formatting this formatting object shall be the last one placed in a particular context (e.g., page-area, column-area).

This property has no effect when it appears on an fo:table-row formatting object in which there is any row spanning occurring that includes both the current fo:table-row and the subsequent one.

7.17.2 "break-before"

XSL Definition:

Values have the following meanings:

auto

No break shall be forced.

NOTE:

Page breaks may occur as determined by the formatter's processing as affected by the "widow", "orphan", "keep-with-next", "keep-with-previous", and "keep-together" properties.

column

Imposes a break-before condition with a context consisting of column-areas.

page

Imposes a break-before condition with a context consisting of page-areas.

even-page

Imposes a break-before condition with a context consisting of even page-areas (a blank page may be generated if necessary).

odd-page

Imposes a break-before condition with a context consisting of odd page-areas (a blank page may be generated if necessary).

Specifies that the first area generated by formatting this formatting object shall be the first one placed in a particular context (e.g., page-area, column-area).

This property has no effect when it appears on an fo:table-row formatting object in which there is any row spanning occurring that includes both the current fo:table-row and the previous one.

7.17.3 "keep-together"

XSL Definition:

This property imposes keep-together conditions on formatting objects.

The <keep> datatype is composed of three components: within-line, within-column, and within-page. Different components apply to different classes of formatting objects and provide keep conditions relative to different contexts. In the case of the within-line component, the keep context consists of line-areas; for the within-column component, the keep context consists of column-areas; for the within-page component, the keep context consists of page-areas. In the descriptions below, the term "appropriate context" should be interpreted in terms of the previous sentence.

Any assignment to this property unqualified by a specific component shall cause the ".within-column" component to be set to the given value and the ".within-line" and ".within-page" components to be set to "auto".

Values of the components have the following meanings:

auto

There are no keep-together conditions imposed by this property.

always

Imposes a keep-together condition with strength "always" in the appropriate context.

<integer>

Imposes a keep-together condition with strength of the given <integer> in the appropriate context.

The semantics of keeps and breaks are further described in [4.11 Keeps and Breaks].

7.17.4 "keep-with-next"

XSL Definition:

This property imposes keep-with-next conditions on formatting objects.

The <keep> datatype is composed of three components: within-line, within-column, and within-page. Different components apply to different classes of formatting objects and provide keep conditions relative to different contexts. In the case of the within-line component, the keep context consists of line-areas; for the within-column component, the keep context consists of column-areas; for the within-page component, the keep context consists of page-areas. In the descriptions below, the term "appropriate context" should be interpreted in terms of the previous sentence.

Any assignment to this property unqualified by a specific component shall cause the ".within-column" component to be set to the given value and the ".within-line" and ".within-page" components to be set to "auto".

Values of the components have the following meanings:

auto

There are no keep-with-next conditions imposed by this property.

always

Imposes a keep-with-next condition with strength "always" in the appropriate context.

<integer>

Imposes a keep-with-next condition with strength of the given <integer> in the appropriate context.

The semantics of keeps and breaks are further described in [4.11 Keeps and Breaks].

7.17.5 "keep-with-previous"

XSL Definition:

This property imposes keep-with-previous conditions on formatting objects.

The <keep> datatype is composed of three components: within-line, within-column, and within-page. Different components apply to different classes of formatting objects and provide keep conditions relative to different contexts. In the case of the within-line component, the keep context consists of line-areas; for the within-column component, the keep context consists of column-areas; for the within-page component, the keep context consists of page-areas. In the descriptions below, the term "appropriate context" should be interpreted in terms of the previous sentence.

Any assignment to this property unqualified by a specific component shall cause the ".within-column" component to be set to the given value and the ".within-line" and ".within-page" components to be set to "auto".

Values of the components have the following meanings:

auto

There are no keep-with-previous conditions imposed by this property.

always

Imposes a keep-with-previous condition with strength "always" in the appropriate context.

<integer>

Imposes a keep-with-previous condition with strength of the given <integer> in the appropriate context.

The semantics of keeps and breaks are further described in [4.11 Keeps and Breaks].

7.17.6 "orphans"

7.17.7 "widows"

XSL modifications to the CSS definition:

In XSL the "orphans" property specifies the minimum number of line-areas in the first area generated by the formatting object. The "widows" property specifies the minimum number of line-areas in the last area generated by the formatting object.

7.18 Layout-related Properties

The following are layout-related properties that are not common to all formatting objects.

7.18.1 "clip"

7.18.2 "overflow"

XSL modifications to the CSS definition:

The initial value for the overflow property has been changed from "visible" to "auto".

Two more values are defined and the definition of the CSS "auto" value is augmented as follows:

error-if-overflow

This value implies the same semantics as the value "hidden" with the additional semantic that an error shall be indicated; implementations may recover by clipping the region.

paginate

When overflow occurs while directing content to a target region on a page-master, new instances of the presentation medium shall be generated as necessary to contain the overflow. When applied to a non-region formatting object, this value specifies, in the case of overflow, that more areas shall be generated as necessary to contain the overflow.

auto

The behavior of the "auto" value is User Agent dependent, but should cause a scrolling mechanism to be provided for overflowing boxes if the User Agent if the User Agent is capable of doing so. If the User Agent cannot provide a scrolling mechanism, then (1) when applied to the region to which fo:flow is assigned, this value implies the same semantics as "paginate"; (2) when applied to a region to which fo:static-content is assigned, this value implies the same semantics as "error-if-overflow"; and (3) when applied to a non-region formatting object, this value implies the same semantics as "error-if-overflow".

7.18.3 "reference-orientation"

XSL Definition:

Values have the following meanings:

0

The reference-orientation of this reference-area has the same reference-orientation as the containing reference-area.

90

The reference-orientation of this reference-area is rotated 90 degrees counter-clockwise from the reference-orientation of the containing reference-area.

180

The reference-orientation of this reference-area is rotated 180 degrees counter-clockwise from the reference-orientation of the containing reference-area.

270

The reference-orientation of this reference-area is rotated 270 degrees counter-clockwise from the reference-orientation of the containing reference-area.

-90

The reference-orientation of this reference-area is rotated 270 degrees counter-clockwise from the reference-orientation of the containing reference-area.

NOTE:

This is equivalent to specifying "270".

-180

The reference-orientation of this reference-area is rotated 180 degrees counter-clockwise from the reference-orientation of the containing reference-area.

NOTE:

This is equivalent to specifying "180".

-270

The reference-orientation of this reference-area is rotated 90 degrees counter-clockwise from the reference-orientation of the containing reference-area.

NOTE:

This is equivalent to specifying "90".

The reference-orientation specifies the direction for "top" for the content-rectangle of the "reference-area". This is used as the reference for deriving directions, such as the block-progression-direction, inline-progression-direction, etc. as specified by the "writing-mode" and "direction" properties.

The "reference-orientation" property is applied only on formatting objects that establish a reference-area. Each value of "reference-orientation" sets the absolute direction for "top", "left", "bottom", and "right"; which is used by "writing-mode", "direction", and all positioning operations that are referenced to the reference-area or are nested within it.

The reference-orientation trait on an area is indirectly derived from the "reference-orientation" property on the formatting object that generates the area or the formatting object ancestors of that formatting object.

7.18.4 "relative-position"

7.18.5 "span"

XSL Definition:

Values have the following meanings:

none

This object does not span multiple columns.

all

The areas resulting from this flow object shall span all the columns of a multi-column region.

Specifies if a block-level object should be placed in the current column or should span all columns of a multi-column region.

7.19 Leader and Rule Properties

7.19.1 "leader-alignment"

XSL Definition:

Values have the following meanings:

none

Leader-pattern has no special alignment.

reference-area

Leader-pattern is aligned as if it began on the current reference-area's content-rectangle start-edge.

page

Leader-pattern is aligned as if it began on the current page's start-edge.

Specifies whether fo:leaders having identical content and property values shall have their patterns aligned with each other, with respect to their common reference-area or page.

For fo:leaders where the "leader-pattern" property is specified as "dot" or as "use-content", this property will be honored.

If the fo:leader is aligned, the start-edge of each cycle of the repeated pattern will be placed on the start-edge of the next cycle in the appropriate pattern-alignment grid.

7.19.2 "leader-pattern"

XSL Definition:

Values have the following meanings:

space

Leader is to be filled with blank space.

rule

Leader is to be filled with a rule.

If this choice is selected, the "rule-thickness" and "rule-style" properties are used to set the leader's style.

dots

Leader is to be filled with a repeating sequence of dots. The choice of dot character is dependent on the user agent.

use-content

Leader is to be filled with a repeating pattern as specified by the children of the fo:leader.

Provides the specification of how to fill in the leader.

If the leader is aligned, the start-edge of each cycle of each repeating pattern component will be placed on the start-edge of the next cycle in the pattern-alignment grid.

7.19.3 "leader-pattern-width"

XSL Definition:

Values have the following meanings:

use-font-metrics

Use the width of the leader-pattern as determined from its font metrics.

<length>

Sets length for leader-pattern-repeating.

The leader will have an inline-space inserted after each pattern cycle to account for any difference between the width of the pattern as determined by the font metrics and the width specified in this property.

If the length specified is less than the value that would be determined via the use-font-metrics choice, this value will be treated as if use-font-metrics choice had been specified.

Specifies the length of each repeat cycle in a repeating leader.

For leaders where the "leader-pattern" property is specified as "dot" or as "use-content", this property will be honored.

7.19.4 "leader-length"

XSL Definition:

Values have the following meanings:

<length-range>

leader-length.minimum=sets minimum length for a leader

leader-length.optimum=sets optimum length for a leader

leader-length.maximum=sets maximum length for a leader

Specifies the minimum, optimum, and maximum length of an fo:leader.

This property constrains the length of the leader to be between the minimum and maximum lengths.

NOTE:

User agents may choose to use the value of "leader-length.optimum" to determine where to break the line, then use the minimum and maximum values during line justification."

7.19.5 "rule-style"

XSL Definition:

Specifies the style (pattern) of the rule.

This property applies only if the "leader-pattern" property is specified as "rule".

Values have the following meanings:

none

No rule, forces rule-thickness to 0.

dotted

The rule is a series of dots.

dashed

The rule is a series of short line segments.

solid

The rule is a single line segment.

double

The rule is two solid lines. The sum of the two lines and the space between them equals the value of "rule-thickness".

groove

The rule looks as though it were carved into the canvas. (Top/left half of the rule's thickness is the color specified, the other half is white.)

ridge

The opposite of "groove", the rule looks as though it were coming out of the canvas. (Bottom/right half of the rule's thickness is the color specified, the other half is white.)

7.19.6 "rule-thickness"

XSL Definition:

Specifies the overall thickness of the rule.

This property applies only if the "leader-pattern" property is specified as "rule".

Values have the following meanings:

<length>

The "rule-thickness" is always perpendicular to its length-axis.

The rule is thickened equally above and below the line's alignment position. This can be adjusted through the "baseline-shift" property.

7.20 Properties for Links

7.20.1 "active-state"

XSL Definition:

link

This fo:multi-property-set applies if there is a fo:simple-link descendant of the parent fo:multi-properties and that link has not yet been visited.

visited

This fo:multi-property-set applies if there is a fo:simple-link descendant of the parent fo:multi-properties and that link has been visited.

active

This fo:multi-property-set applies while a normal area returned by the parent fo:multi-properties is being activated by the user. For example, between the times the user presses the mouse button and releases it.

hover

This fo:multi-property-set applies while the user designates a normal area returned by the parent fo:multi-properties (with some pointing device), but does not activate it. For example the cursor (mouse pointer) hovers over such an area.

focus

This fo:multi-property-set applies while a normal area returned by the parent fo:multi-properties has the focus (accepts keyboard events or other forms of text input).

The "active-state" property is used to control which of the fo:multi-property-sets are used to format the child flow objects within an fo:multi-properties formatting object. The states (or at least the events that cause the state to be entered) are defined by the DOM.

7.21 "auto-restore"

XSL Definition:

yes

If this fo:multi-switch is contained in another fo:multi-switch, and that fo:multi-switch changes the active fo:multi-case (hiding this fo:multi-switch), then this fo:multi-switch should restore its initial fo:multi-case.

no

This fo:multi-switch should retain its current fo:multi-case.

Specifies if the initial fo:multi-case should be restored when the fo:multi-switch gets hidden by an ancestor fo:multi-switch.

NOTE:

A common case of using this property with a "yes" value is when several nested fo:multi-switch objects builds an expandable/collapsible table-of-contents view. If the table-of-contents is expanded far down the hierarchy, and an (far above) ancestor is closed, one would want all sub-titles to have restored to their original state when that ancestor is opened again.

7.22 "case-name"

XSL Definition:

<name>

Specifies a name for an fo:multi-case. The name must be unique among the current fo:multi-case siblings, i.e., in the scope of the fo:multi-switch object that (directly) contains them. Other instances of fo:multi-switch objects may use the same names for its fo:multi-case objects.

The purpose of this property is to allow fo:multi-toggle objects to select fo:multi-case objects to switch to.

7.23 "case-title"

XSL Definition:

<string>

Specifies a descriptive title for the fo:multi-case. The title can be displayed in a menu to represent this fo:multi-case when an fo:multi-toggle object names several fo:multi-case objects as allowed destinations.

7.24 "destination-placement-offset"

XSL Definition:

<length>

The "destination-placement-offset" property specifies the distance from the beginning (top) of the page to the innermost line-area that contains the first destination area. If the first destination area is not contained in a line-area, the "destination-placement-offset" property instead directly specifies the distance to the top of the destination area.

If the specification of destination-placement-offset would result in a distance longer than the distance from the start of the document, the distance from the start of the document should be used.

If the specified distance would push the first destination area below the page-area, the distance should be decreased so the whole first destination area becomes visible, if possible. If the first destination area is higher than the page, the top of the area should be aligned with the top of the page.

7.25 "external-destination"

XSL Definition:

<uri>

Specifies the destination resource (or, when a fragment identifier is given, sub-resource) for an fo:simple-link.

How the destination (sub-)resource is used and/or displayed is application and implementation-dependent. In typical browsing applications, the destination resource is displayed in the browser positioned so that some rendered portion resulting from the processing of some part of the specific destination sub-resource indicated by the fragment identifier is in view.

At least one of the external-destination and internal-destination properties should be assigned. If both are assigned, the system may either report the error, or use the internal-destination property.

7.26 "indicate-destination"

XSL Definition:

yes

The areas that belong to the link target when traversed should, in a system-dependent manner, be indicated.

no

No special indication should be made.

NOTE:

This could be indicated in any feasible way, e.g., by reversed video, etc.

7.27 "internal-destination"

XSL Definition:

<idref>

Specifies the destination flow object of an fo:simple-link. This property allows the destination flow object node to be explicitly specified.

At least one of the external-destination and internal-destination properties should be assigned. If both are assigned, the system may either report the error, or use the internal-destination property.

7.28 "show-destination"

XSL Definition:

replace

The current document view should be replaced. However, if the destination area(s) are already available in a page/region, those areas should simply be moved/scrolled "into sight".

new

A new (additional) document view should always be opened.

Specifies where the destination resource should be displayed.

7.29 "starting-state"

XSL Definition:

show

The content of the fo:multi-case is a candidate for being displayed initially.

hide

The content of the fo:multi-case is not a candidate for being displayed initially.

Specifies if the fo:multi-case can be initially displayed.

The parent fo:multi-switch shall choose the first fo:multi-case child where the property "starting-state" has the value equal to "show".

NOTE:

Any number of the fo:multi-case objects may assign "starting-state" to "show".

If no fo:multi-case has "starting-state" property value of "show", the contents of no fo:multi-case should be displayed.

NOTE:

If no multi-case is displayed, the entire fo:multi-switch will effectively be hidden.

7.30 "switch-to"

XSL Definition:

xsl-preceding

Activating the switch should result in that the current fo:multi-case is replaced by its preceding sibling.

NOTE:

The current fo:multi-case is the closest ancestor fo:multi-case.

In other words, the current fo:multi-switch should switch to the previous sibling of the fo:multi-case that is currently selected.

NOTE:

The current fo:multi-switch is the closest ancestor fo:multi-switch.

It the current fo:multi-case is the first sibling, xsl-preceding should switch to the last fo:multi-case sibling.

xsl-following

Activating the switch should result in that the current fo:multi-case is replaced by its next sibling.

It the current fo:multi-case is the last sibling, xsl-following should switch to the first fo:multi-case sibling.

xsl-any

Activating the switch should allow the user to select any other fo:multi-case sibling.

If there is only a single other fo:multi-case, the toggle should immediately switch to it (and not show that single choice to the user).

<name>

A name matching a case-name of an fo:multi-case.

Specifies what fo:multi-case object(s) this fo:multi-toggle shall switch to.

If switch-to is a name list, the user can switch to any of the named multi-case objects. If a multi-toggle with a single name is activated, it should immediately switch to the named multi-case.

NOTE:

How to actually select the multi-case from a list is system dependent.

7.31 Properties for Markers

7.31.1 "marker-class-name"

XSL Definition:

Values have the following meanings:

<name>

Names used as identifiers must be unique among fo:markers that are (conceptually) attached to the same area.

If the name is empty or if a name-conflict is encountered, an error shall be reported. A processor may then continue processing.

This property identifies the fo:marker as being in a group with others that have the same name, each of which becomes a candidate to be retrieved by an fo:retrieve-marker that has a "retrieve-class-name" property of the same value.

7.31.2 "retrieve-class-name"

XSL Definition:

Values have the following meanings:

<name>

A name that matches the "marker-class-name" property value of an fo:marker.

This property constrains that the fo:marker whose children are retrieved by the fo:retrieve-marker must have a "marker-class-name" property value that is the same as the value of this property.

7.31.3 "retrieve-position"

XSL Definition:

The term "containing page" is used here to mean the page that contains the first area generated or returned by the children of the retrieved fo:marker.

Values have the following meanings:

first-starting-within-page

Specifies a preference for retrieving the children of an fo:marker attached to an area that is

• within the containing page

• whose "is-first" trait is set to "true"

and that precedes in the area tree any other similarly constrained area that is attached to an identically named fo:marker, using pre-order traversal order.

first-including-carryover

Specifies a preference for retrieving the children of an fo:marker attached to an area that is within the containing page and that precedes in the area tree any other similarly constrained area that is attached to an identically named fo:marker, using pre-order traversal order.

last-starting-within-page

Specifies a preference for retrieving the children of an fo:marker attached to an area that is

• within the containing page

• whose "is-first" trait is set to "true"

and that follows in the area tree any other similarly constrained area that is attached to an identically named fo:marker, using pre-order traversal order.

last-ending-within-page

Specifies a preference for retrieving the children of an fo:marker attached to an area that is within the containing page whose "is-last" trait is set to "true" and that follows in the area tree any other similarly constrained area that is attached to an identically named fo:marker, using pre-order traversal order.

This property specifies the preference for which fo:marker's children shall be retrieved by an fo:retrieve-marker, based on the areas returned by the parent of the fo:marker relative to the areas returned by the parents of other identically named fo:marker's.

7.31.4 "retrieve-boundary"

XSL Definition:

The term "containing page" is used here to mean the page that contains the first area generated or returned by the children of the retrieved fo:marker.

Values have the following meanings:

page

Specifies that the children of any fo:markers whose parent generated or returned a normal area within the containing page or generated non-normal area within the containing page may be retrieved by this fo:retrieve-marker.

page-sequence

Specifies that only the children of fo:markers that are descendants of the fo:flow within the containing fo:page-sequence may be retrieved by this fo:retrieve-marker.

document

Specifies that the children of any fo:marker that is a descendant of any fo:flow within the document may be retrieved by this fo:retrieve-marker.

7.32 Properties for Number to String Conversion

7.32.1 "format"

XSL Definition:

This property is defined in XSLT: Number to String Conversion Attributes.

7.32.2 "grouping-separator"

XSL Definition:

This property is defined in XSLT: Number to String Conversion Attributes.

7.32.3 "grouping-size"

XSL Definition:

This property is defined in XSLT: Number to String Conversion Attributes.

7.32.4 "letter-value"

XSL Definition:

This property is defined in XSLT: Number to String Conversion Attributes. A value of "auto" corresponds to the XSLT definition for when the attribute is not specified.

7.33 Pagination and Layout Properties

The following pagination and layout properties are all XSL only.

7.33.1 "blank-or-not-blank"

XSL Definition:

This property forms part of a selection rule to determine if the referenced page-master is eligible for selection at this point in the page-sequence.

The values have the following meanings:

blank

This master is eligible for selection if a page must be generated (e.g., to maintain proper page parity at the start or end of the page-sequence) and there are no areas from the fo:flow to be put on that page.

not-blank

This master is eligible for selection if this page contains areas from the fo:flow.

any

This master is always eligible for selection.

7.33.2 "column-count"

XSL Definition: