fo:instream-foreign-object
An inline graphic or other "generic" object where the object data resides as descendants of the fo:instream-foreign-object.
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 |
| 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-end | [0..1] | fo:space-amount | The minimum, optimum, and maximum values for the space after any areas generated by this formatting object and the conditionality and precedence of this space. | from group fo:space-end |
| space-end.minimum | [0..1] | fo:length | from group fo:space-end | |
| space-end.optimum | [0..1] | fo:length | from group fo:space-end | |
| space-end.maximum | [0..1] | fo:length | from group fo:space-end | |
| space-end.conditionality | [0..1] | fo:conditionality | from group fo:space-end | |
| space-end.precedence | [0..1] | fo:precedence | from group fo:space-end | |
| space-start | [0..1] | fo:space-amount | The minimum, optimum, and maximum values for the space before any areas generated by this formatting object and the conditionality and precedence of this space. | from group fo:space-start |
| space-start.minimum | [0..1] | fo:length | from group fo:space-start | |
| space-start.optimum | [0..1] | fo:length | from group fo:space-start | |
| space-start.maximum | [0..1] | fo:length | from group fo:space-start | |
| space-start.conditionality | [0..1] | fo:conditionality | from group fo:space-start | |
| space-start.precedence | [0..1] | fo:precedence | from group fo:space-start | |
| 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 |
| alignment-adjust | [0..1] | Anonymous | Allows more precise alignment of areas generated by formatting objects, in particular for formatting objects, such as graphics, that do not have a baseline-table or lack the desired baseline in their baseline-table. With the "alignment-adjust" property, the position of the baseline identified by the "alignment-baseline" can be explicitly determined. | from group fo:alignment-adjust |
| alignment-baseline | [0..1] | Anonymous | How an object is aligned with respect to its parent. That is, to which of the parent's baselines the alignment-point of this object is aligned. The alignment-adjust property specifies how the alignment point is determined. It defaults to the baseline with the same name as the computed value of the alignment-baseline property. That is, the position of "ideographic" alignment-point in the block-progression-direction is the position of the "ideographic" baseline in the baseline-table of the object being aligned. | from group fo:alignment-baseline |
| allowed-height-scale | [0..1] | fo:scale | A list of constraints on the scale-factor values that may be used when scaling a graphic in the height direction. The list is unordered, except that an "any" value is considered last and is only used if the scaling constraints cannot be satisfied using any of the other specified values. | from group fo:allowed-height-scale |
| allowed-width-scale | [0..1] | fo:scale | A list of constraints on the scale-factor values that may be used when scaling a graphic in the width direction. The list is unordered, except that an "any" value is considered last and is only used if the scaling constraints cannot be satisfied using any of the other specified values. | from group fo:allowed-width-scale |
| baseline-shift | [0..1] | Anonymous | Allows repositioning of the dominant-baseline relative to the dominant-baseline of the parent area. The shifted object might be a subscript or superscript. Within the shifted object, the whole baseline-table is offset; not just a single baseline. The amount of the shift is determined from information from the parent area, the subscript or superscript offset from the nominal-font of the parent area, percent of the "line-height" of the parent area or an absolute value. | from group fo:baseline-shift |
| 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 |
| clip | [0..1] | Anonymous | Applies to elements that have a 'overflow' property with a value other than 'visible'. CSS2 Reference: | from group fo:clip |
| content-height | [0..1] | Anonymous | The content-height of some object (e.g., an external graphic). If the value is a percentage, the value of this property is the percentage applied to the intrinsic height. | from group fo:content-height |
| content-type | [0..1] | Anonymous | The content-type and may be used by a User Agent to select a rendering processor for the object. | from group fo:content-type |
| content-width | [0..1] | Anonymous | The content-width of some object (e.g., an external graphic). If the value is a percentage, the value of this property is the percentage applied to the intrinsic width. | from group fo:content-width |
| 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 |
| dominant-baseline | [0..1] | Anonymous | from group fo:dominant-baseline | |
| 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 |
| 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 | |
| line-height | [0..1] | Anonymous | On a block container element whose content is composed of inline-level elements, 'line-height' specifies the minimal height of line boxes within the element. CSS2 Reference: | from group fo:line-height |
| 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 |
| scaling | [0..1] | Anonymous | Whether scaling needs to preserve the intrinsic aspect ratio. | from group fo:scaling |
| scaling-method | [0..1] | Anonymous | Indicates a preference in the scaling/sizing tradeoff to be used when formatting bitmapped graphics. | from group fo:scaling-method |
| text-align | [0..1] | Anonymous | How inline content of a block is aligned. For fo:external-graphic, fo:instream-foreign-object, and fo:table-and-caption it specifies the alignment of other areas as described in the constraint section for these formatting objects. CSS2 Reference: | from group fo:text-align |
| vertical-align | [0..1] | Anonymous | Affects the vertical positioning inside a line box of the boxes generated by an inline-level element. The following values only have meaning with respect to a parent inline-level element, or to a parent block-level element, if that element generates anonymous inline boxes; they have no effect if no such parent exists. CSS2 Reference: | from group fo:vertical-align |
| 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 |
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:inline via reference to fo:block-or-inline
- 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:title via reference to fo:inline
- Anonymous type of element fo:wrapper via reference to fo:block-or-inline
- Group fo:block-or-inline via reference to fo:inline-only
- Group fo:inline via reference to fo:inline-only
- Group fo:inline-only
- 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:instream-foreign-object/>