3. Conformance statement

The W3C Extensible Stylesheet Language (XSL) v1.0 Recommendation defines three levels of conformance for an XSL-FO processor: basic, extended and complete. Since XMLmind XSL-FO Converter currently does not conform to any of these levels, this document provides a complete list of supported objects/properties, along with additional information for objects/properties that are not fully supported.

In the following tables, the background color (white, light green or green) of each entry in the tables below indicates the level of conformance (basic, extended or complete) of that particular object/property, as specified by the Recommendation.

Table 5.1. XSL-FO objects
ObjectSupportedComments
Declarations and Pagination and Layout Formatting Objects
rootyes 
declarationsno 
color-profileno 
page-sequenceyes 
layout-master-setyes 
page-sequence-masteryes 
single-page-master-referenceyes 
repeatable-page-master-referenceyes 
repeatable-page-master-alternativesyes 
conditional-page-master-referenceyesLimited support. See Section 4.11, “Multiple page layouts” for further information.
simple-page-masteryes 
region-bodyyes 
region-beforeyes 
region-afteryes 
region-startnoOutput format limitation.
region-endnoOutput format limitation.
flowyes 
static-contentyesSupported regions: body, before and after.
titleno 
Block-level Formatting Objects
blockyesNot supported inside inline-level objects (output format limitation).
block-containerlimitedMay be used with attribute reference-orientation to temporarily switch the page orientation from portrait to landscape or to rotate the content of a table-cell. Otherwise, ignored.
Inline-level Formatting Objects
bidi-overrideno 
characterno 
initial-property-setno 
external-graphicyes

Supported image formats: WMF, EMF, BMP (.NET version and Java™ 1.5+), TIFF (.NET version and Java™ with jai_imageio.jar in the CLASSPATH) GIF, JPEG and PNG.

Optionally the Java™ (v1.5+) version also supports SVG and MathML.

instream-foreign-objectyes

The XML content of a fo:instream-foreign-object element is passed to the proper GraphicFactory. For this to work, the fo:instream-foreign-object element must have a content-type attribute containing a media type supported by a registered GraphicFactory.

Note that content-type ``sniffing'' is implemented only for SVG and MathML and that content-type attributes starting with "namespace-prefix:" are completely ignored.

inlineyesCannot contain block-level objects (output format limitation).
inline-containerno 
leaderyesLimited support (most properties ignored). See Section 4.3, “Leaders” for further information.
page-numberyes 
page-number-citationyes 
Formatting Objects for Tables
table-and-captionyesNot supported inside inline-level objects (output format limitation).
tableyes
table-columnyes 
table-captionyes 
table-headeryes 
table-footeryes 
table-bodyyes 
table-rowyes 
table-cellyes 
Formatting Objects for Lists
list-blockyesNot supported inside inline-level objects (output format limitation).
list-itemyes 
list-item-bodyyes 
list-item-labelyesMultiple block-level descendants not supported.
Link and Multi Formatting Objects
basic-linkyesCan only contain text and inline-level objects.
multi-switchno 
multi-caseno 
multi-toggleno 
multi-propertiesno 
multi-property-setno 
Out-of-line Formatting Objects
floatno 
footnoteyes 
footnote-bodyyes 
Other Formatting Objects
wrapperyes 
markerno 
retrieve-markerno 
Table 5.2. XSL-FO properties
PropertySupportedComments
Common Accessibility Properties
source-documentno 
rolenoSupported on fo:external-graphic and fo:instream-foreign-object.
Common Absolute Position Properties
absolute-positionno 
topno 
rightno 
bottomno 
topno 
Common Aural Properties
azimuthn/a 
cue-aftern/a 
cue-beforen/a 
elevationn/a 
pause-aftern/a 
pause-beforen/a 
pitchn/a 
pitch-rangen/a 
play-duringn/a 
richnessn/a 
speakn/a 
speak-headern/a 
speak-numeraln/a 
speak-punctuationn/a 
speech-raten/a 
stressn/a 
voice-familyn/a 
volumen/a 
Common Border, Padding and Background Properties
background-attachmentno 
background-coloryes 
background-imagenoMay be used to add a watermark to the generated document. See Section 4.12, “Adding a watermark to the generated document”.
background-repeatno 
background-position-horizontalnoMay be used to add a watermark to the generated document. See Section 4.12, “Adding a watermark to the generated document”.
background-position-verticalno
border-before-coloryes
  • Not supported on block-level objects that contain other block-level objects (output format limitation).

  • Not supported on inline objects that contain other objects (output format limitation).

