fo:block-container
Generates a block-level reference-area.
Element information
Namespace: http://www.w3.org/1999/XSL/Format
Schema document: fo.xsd
Type: Anonymous
Properties: Global, Qualified
Content
- Choice [1..1]
- fo:block [1..*]Formats paragraphs, titles, headlines, figure and table captions, etc. The start edge (and end edge) of the block is displaced by the least amount necessary to insure that (a) the start edge (end edge) of the block does not intersect any of the start intrusions (end intrusions) that overlap that block and (b) the amount by which it is displaced is at least as much as the displacement of the parent area, provided the parent is a block-area which is not a reference-area. An intrusion is said to overlap a block if the there is a line parallel to the inline progression direction that intersects the allocation rectangles of both the block and the intrusion.
- fo:block-container [1..*]Generates a block-level reference-area.
- fo:table-and-caption [1..*]Formats a table together with its caption.
- fo:table [1..*]A table.
- fo:list-block [1..*]A list.
- fo:multi-switch [1..*]Wraps the specification of alternative sub-trees of formatting objects (each sub-tree being within an fo:multi-case), and controls the switching (activated via fo:multi-toggle) from one alternative to another.
- fo:multi-properties [1..*]Switches between two or more property sets that are associated with a given portion of content.
- fo:index-range-begin [1..*]The beginning of an "indexed range" associated with an index key. The index range is ended by a corresponding fo:index-range-end.
- fo:index-range-end [1..*]The end of an "indexed range" that is started by its matching fo:index-range-begin.
- fo:wrapper [1..*]Specifies inherited properties for a group of formatting objects. It has no additional formatting semantics.
- fo:retrieve-marker [1..*]Used in conjunction with fo:marker to produce running headers or footers.
- fo:retrieve-table-marker [1..*]Used in conjunction with fo:marker to produce table-headers and table-footers whose content can change over different pages, different regions or different columns.
- fo:change-bar-begin [1..*]The beginning of a "change region" that is ended by its matching fo:change-bar-end. The change region is decorated with a change bar down either the start or end edge of the column. The style of the change bar is determined by the value of various change bar related properties.
- fo:change-bar-end [1..*]The end of a "change region" that is started by its matching fo:change-bar-begin.
- fo:float [1..*]Serves two purposes. It can be used so that during the normal placement of content, some related content is formatted into a separate area at beginning of the page (or of some following page) where it is available to be read without immediately intruding on the reader. Alternatively, it can be used when an area is intended to float to one side, with normal content flowing alongside.
from group fo:block-onlyfrom group fo:either-block-or-inline
from group fo:block
Attributes
| Name | Occ | Type | Description | Notes |
|---|---|---|---|---|
| absolute-position | [0..1] | Anonymous | from group fo:absolute-position | |
| top | [0..1] | fo:offset | How far a box's top margin edge is offset below the top edge of the box's containing block. CSS2 Reference: | from group fo:top |
| right | [0..1] | fo:offset | How far a box's right margin edge is offset to the left of the right edge of the box's containing block. CSS2 Reference: | from group fo:right |
| bottom | [0..1] | fo:offset | How far a box's bottom margin edge is offset above the bottom edge of the box's containing block. CSS2 Reference: | from group fo:bottom |
| left | [0..1] | fo:offset | How far a box's left margin edge is offset to the right of the left edge of the box's containing block. CSS2 Reference: | from group fo:left |
| background-attachment | [0..1] | Anonymous | If a background image is specified, this property specifies whether it is fixed with regard to the viewport ('fixed') or scrolls along with the containing block ('scroll'). CSS2 Reference: | from group fo:background-attachment |
| background-color | [0..1] | fo:background-color | The background color of an element, either a <color> value or the keyword transparent, to make the underlying colors shine through. CSS2 Reference: | from group fo:background-color |
| background-image | [0..1] | fo:background-image | The background image of an element. When setting a "background-image", authors should also specify a background-color that will be used when the image is unavailable. When the image is available, it is rendered on top of the background color. (Thus, the color is visible in the transparent parts of the image). CSS2 Reference: | from group fo:background-image |
| background-repeat | [0..1] | fo:background-repeat | If a background image is specified, this property specifies whether the image is repeated (tiled), and how. CSS2 Reference: | from group fo:background-repeat |
| background | [0..1] | Anonymous | A shorthand property for setting the individual background properties (i.e., background-color, background-image, background-repeat, background-attachment and background-position) at the same place in the stylesheet. Value is [<background-color> || <background-image> || <background-repeat> || <background-attachment> || <background-position> ]] | inherit. CSS2 Reference: | from group fo:background |
| background-position-horizontal | [0..1] | Anonymous | If a "background-image" has been specified, this property specifies its initial position horizontally. | from group fo:background-position-horizontal |
| background-position-vertical | [0..1] | Anonymous | If a "background-image" has been specified, this property specifies its initial position vertically. | from group fo:background-position-vertical |
| background-position | [0..1] | Anonymous | If a background image has been specified, this property specifies its initial position. If only one value is specified, the second value is assumed to be 'center'. If at least one value is not a keyword, then the first value represents the horizontal position and the second represents the vertical position. Negative <percentage> and <length> values are allowed. CSS2 Reference: | from group fo:background-position |
| border-before-color | [0..1] | fo:border-color | The color of the border on the before-edge of a block-area or inline-area. | from group fo:border-before-color |
| border-before-style | [0..1] | fo:border-style-or-inherit | The border-style for the before-edge. | from group fo:border-before-style |
| border-before-width | [0..1] | fo:border-width-length-conditional-or-inherit | The border-width for the before-edge. | from group fo:border-before-width |
| border-after-color | [0..1] | fo:border-color | The color of the border on the after-edge of a block-area or inline-area. | from group fo:border-after-color |
| border-after-style | [0..1] | fo:border-style-or-inherit | The border-style for the after-edge. | from group fo:border-after-style |
| border-after-width | [0..1] | fo:border-width-length-conditional-or-inherit | The border-width for the after-edge. | from group fo:border-after-width |
| border-start-color | [0..1] | fo:border-color | The color of the border on the start-edge of a block-area or inline-area. | from group fo:border-start-color |
| border-start-style | [0..1] | fo:border-style-or-inherit | The border-style for the start-edge. | from group fo:border-start-style |
| border-start-width | [0..1] | fo:border-width-length-conditional-or-inherit | The border-width for the start-edge. | from group fo:border-start-width |
| border-end-color | [0..1] | fo:border-color | The color of the border on the end-edge of a block-area or inline-area. | from group fo:border-end-color |
| border-end-style | [0..1] | fo:border-style-or-inherit | The border-style for the end-edge. | from group fo:border-end-style |
| border-end-width | [0..1] | fo:border-width-length-conditional-or-inherit | The border-width for the end-edge. | from group fo:border-end-width |
| border-top-color | [0..1] | fo:border-color | The color of the four borders. CSS2 Reference: | from group fo:border-top-color |
| border-top-style | [0..1] | fo:border-style-or-inherit | The line style of a box's border (solid, double, dashed, etc.). CSS2 Reference: | from group fo:border-top-style |
| border-top-width | [0..1] | fo:border-with-or-inherit | The width of the border area. CSS2 Reference: | from group fo:border-top-width |
| border-bottom-color | [0..1] | fo:border-color | The border color for the bottom-edge. CSS2 Reference: | from group fo:border-bottom-color |
| border-bottom-style | [0..1] | fo:border-style-or-inherit | The border style for the bottom-edge. CSS2 Reference: | from group fo:border-bottom-style |
| border-bottom-width | [0..1] | fo:border-with-or-inherit | The border width for the bottom-edge. CSS2 Reference: | from group fo:border-bottom-width |
| border-left-color | [0..1] | fo:border-color | The border color for the left-edge. CSS2 Reference: | from group fo:border-left-color |
| border-left-style | [0..1] | fo:border-style-or-inherit | The border style for the left-edge. CSS2 Reference: | from group fo:border-left-style |
| border-left-width | [0..1] | fo:border-with-or-inherit | The border width for the left-edge. CSS2 Reference: | from group fo:border-left-width |
| border-right-color | [0..1] | fo:border-color | The border color for the right-edge. CSS2 Reference: | from group fo:border-right-color |
| border-right-style | [0..1] | fo:border-style-or-inherit | The border style for the right-edge. CSS2 Reference: | from group fo:border-right-style |
| border-right-width | [0..1] | fo:border-with-or-inherit | The border width for the right-edge. CSS2 Reference: | from group fo:border-right-width |
| border | [0..1] | fo:border-combined | A shorthand property for setting the same width, color, and style for all four borders, top, bottom, left, and right, of a box. Unlike the shorthand "margin" and "padding" properties, the "border" property cannot set different values on the four borders. To do so, one or more of the other border properties must be used. CSS2 Reference: | from group fo:border |
| border-bottom | [0..1] | fo:border-combined | A shorthand property for setting the width, style, and color of the bottom border of a block-area or inline-area. CSS2 Reference: | from group fo:border-bottom |
| border-color | [0..1] | Anonymous | The color of the four borders. CSS2 Reference: | from group fo:border-color |
| border-left | [0..1] | fo:border-combined | A shorthand property for setting the width, style, and color of the left border of a block-area or inline-area. CSS2 Reference: | from group fo:border-left |
| border-right | [0..1] | fo:border-combined | A shorthand property for setting the width, style, and color of the right border of a block-area or inline-area. CSS2 Reference: | from group fo:border-right |
| border-style | [0..1] | Anonymous | Sets the style of the four borders. It can have from one to four values, and the values are set on the different sides. CSS2 Reference: | from group fo:border-style |
| border-spacing | [0..1] | Anonymous | The distance between the borders of adjoining cells. CSS2 Reference: | from group fo:border-spacing |
| border-top | [0..1] | fo:border-combined | A shorthand property for setting the width, style, and color of the top border of a block-area or inline-area. CSS2 Reference: | from group fo:border-top |
| border-width | [0..1] | Anonymous | A shorthand property for setting "border-top-width", "border-right-width", "border-bottom-width", and "border-left-width" at the same place in the stylesheet. CSS2 Reference: | from group fo:border-width |
| padding-before | [0..1] | fo:padding-width-length-conditional-or-inherit | The width of the padding on the before-edge of a block-area or inline-area. | from group fo:padding-before |
| padding-after | [0..1] | fo:padding-width-length-conditional-or-inherit | The width of the padding on the after-edge of a block-area or inline-area. | from group fo:padding-after |
| padding-start | [0..1] | fo:padding-width-length-conditional-or-inherit | The width of the padding on the start-edge of a block-area or inline-area. | from group fo:padding-start |
| padding-end | [0..1] | fo:padding-width-length-conditional-or-inherit | The width of the padding on the end-edge of a block-area or inline-area. | from group fo:padding-end |
| padding-top | [0..1] | fo:padding-width-or-inherit | The width of the padding on the top-edge of a block-area or inline-area. Unlike margin properties, values for padding properties cannot be negative. CSS2 Reference: | from group fo:padding-top |
| padding-bottom | [0..1] | fo:padding-width-or-inherit | The width of the padding on the bottom-edge of a block-area or inline-area. CSS2 Reference: | from group fo:padding-bottom |
| padding-left | [0..1] | fo:padding-width-or-inherit | The width of the padding on the left-edge of a block-area or inline-area. CSS2 Reference: | from group fo:padding-left |
| padding-right | [0..1] | fo:padding-width-or-inherit | The width of the padding on the right-edge of a block-area or inline-area. CSS2 Reference: | from group fo:padding-right |
| padding | [0..1] | Anonymous | A shorthand property for setting padding-top, padding-bottom, padding-left, and padding-right of a block-area or inline-area. If there is only one value, it applies to all sides. If there are two values, the top and bottom paddings are set to the first value and the right and left paddings are set to the second. If there are three values, the top is set to the first value, the left and right are set to the second, and the bottom is set to the third. If there are four values, they apply to the top, right, bottom, and left, respectively. CSS2 Reference: | from group fo:padding |
| margin-top | [0..1] | fo:margin-width | The top margin of a box. CSS2 Reference: | from group fo:margin-top |
| margin-bottom | [0..1] | fo:margin-width | The bottom margin of a box. CSS2 Reference: | from group fo:margin-bottom |
| margin-left | [0..1] | fo:margin-width | The left margin of a box. CSS2 Reference: | from group fo:margin-left |
| margin-right | [0..1] | fo:margin-width | The right margin of a box. CSS2 Reference: | from group fo:margin-right |
| margin | [0..1] | Anonymous | A shorthand property for setting margin-top, margin-right, margin-bottom, and margin-left of a block-area or inline-area. If there is only one value, it applies to all sides. If there are two values, the top and bottom margins are set to the first value and the right and left margins are set to the second. If there are three values, the top is set to the first value, the left and right are set to the second, and the bottom is set to the third. If there are four values, they apply to the top, right, bottom, and left, respectively. CSS2 Reference: | from group fo:margin |
| space-before | [0..1] | fo:space-or-inherit | The space-specifier for the space before the areas generated by this formatting object. | from group fo:space-before |
| space-before.minimum | [0..1] | fo:length | from group fo:space-before | |
| space-before.optimum | [0..1] | fo:length | from group fo:space-before | |
| space-before.maximum | [0..1] | fo:length | from group fo:space-before | |
| space-before.conditionality | [0..1] | fo:conditionality | from group fo:space-before | |
| space-before.precedence | [0..1] | fo:precedence | from group fo:space-before | |
| space-after | [0..1] | fo:space-or-inherit | The space-specifier for the space after the areas generated by this formatting object. | from group fo:space-after |
| space-after.minimum | [0..1] | fo:length | from group fo:space-after | |
| space-after.optimum | [0..1] | fo:length | from group fo:space-after | |
| space-after.maximum | [0..1] | fo:length | from group fo:space-after | |
| space-after.conditionality | [0..1] | fo:conditionality | from group fo:space-after | |
| space-after.precedence | [0..1] | fo:precedence | from group fo:space-after | |
| start-indent | [0..1] | fo:length-percentage-or-inherit | 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. | from group fo:start-indent |
| end-indent | [0..1] | fo:length-percentage-or-inherit | 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. | from group fo:end-indent |
| clip | [0..1] | Anonymous | Applies to elements that have a 'overflow' property with a value other than 'visible'. CSS2 Reference: | from group fo:clip |
| overflow | [0..1] | Anonymous | Whether the content of a block-level element is clipped when it overflows the element's box (which is acting as a containing block for the content). CSS2 Reference: | from group fo:overflow |
| reference-orientation | [0..1] | Anonymous | 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, and the orientation, placement, and tiling of the background. | from group fo:reference-orientation |
| span | [0..1] | Anonymous | Whether a block-level object should be placed in the current column or should span all columns of a multi-column region. | from group fo:span |
| block-progression-dimension | [0..1] | fo:progression-dimension | The block-progression-dimension of the content-rectangle for each area generated by this formatting object. The user may specify an explicit size (<length> or <percentage>) or a <length-range>, allowing the size to be adjusted by the formatter. | from group fo:block-progression-dimension |
| break-after | [0..1] | fo:break | Specifies that the first normal area generated by formatting the next formatting object, if any, shall be the first one placed in a particular context (e.g. page-area, column-area) | from group fo:break-after |
| break-before | [0..1] | fo:break | 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). | from group fo:break-before |
| clear | [0..1] | Anonymous | Which sides of an element's box(es) may not be adjacent to an earlier floating box. (It may be that the element itself has floating descendants; the 'clear' property has no effect on those.) CSS2 Reference: | from group fo:clear |
| display-align | [0..1] | Anonymous | The alignment, in the block-progression-direction, of the areas that are the children of a reference-area. | from group fo:display-align |
| height | [0..1] | fo:box-dimension | The content height of boxes generated by block-level and replaced elements. This property does not apply to non-replaced inline-level elements. The height of a non-replaced inline element's boxes is given by the element's (possibly inherited) 'line-height' value. CSS2 Reference: | from group fo:height |
| id | [0..1] | fo:id | An identifier unique within all objects in the result tree with the fo: namespace. It allows references to this formatting object by other objects. | from group fo:id |
| index-class | [0..1] | fo:string | Associates an index class with a formatting object that also has an index key specified. | from group fo:index-class |
| index-key | [0..1] | fo:string | Associates an index key with the formatting object on which it is specified. | from group fo:index-key |
| inline-progression-dimension | [0..1] | fo:progression-dimension | The inline-progression-dimension of the content-rectangle for each area generated by this formatting object. The user may specify an explicit size (<length> or <percentage>) or a <length-range>, allowing the size to be adjusted by the formatter. This property does not apply when the "line-height" property applies to the same dimension of the areas generated by this formatting object. | from group fo:inline-progression-dimension |
| intrusion-displace | [0..1] | Anonymous | Determines the displacement strategy in the presence of intrusions. | from group fo:intrusion-displace |
| keep-together | [0..1] | fo:keep | Imposes keep-together conditions on formatting objects. | from group fo:keep-together |
| keep-together.within-line | [0..1] | fo:keep-value | from group fo:keep-together | |
| keep-together.within-column | [0..1] | fo:keep-value | from group fo:keep-together | |
| keep-together.within-page | [0..1] | fo:keep-value | from group fo:keep-together | |
| keep-with-next | [0..1] | fo:keep | Imposes keep-with-next conditions on formatting objects. | from group fo:keep-with-next |
| keep-with-next.within-line | [0..1] | fo:keep-value | from group fo:keep-with-next | |
| keep-with-next.within-column | [0..1] | fo:keep-value | from group fo:keep-with-next | |
| keep-with-next.within-page | [0..1] | fo:keep-value | from group fo:keep-with-next | |
| keep-with-previous | [0..1] | fo:keep | Imposes keep-with-previous conditions on formatting objects. | from group fo:keep-with-previous |
| keep-with-previous.within-line | [0..1] | fo:keep-value | from group fo:keep-with-previous | |
| keep-with-previous.within-column | [0..1] | fo:keep-value | from group fo:keep-with-previous | |
| keep-with-previous.within-page | [0..1] | fo:keep-value | from group fo:keep-with-previous | |
| page-break-after | [0..1] | fo:page-break | A potential page break location is typically under the influence of the parent element's 'page-break-inside' property, the 'page-break-after' property of the preceding element, and the 'page-break-before' property of the following element. When these properties have values other than 'auto', the values 'always', 'left', and 'right' take precedence over 'avoid'. CSS2 Reference: | from group fo:page-break-after |
| page-break-before | [0..1] | fo:page-break | A potential page break location is typically under the influence of the parent element's 'page-break-inside' property, the 'page-break-after' property of the preceding element, and the 'page-break-before' property of the following element. When these properties have values other than 'auto', the values 'always', 'left', and 'right' take precedence over 'avoid'. CSS2 Reference: | from group fo:page-break-before |
| page-break-inside | [0..1] | Anonymous | A potential page break location is typically under the influence of the parent element's 'page-break-inside' property, the 'page-break-after' property of the preceding element, and the 'page-break-before' property of the following element. When these properties have values other than 'auto', values 'always', 'left', and 'right' take precedence over 'avoid'. CSS2 Reference: | from group fo:page-break-inside |
| width | [0..1] | fo:box-dimension | The content width of boxes generated by block-level and replaced elements. This property does not apply to non-replaced inline-level elements. The width of a non-replaced inline element's boxes is that of the rendered content within them (before any relative offset of children). Recall that inline boxes flow into line boxes. The width of line boxes is given by their containing block, but may be shorted by the presence of floats. CSS2 Reference: | from group fo:width |
| writing-mode | [0..1] | Anonymous | from group fo:writing-mode | |
| z-index | [0..1] | Anonymous | For a positioned box, the "z-index" property specifies: 1. The stack level of the box in the current stacking context. 2. Whether the box establishes a local stacking context. CSS2 Reference: | from group fo:z-index |
Used in
- Anonymous type of element fo:basic-link via reference to fo:block-or-inline
- Anonymous type of element fo:bidi-override via reference to fo:block-or-inline
- Anonymous type of element fo:block via reference to fo:block-or-inline
- Anonymous type of element fo:block-container via reference to fo:block
- Anonymous type of element fo:float via reference to fo:block
- Anonymous type of element fo:footnote-body via reference to fo:block
- Anonymous type of element fo:inline via reference to fo:block-or-inline
- Anonymous type of element fo:inline-container via reference to fo:block
- Anonymous type of element fo:marker via reference to fo:block-or-inline
- Anonymous type of element fo:multi-case via reference to fo:block-or-inline
- Anonymous type of element fo:multi-toggle via reference to fo:block-or-inline
- Anonymous type of element fo:table-caption via reference to fo:block
- Anonymous type of element fo:table-cell via reference to fo:block
- Anonymous type of element fo:wrapper via reference to fo:block-or-inline
- Group fo:block via reference to fo:block-only
- Group fo:block-only
- Group fo:block-or-inline via reference to fo:block-only
- Type fo:block-sequence via reference to fo:block (Elements fo:flow, fo:static-content)
- Type fo:list-item-part via reference to fo:block (Elements fo:list-item-body, fo:list-item-label)
Sample instance
<fo:block-container> <fo:block>Any text, intermingled with: <fo:block>Any text, intermingled with: <fo:block>Any text, intermingled with:... </fo:block> </fo:block> </fo:block> </fo:block-container>