Formatting Object Properties

Each formatting object has its own set of properties. There isn't room here to list them all in detail, much less describe them. The following lists are therefore very brief summaries of some of the formatting objects and some of their properties and values. If only one value is shown (such as a measurement), this is the default value, otherwise the default values are shown in bold text. You have seen some of them used in the examples in this chapter.

Formatting objects are currently the least supported feature of XSL, and are the most prone to change (which is probably why they are so poorly supported). The following list is not meant to be complete or definitive; it is meant to give you an impression of the richness that XSL has to offer. To check the latest status of the formatting objects and their properties you should download the latest XSL working draft (at http://www.w3c.org/WD/WD-xsl).

• Simple-page-master:
A simple-page-master defines the layout of a page area. You can repeat simple-page-masters by using a page-sequence specification.

master-name = name-specifier
background-attachment = ( scroll | fixed )
background-color = a color-specifier or transparent
background-image = a URI or none
background-position-x = ( a length-specifier | left | center |
right )
background-position-y = ( a length-specifier | top | middle | bottom )
background-repeat = ( no-repeat | repeat | repeat-x | repeat-y )
page-height = length-specifier  |  auto
page-width = length-specifier | auto
page-writing-mode = writing-mode-specifier lr-tb
margin-bottom  =  36.0pt
margin-left =  36.0pt
margin-right  = 36.0pt
margin-top = 36.0pt
body-overflow  = ( visible | hidden | scroll | auto )
body-writing-mode = a writing-mode-specifier | use-page-writing-mode
end-side-overflow = ( visible | hidden | scroll | auto )
end-side-separation (0.0pt
end-side-size 0.0pt
end-side-writing-mode = a writing-mode-specifier | use-page-writing-mode
footer-overflow = ( visible | hidden | scroll | auto )
footer-precedence = ( true | false )
footer-separation 18.0pt
footer-size 36.0pt
footer-writing-mode = a writing-mode-specifier | use-page-writing-
mode
header-overflow = ( visible | hidden | scroll | auto )
header-precedence = ( true | false )
header-separation 18.0pt
header-size  36.0pt
header-writing-mode = a writing-mode-specifier | use-page-writing-mode
start-side-separation 0.0pt
start-side-size 0.0pt
start-side-overflow = ( visible | hidden | scroll | auto )
start-side-writing-mode = a writing-mode-specifier

      | use-page-writing-mode

• Block:
A block formatting object is used to create a block-level area that contains text lines. Blocks are commonly used for formatting paragraphs, titles, headlines, figure and table captions, and so on. It normally specifies a rectangular area that occupies the width of the containing area and a height that is determined by the amount of text that the block contains.

language = ( none | use-document | an xml:lang specifier )
background-attachment = ( scroll | fixed )
background-color = a color-specifier or transparent
background-image = a URI or none
background-position-x = ( a length-specifier | left | center |
right )
background-position-y = ( a length-specifier | top | middle |
bottom )
background-repeat = ( no-repeat | repeat | repeat-x | repeat-y )
font-family = font-name or font-name-list any
font-style = ( normal | italic | oblique )
font-stretch = ( ultra-condensed | extra-condensed | condensed |
        semi-condensed | normal | semi-expanded | expanded |
        extra-expanded | ultra-expanded)
font-size 10.0pt
font-variant = ( normal | small-caps )
font-weight = ( any | not-applicable | ultra-light | extra-light |
          light | semi-light | book | normal | medium | semi-bold |
          bold | extra-bold | ultra-bold  )
glyph-alignment-mode  = ( base | center | top | bottom | font )
indent-end 0.0pt
indent-start 0.0pt
indent-first-line-start 0.0pt
break-after = ( none | page | page-odd | page-even )
break-before = ( none | page | page-odd | page-even )
keep = ( auto | no-break | page )
orphans = 2
widows = 2
keep-with-next = ( true | false )
keep-with-previous = ( true | false )
block-line-breaking = ( wrap | asis | as-is-wrap | asis-truncate | none )
block-asis-truncate-indicator = ( none | a character )
block-asis-wrap-indicator = ( none | a character )
block-asis-wrap-indent 0.0pt
hyphenation-keep = ( none | spread | page | column )
hyphenation-ladder-count  2
text-align = ( start | end | left | right | spread-inside |
          spread-outside | page-inside | page-outside |
          center | justify | justify-force )
text-align-last = ( auto | start | end | left | right |
           spread-inside | spread-outside |
           page-inside | page-outside | center | justify )
linespacing-strategy = ( fixed | auto )
linespacing 12.0pt
space-after-maximum  0.0pt
space-after-minimum 0.0pt
space-after-optimum 0.0pt
space-before-maximum 0.0pt
space-before-minimum 0.0pt
space-before-optimum 0.0pt
writing-mode = writing-mode-specifier lr-tb

• Character:
Use a character formatting object when you need to explicitly override a specific character or array of characters with a specific glyph.

background-attachment = ( scroll | fixed )
background-color = a color-specifier or transparent
background-image = a URI or none
background-position-x = ( a length-specifier | left | center | right )
background-position-y = ( a length-specifier | top | middle | bottom )
background-repeat = ( no-repeat | repeat | repeat-x | repeat-y )
text-shadow = see the CSS proposal
text-transform = ( as-entered | lower | upper | title | (see CSS) )
char
char-kern
char-kern-mode
char-ligature
color
font-specification
glyph-alignment-mode
hyphenate
hyphenation-char
inhibit-wrap
language
position-point-shift
letterspace-after-maximum
letterspace-after-minimum
letterspace-after-optimum
wordspacing-maximum
wordspacing-minimum
wordspacing-optimum
text-shadow
text-transform: capitalize | uppercase | lowercase | none
writing-mode

• List:
Creates a block-level area containing a list. Its allowed children are either only list-item-label, list-item pairs, or only list-item-body objects.

background-attachment = ( scroll | fixed )
background-color = a color-specifier or transparent
background-image = a URI or none
background-position-x = ( a length-specifier | left | center | right )
background-position-y = ( a length-specifier | top | middle | bottom )
background-repeat = ( no-repeat | repeat | repeat-x | repeat-y )
break-before = ( none | page | page-odd | page-even )
break-after = ( none | page | page-odd | page-even |),
indent-start 0.0pt
indent-end 0.0pt
space-before-maximum  0.0pt
space-before-minimum 0.0pt
space-before-optimum 0.0pt
space-after-maximum  0.0pt
space-after-minimum 0.0pt
space-after-optimum  0.0pt

• List-item:
A list-item flow object contains the label and the body of each item. Use a list-item to override and modify some of the list's properties on a case-by-case basis. A list-item flow object can only be contained by a list. It is a wrapper for a list-item-label and a list-item-body.

background-attachment = ( scroll | fixed )
background-color = a color-specifier or transparent
background-image = a URI or none
background-position-x = ( a length-specifier | left | center | right )
background-position-y = ( a length-specifier | top | middle | bottom )
background-repeat = ( no-repeat | repeat | repeat-x | repeat-y )
indent-start 0.0pt
indent-end 0.0pt
item-space-before-maximum 0.0pt
item-space-before-minimum 0.0pt
item-space-before-optimum  0.0pt
item-space-after-maximum  0.0pt
item-space-after-minimum  0.0pt
item-space-after-optimum 0.0pt

• List-item-label:
Use a list-item-label to either enumerate, identify, or adorn the list-item's body. A list-item-label can be contained only in a list-item. The label has content, and is formatted to become the adornment or enumeration of the list-item.

background-attachment = ( scroll | fixed )
background-color = a color-specifier or transparent
background-image = a URI or none
background-position-x = ( a length-specifier | left | center | right )
background-position-y = ( a length-specifier | top | middle | bottom )
background-repeat = ( no-repeat | repeat | repeat-x | repeat-y )
label-width 0.0pt
space-end 0.0pt
label-separator 12.0pt

• List-item-body:
The list-item-body flow object holds the components (usually blocks) for a list item. It controls styling defaults for the body, the spacing between lines and between paragraphs within the list item, and the break precedence for line and paragraphs within the list item.

background-attachment = ( scroll | fixed )
background-color = a color-specifier or transparent
background-image = a URI or none
background-position-x = ( a length-specifier | left | center | right )
background-position-y = ( a length-specifier | top | middle | bottom )
background-repeat = ( no-repeat | repeat | repeat-x | repeat-y )

• Rule-graphic:
A graphic representation of a line-segment used for rules and scores.

background-attachment = ( scroll | fixed )
background-color = a color-specifier or transparent
background-image = a URI or none
background-position-x = ( a length-specifier | left | center | right )
background-position-y = ( a length-specifier | top | middle | bottom )
background-repeat = ( no-repeat | repeat | repeat-x | repeat-y )
color
block-level-alignment
break-after
break-before
graphic-line-thickness
indent-end
indent-start
inhibit-wrap
keep
keep-with-previous
keep-with-next
rule-graphic-length
rule-graphic-orientation
position-point-shift
space-after-maximum
space-after-minimum
space-after-optimum
space-before-maximum
space-before-minimum
space-before-optimum
writing-mode

• Display-graphic:
Use this object to create a block-level area that contains a graphic.

background-attachment = ( scroll | fixed )
background-color = a color-specifier or transparent
background-image = a URI or none
background-position-x = ( a length-specifier | left | center | right )
background-position-y = ( a length-specifier | top | middle | bottom )
background-repeat = ( no-repeat | repeat | repeat-x | repeat-y )
inline
block-level-alignment
break-after
break-before
color
external-graphic-id
graphic-max-height
graphic-max-width
graphic-scale
indent-end
indent-start
inhibit-wrap
keep
keep-with-previous
keep-with-next
position-point-x
position-point-y
position-preference
space-after-maximum
space-after-minimum
space-after-optimum
space-before-maximum
space-before-minimum
space-before-optimum
writing-mode

• Inline-box:

background-attachment = ( scroll | fixed )
background-color = a color-specifier or transparent
background-image = a URI or none
background-position-x = ( a length-specifier | left | center |
right )
background-position-y = ( a length-specifier | top | middle |
bottom )
background-repeat = ( no-repeat | repeat | repeat-x | repeat-y )
box-reserve-space
box-open-end
box-size-after
box-size-before
box-type
break-after
break-before
color
graphic-line-thickness
indent-end
indent-start
inhibit-textline-breaks?
keep
keep-with-previous?
keep-with-next?
space-after-maximum
space-after-minimum
space-after-optimum
space-before-maximum
space-before-minimum
space-before-optimum
writing-mode

• Block-level-box:

background-attachment = ( scroll | fixed )
background-color = a color-specifier or transparent
background-image = a URI or none
background-position-x = ( a length-specifier | left | center |
right )
background-position-y = ( a length-specifier | top | middle | bottom )
background-repeat = ( no-repeat | repeat | repeat-x | repeat-y )
box-reserve-space
box-size-after
box-size-before
box-type
break-after
break-before
color
graphic-line-thickness
indent-end
indent-start
inhibit-textline-breaks?
keep
keep-with-previous?
keep-with-next?
space-after-maximum
space-after-minimum
space-after-optimum
space-before-maximum
space-before-minimum
space-before-optimum
writing-mode

• Link:
A link can be either a display-link (block-level) or an inline-link.

background-attachment = ( scroll | fixed )
background-color = a color-specifier or transparent
background-image = a URI or none
background-position-x = ( a length-specifier | left | center|
right )
background-position-y = ( a length-specifier | top | middle |
bottom )
background-repeat = ( no-repeat | repeat | repeat-x | repeat-y )
merge-link-end-locators = ( true | false )

• Link-end-locator:
Represents a target for link.

background-attachment = ( scroll | fixed )
background-color = a color-specifier or transparent
background-image = a URI or none
background-position-x = ( a length-specifier | left | center | right )
background-position-y = ( a length-specifier | top | middle | bottom )
background-repeat = ( no-repeat | repeat | repeat-x | repeat-y )
href = ( XPointer )
show-content = ( true | false )

[Previous] [Contents] [Next]