border-before-styleyes
border-before-widthyes
border-after-coloryes
border-after-styleyes
border-after-widthyes
border-start-coloryes
border-start-styleyes
border-start-widthyes
border-end-coloryes
border-end-styleyes
border-end-widthyes
border-top-coloryes
  • Not supported on block-level objects that contain other block-level objects (output format limitation).

  • Not supported on inline objects that contain other objects (output format limitation).

    ODT output format: borders and padding around a text span are not supported by OpenOffice and by old versions (< v5) of LibreOffice.

border-top-styleyes
border-top-widthyes
border-bottom-coloryes
border-bottom-styleyes
border-bottom-widthyes
border-left-coloryes
border-left-styleyes
border-left-widthyes
border-right-coloryes
border-right-styleyes
border-right-widthyes
padding-beforeyes
  • Not supported on block-level objects that contain other block-level objects (output format limitation).

  • Not supported together with border-*-style="none" or border-*-style="hidden" (output format limitation).

padding-afteryes
padding-startyes
padding-endyes
padding-topyes
  • Not supported on block-level objects that contain other block-level objects (output format limitation).

  • Not supported together with border-*-style="none" or border-*-style="hidden" (output format limitation).

padding-bottomyes
padding-leftyes
padding-rightyes
Common Font Properties
font-familyyes 
font-selection-strategyno 
font-sizeyes 
font-stretchno 
font-size-adjustno 
font-styleyesValue backslant not supported (output format limitation).
font-variantyes 
font-weightyes 
Common Hyphenation Properties
countryyesSee language below.
languageyesFor attribute language and, optionally, attribute country (or equivalently, xml:lang) to be considered to generate information for use by the word processor, attribute language (or equivalently, xml:lang) must be specified at least on the fo:root element. More information in Section 4.6, “Adding language information to the documents created by XFC.
scriptno 
hyphenateno 
hyphenation-characterno 
hyphenation-push-character-countno 
hyphenation-remain-character-countno 
Common Margin Properties - Block
margin-topyesPercentages and value auto not supported.
margin-bottomyes
margin-leftyes
margin-rightyes
space-beforeyesConditionality not supported.
space-afteryes
start-indentyesPercentages not supported.
end-indentyes
Common Margin Properties - Inline
space-endno 
space-startno 
Common Relative Position Properties
relative-positionno 
Area Alignment Properties
alignment-adjustno 
alignment-baselinenoValues middle, before-edge and after-edge supported on fo:external-graphic and fo:instream-foreign-object.
baseline-shiftyes 
display-alignnoSupported on fo:table-cell, fo:external-graphic and fo:instream-foreign-object.
dominant-baselineno 
relative-alignno 
Area Dimension Properties
block-progression-dimensionno 
content-heightyes

The following XSL-FO 1.1 property values: scale-down-to-fit, scale-up-to-fit are also supported.

content-widthyes

The following XSL-FO 1.1 property values: scale-down-to-fit, scale-up-to-fit are also supported.

heightnoSupported on fo:table-row, fo:external-graphic and fo:instream-foreign-object.
inline-progression-dimensionno 
max-heightno 
max-widthno 
min-heightno 
min-widthno 
scalingyes 
scaling-methodno 
widthnoSupported on fo:table, fo:external-graphic and fo:instream-foreign-object.
Block and Line-related Properties
hyphenation-keepno 
hyphenation-ladder-countno 
last-line-end-indentnoOutput format limitation.
line-heightyesValue type space not supported.
line-height-shift-adjustmentno 
line-stacking-strategyno 
linefeed-treatmentyes 
text-alignyesValues inside and outside and value type string not supported.
text-align-lastnoOutput format limitation.
text-indentyesPercentages not supported.
white-space-collapseyes 
white-space-treatmentyes 
wrap-optionno 
Character Properties
characterno 
letter-spacingno 
suppress-at-line-breakno 
text-decorationyesIn addition to the decoration type (underline, overline, line-through, etc), it's possible to specify the color, style (solid, double, dotted, dashed, wavy) and thickness of the text decoration. See Section 4.14, “Non-standard extension of XSL-FO property text-decoration.
text-shadowno 
text-transformno 
treat-as-word-spaceno 
word-spacingno 
Color-related Properties
coloryes 
color-profile-nameno 
rendering-intentno 
Float-related Properties
clearno 
floatno 
intrusion-displaceno 
Keeps and Breaks Properties
break-afteryes 
break-beforeyes 
keep-togetheryesNot supported on block-level objects that contain other block-level objects.
keep-with-nextyesNot supported on block-level objects that contain other block-level objects.
keep-with-previousno 
orphansyes

