fo:change-bar-begin
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.
Element information
Namespace: http://www.w3.org/1999/XSL/Format
Schema document: fo.xsd
Type: Anonymous
Properties: Global, Qualified
Content
- Empty content
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 |
| change-bar-class | [0..1] | fo:name | Associates a name with an fo:change-bar-begin or fo:change-bar-end element so that they can be matched to each other even if other fo:change-bar-begin and fo:change-bar-end elements are interspersed. This allows for "straddling pairs" of these elements. | from group fo:change-bar-class |
| change-bar-color | [0..1] | fo:color | from group fo:change-bar-color | |
| change-bar-offset | [0..1] | fo:length | from group fo:change-bar-offset | |
| change-bar-placement | [0..1] | Anonymous | Determines where, relative to the column areas, the change bars will occur. | from group fo:change-bar-placement |
| change-bar-style | [0..1] | fo:border-style | The style of the change bar. | from group fo:change-bar-style |
| change-bar-width | [0..1] | fo:border-width | The thickness of the change bar. | from group fo:change-bar-width |
| 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:leader via reference to fo:inline
- 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:title via reference to fo:inline
- Anonymous type of element fo:wrapper via reference to fo:block-or-inline
- Group fo:block via reference to fo:either-block-or-inline
- Group fo:block-or-inline via reference to fo:either-block-or-inline
- Group fo:either-block-or-inline
- Group fo:inline via reference to fo:either-block-or-inline
- 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)
- Type fo:simple-mixed-text via reference to fo:inline (Elements fo:folio-prefix, fo:folio-suffix, fo:index-page-number-prefix, fo:index-page-number-suffix, fo:index-page-citation-list-separator, fo:index-page-citation-range-separator)
Sample instance
<fo:change-bar-begin/>