fo:list-block
A list.
Element information
Namespace: http://www.w3.org/1999/XSL/Format
Schema document: fo.xsd
Type: Anonymous
Properties: Global, Qualified
Content
- fo:list-item [1..*]The label and the body of an item in a list.
Attributes
| Name | Occ | Type | Description | Notes |
|---|---|---|---|---|
| source-document | [0..1] | Anonymous | A pointer back to the original XML document(s) used to create this formatting object tree, in accordance with the Dublin Core definition of "Source" ("A Reference to a resource from which the present resource is derived." See: http://purl.org/DC/documents/rec-dces-19990702.htm .) The value is not validated by and has no inherent standardized semantics for any XSL processor. | from group fo:source-document |
| role | [0..1] | Anonymous | A hint for alternate renderers (aural readers, etc.) as to the role of the XML element or elements that were used to construct this formatting object, if one could be identified during XSLT tree construction. This information can be used to prepare alternate renderings when the normal rendering of a formatting object is not appropriate or satisfactory; for example, the role information can be used to provide better aural renderings of visually formatted material. 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.) | from group fo:role |
| azimuth | [0..1] | Anonymous | CSS2 Reference: | from group fo:azimuth |
| cue-after | [0..1] | fo:cue | Sound to be played before the element to delimit it. CSS2 Reference: | from group fo:cue-after |
| cue-before | [0..1] | fo:cue | Sound to be played after the element to delimit it. CSS2 Reference: | from group fo:cue-before |
| cue | [0..1] | Anonymous | A shorthand for setting 'cue-before' and 'cue-after'. If two values are given, the first value is 'cue-before' and the second is 'cue-after'. If only one value is given, it applies to both properties. CSS2 Reference: | from group fo:cue |
| elevation | [0..1] | Anonymous | CSS2 Reference: | from group fo:elevation |
| pause-after | [0..1] | fo:pause | A pause to be observed before speaking an element's content. CSS2 Reference: | from group fo:pause-after |
| pause-before | [0..1] | fo:pause | A pause to be observed after speaking an element's content. CSS2 Reference: | from group fo:pause-before |
| pause | [0..1] | Anonymous | A shorthand for setting 'pause-before' and 'pause-after'. If two values are given, the first value is 'pause-before' and the second is 'pause-after'. If only one value is given, it applies to both properties. CSS2 Reference: | from group fo:pause |
| pitch | [0..1] | Anonymous | The average pitch (a frequency) of the speaking voice. The average pitch of a voice depends on the voice family. For example, the average pitch for a standard male voice is around 120Hz, but for a female voice, it's around 210Hz. CSS2 Reference: | from group fo:pitch |
| pitch-range | [0..1] | fo:number-or-inherit | Variation in average pitch. The perceived pitch of a human voice is determined by the fundamental frequency and typically has a value of 120Hz for a male voice and 210Hz for a female voice. Human languages are spoken with varying inflection and pitch; these variations convey additional meaning and emphasis. Thus, a highly animated voice, i.e., one that is heavily inflected, displays a high pitch range. This property specifies the range over which these variations occur, i.e., how much the fundamental frequency may deviate from the average pitch. CSS2 Reference: | from group fo:pitch-range |
| play-during | [0..1] | Anonymous | Similar to the 'cue-before' and 'cue-after' properties, this property specifies a sound to be played as a background while an element's content is spoken. CSS2 Reference: | from group fo:play-during |
| richness | [0..1] | fo:number-or-inherit | The richness, or brightness, of the speaking voice. A rich voice will "carry" in a large room, a smooth voice will not. (The term "smooth" refers to how the wave form looks when drawn.). A value between '0' and '100'. The higher the value, the more the voice will carry. A lower value will produce a soft, mellifluous voice. CSS2 Reference: | from group fo:richness |
| speak | [0..1] | Anonymous | Whether text will be rendered aurally and if so, in what manner. CSS2 Reference: | from group fo:speak |
| speak-header | [0..1] | Anonymous | Whether table headers are spoken before every cell, or only before a cell when that cell is associated with a different header than the previous cell. CSS2 Reference: | from group fo:speak-header |
| speak-numeral | [0..1] | Anonymous | How numerals are spoken. CSS2 Reference: | from group fo:speak-numeral |
| speak-punctuation | [0..1] | Anonymous | How punctuation is spoken. CSS2 Reference: | from group fo:speak-punctuation |
| speech-rate | [0..1] | Anonymous | The speaking rate. Note that both absolute and relative keyword values are allowed (compare with 'font-size'). CSS2 Reference: | from group fo:speech-rate |
| stress | [0..1] | fo:number-or-inherit | The height of "local peaks" in the intonation contour of a voice. For example, English is a stressed language, and different parts of a sentence are assigned primary, secondary, or tertiary stress. The value of 'stress' controls the amount of inflection that results from these stress markers. This property is a companion to the 'pitch-range' property and is provided to allow developers to exploit higher-end auditory displays. A value, between '0' and '100'. The meaning of values depends on the language being spoken. For example, a level of '50' for a standard, English-speaking male voice (average pitch = 122Hz), speaking with normal intonation and emphasis would have a different meaning than '50' for an Italian voice. CSS2 Reference: | from group fo:stress |
| voice-family | [0..1] | Anonymous | A comma-separated, prioritized list of voice family names. CSS2 Reference: | from group fo:voice-family |
| volume | [0..1] | Anonymous | The median volume of the waveform. In other words, a highly inflected voice at a volume of 50 might peak well above that. The overall values are likely to be human adjustable for comfort, for example with a physical volume control (which would increase both the 0 and 100 values proportionately); what this property does is adjust the dynamic range. CSS2 Reference: | from group fo:volume |
| 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 |
| 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 |
| relative-position | [0..1] | Anonymous | from group fo:relative-position | |
| position | [0..1] | Anonymous | The positioning scheme to be used. CSS2 Reference: | from group fo:position |
| 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 |
| 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 |
| 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 |
| provisional-distance-between-starts | [0..1] | fo:length-percentage-or-inherit | The provisional distance between the start-indent of the list-item-label and the start-indent of the list-item-body. The value is not directly used during formatting, but is used in the computation of the value of the body-start function. | from group fo:provisional-distance-between-starts |
| provisional-label-separation | [0..1] | fo:length-percentage-or-inherit | The provisional distance between the end of the list-item-label and the start of the list-item-body. The value is not directly used during formatting, but is used in the computation of the value of the label-end function. | from group fo:provisional-label-separation |
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:list-block> <fo:list-item> <fo:list-item-label> <fo:block>Any text, intermingled with:... </fo:block> </fo:list-item-label> <fo:list-item-body> <fo:block>Any text, intermingled with:... </fo:block> </fo:list-item-body> </fo:list-item> </fo:list-block>