Remember that Window/Orphan control is turned on by default as the initial value of the orphans and widows properties is 2.

Also note that for MS-Word, Window/Orphan control is an all or nothing option. Therefore if you set attribute orphans or attribute widows to 1, Window and Orphan control will be turned off. If, on the contrary, you set attribute orphans or attribute widows to any value greater or equal than 2, Window and Orphan control will be turned on.

Unlike MS-Word, OpenOffice/LibreOffice fully supports the orphans and widows properties.

widowsyes
Layout-related Properties
clipno 
overflowno 
reference-orientationlimitedMay be used on fo:block-container to temporarily switch the page orientation from portrait to landscape or to rotate the content of a table-cell. Otherwise, ignored.
spanno 
Leader and Rule Properties
leader-alignmentno 
leader-patternyesValue use-content not supported.
leader-pattern-widthno 
leader-lengthno 
rule-styleyesSupported values: none, dotted and solid.
rule-thicknessno 
Properties for Dynamic Effects Formatting Objects
active-stateno 
auto-restoreno 
case-nameno 
case-titleno 
destination-placement-offsetno 
external-destinationyes 
indicate-destinationno 
internal-destinationyes 
show-destinationno 
starting-stateno 
switch-tono 
target-presentation-contextno 
target-processing-contextno 
target-stylesheetno 
Properties for Markers
marker-class-nameno 
retrieve-class-nameno 
retrieve-positionno 
retrieve-boundaryno 
Properties for Number to String Conversion
formatyes 
grouping-separatorno 
grouping-sizeno 
letter-valueno 
Pagination and Layout Properties
blank-or-not-blankno 
column-countyes 
column-gapyes 
extentno 
flow-nameyesValues xsl-before-float-separator and xsl-footnote-separator not supported.
force-page-countno 
initial-page-numberyes 
master-nameyes 
master-referenceyes 
maximum-repeatsno 
media-usageno 
odd-or-evenyes 
page-heightyes 
page-positionyesValue last not supported.
page-widthyes 
precedenceno 
region-nameyes 
Table Properties
border-after-precedenceno 
border-before-precedenceno 
border-collapseyesValue collapse-with-precedence not supported.
border-end-precedenceno 
border-separationyes 
border-start-precedenceno 
caption-sideyesValues start, end, left and right not supported (output format limitation).
column-numberyes 
column-widthyes 
empty-cellsno 
ends-rowyes 
number-columns-repeatedyes 
number-columns-spannedyes 
number-rows-spannedyes 
starts-rowyes 
table-layoutyes 
table-omit-footer-at-breakno 
table-omit-header-at-breakno 
Writing-mode-related Properties
directionnoValue ltr assumed.
glyph-orientation-horizontalno 
glyph-orientation-verticalno 
text-altitudeno 
text-depthno 
unicode-bidino 
writing-modenoValue lr-tb assumed.
Miscellaneous Properties
content-typeyes 
idyes 
provisional-label-separationyes 
provisional-distance-between-startsyes 
ref-idyes 
score-spacesno 
srcyes 
visibilityno 
z-indexno 
Shorthand Properties
backgroundnoBackground color specification supported.
background-positionno 
borderyesSee restrictions on individual properties.
border-bottomyes
border-leftyes
border-rightyes
border-topyes
border-coloryes
border-styleyes
border-widthyes
border-spacingyes 
cuen/a 
fontyes 
marginyesSee restrictions on individual properties.
paddingyesSee restrictions on individual properties.
page-break-afteryesSee restrictions on individual properties.
page-break-beforeyes
page-break-insideyes
pausen/a 
positionno 
sizenoValue type length supported.
vertical-alignno 
white-spaceyes 
xml:langyesShorthand for language and country.