Table of contents

Appendices

7.14 Area Dimension Properties

block-progression-dimension[top]

Writing-mode Relative Equivalent of a CSS2 Property.

This property specifies 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.

This property does not apply when the "line-height" property applies to the same dimension of the areas generated by this formatting object.

Values have the following meanings:

auto

No constraint is imposed by this property. The block-progression-dimension is determined by the formatter taking all other constraints into account.

Specifying block-progression-dimension="auto" will set:

• block-progression-dimension.minimum="auto"

• block-progression-dimension.optimum="auto"

• block-progression-dimension.maximum="auto"

<length>

Specifies a fixed block-progression-dimension.

Specifying block-progression-dimension=<length> will set:

• block-progression-dimension.minimum=<length>

• block-progression-dimension.optimum=<length>

• block-progression-dimension.maximum=<length>

<percentage>

Specifies a percentage block-progression-dimension. The percentage is calculated with respect to the corresponding dimension of the closest area ancestor that was generated by a block-level formatting object. If that dimension is not specified explicitly (i.e., it depends on content's block-progression-dimension), the value is interpreted as "auto".

Specifying block-progression-dimension=<percentage> will set:

• block-progression-dimension.minimum=<percentage>

• block-progression-dimension.optimum=<percentage>

• block-progression-dimension.maximum=<percentage>

<length-range>

Specifies the dimension as a length-range, consisting of:

• block-progression-dimension.optimum

  This is the preferred dimension of the area created; if minimum and maximum are identical, the area is of a fixed dimension. If they are, respectively, smaller and larger than optimum, then the area may be adjusted in dimension within that range.

  A value of "auto" may be specified for optimum, indicating that there is no preferred dimension, but that the intrinsic or resolved dimension of the area should be used. If minimum and/or maximum are not also auto, then the dimension shall be constrained between those limits.

• block-progression-dimension.minimum

• block-progression-dimension.maximum

  A value of "auto" may be specified for block-progression-dimension.maximum. This indicates that there is no absolute maximum limit, and the object may be sized to its intrinsic size.

Negative values for block-progression-dimension.minimum, block-progression-dimension.optimum, and block-progression-dimension.maximum are invalid and are treated as if "0pt" had been specified.

If the value of block-progression-dimension.optimum is "auto" and the computed value of block-progression-dimension.minimum is greater than the computed value of block-progression-dimension.maximum the block-progression-dimension.minimum is treated as if the value of block-progression-dimension.maximum had been specified.

content-height[top]

XSL Definition:

Values have the following meanings:

auto

The content-height should be the intrinsic content-height.

scale-to-fit

A size of the content-height equal to the height of the viewport. This value implies a certain scaling factor to be applied onto the content.

<length>

An absolute size for the content-height. This value implies a certain scaling factor to be applied onto the content.

<percentage>

A percentage representing a scaling factor for the content-height.

Specifies 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.

content-width[top]

XSL Definition:

Values have the following meanings:

auto

The content-width should be the intrinsic content-width.

scale-to-fit

A size of the content-width equal to the width of the viewport. This value implies a certain scaling factor to be applied onto the content.

<length>

An absolute size for the content-width. This value implies a certain scaling factor to be applied onto the content.

<percentage>

A percentage representing a scaling factor for the content-width.

Specifies 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.

height[top]

CSS2 Definition:

CSS2 Reference: [ "height" property ] http://www.w3.org/TR/REC-CSS2/visudet.html#propdef-height

This property specifies 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.

Values have the following meanings:

auto

The height depends on the values of other properties.

<length>

Specifies a fixed height.

<percentage>

Specifies a percentage height. The percentage is calculated with respect to the height of the generated box's containing block. If the height of the containing block is not specified explicitly (i.e., it depends on content height), the value is interpreted like "auto".

Negative values for 'height' are illegal.

XSL modifications to the CSS definition:

In XSL, this property is mapped to either "inline-progression-dimension" or "block-progression-dimension", based on the applicable values of the "writing-mode" and "reference-orientation" properties. Details on the mapping are given in [refinement] .

For a discussion of the "height" property in tables see: [http://www.w3.org/TR/REC-CSS2/tables.html]

inline-progression-dimension[top]

Writing-mode Relative Equivalent of a CSS2 Property.

This property specifies 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.

Values have the following meanings:

auto

No constraint is imposed by this property. The inline-progression-dimension is determined by the formatter taking all other constraints into account.

Specifying inline-progression-dimension=auto will set:

• inline-progression-dimension.minimum=auto

• inline-progression-dimension.optimum=auto

• inline-progression-dimension.maximum=auto

<length>

Specifies a fixed inline-progression-dimension.

Specifying inline-progression-dimension=<length> will set:

• inline-progression-dimension.minimum=<length>

• inline-progression-dimension.optimum=<length>

• inline-progression-dimension.maximum=<length>

<percentage>

Specifies a percentage inline-progression-dimension. The percentage is calculated with respect to the corresponding dimension of the closest area ancestor that was generated by a block-level formatting object. If that dimension is not specified explicitly (i.e., it depends on content's inline-progression-dimension), the value is interpreted as "auto".

Specifying inline-progression-dimension=<percentage> will set:

• inline-progression-dimension.minimum=<percentage>

• inline-progression-dimension.optimum=<percentage>

• inline-progression-dimension.maximum=<percentage>

<length-range>

Specifies the dimension as a length-range, consisting of:

• inline-progression-dimension.optimum

  This is the preferred dimension of the area created, if minimum and maximum are identical, the area is of a fixed dimension. If they are, respectively, smaller and larger than optimum, then the area may be adjusted in dimension within that range.

  A value of "auto" may be specified for optimum, indicating that there is no preferred dimension, but that the intrinsic or resolved dimension of the area should be used. If minimum and/or maximum are not also auto, then the dimension shall be constrained between those limits.

• inline-progression-dimension.minimum

• inline-progression-dimension.maximum

  A value of "auto" may be specified for inline-progression-dimension.maximum. This indicates that there is no absolute maximum limit, and the object may be sized to its intrinsic size.

Negative values for inline-progression-dimension.minimum, inline-progression-dimension.optimum, and inline-progression-dimension.maximum are invalid and are treated as if "0pt" had been specified.

max-height[top]

CSS2 Definition:

CSS2 Reference: [ "max-height" property ] http://www.w3.org/TR/REC-CSS2/visudet.html#propdef-max-height

These two properties ["max-height" and "max-width"] allow authors to constrain box heights to a certain range. Values have the following meanings:

none

(Only on "max-height") No limit on the height of the box.

<length>

Specifies a fixed minimum or maximum computed height.

<percentage>

Specifies a percentage for determining the computed value. The percentage is calculated with respect to the height of the generated box's containing block. If the height of the containing block is not specified explicitly (i.e., it depends on content height), the percentage value is interpreted like "auto".

XSL modifications to the CSS definition:

In XSL, this property is mapped to either "inline-progression-dimension" or "block-progression-dimension", based on the applicable values of the "writing-mode" and "reference-orientation" properties. Details on the mapping are given in [refinement] .

max-width[top]

CSS2 Definition:

CSS2 Reference: [ "max-width" property ] http://www.w3.org/TR/REC-CSS2/visudet.html#propdef-max-width

These two properties ["max-height" and "max-width"] allow authors to constrain box widths to a certain range. Values have the following meanings:

none

(Only on "max-width") No limit on the width of the box.

<length>

Specifies a fixed minimum or maximum computed width.

<percentage>

Specifies a percentage for determining the computed value. The percentage is calculated with respect to the width of the generated box's containing block.

XSL modifications to the CSS definition:

In XSL, this property is mapped to either "inline-progression-dimension" or "block-progression-dimension", based on the applicable values of the "writing-mode" and "reference-orientation" properties. Details on the mapping are given in [refinement] .

min-height[top]

CSS2 Definition:

CSS2 Reference: [ "min-height" property ] http://www.w3.org/TR/REC-CSS2/visudet.html#propdef-min-height

XSL modifications to the CSS definition:

In XSL, this property is mapped to either "inline-progression-dimension" or "block-progression-dimension", based on the applicable values of the "writing-mode" and "reference-orientation" properties. Details on the mapping are given in [refinement] .

min-width[top]

CSS2 Definition:

CSS2 Reference: [ "min-width" property ] http://www.w3.org/TR/REC-CSS2/visudet.html#propdef-min-width

XSL modifications to the CSS definition:

In XSL, this property is mapped to either "inline-progression-dimension" or "block-progression-dimension", based on the applicable values of the "writing-mode" and "reference-orientation" properties. Details on the mapping are given in [refinement] .

scaling[top]

XSL Definition:

Values have the following meanings:

uniform

Scaling should preserve the aspect ratio.

non-uniform

Scaling need not preserve the aspect ratio.

Specifies whether scaling needs to preserve the intrinsic aspect ratio.

scaling-method[top]

XSL Definition:

Values have the following meanings:

auto

The User Agent is free to choose either resampling, integer scaling, or any other scaling method.

integer-pixels

The User Agent should scale the image such that each pixel in the original image is scaled to the nearest integer number of device-pixels that yields an image less-then-or-equal-to the image size derived from the content-height, content-width, and scaling properties.

resample-any-method

The User Agent should resample the supplied image to provide an image that fills the size derived from the content-height, content-width, and scaling properties. The user agent may use any sampling method.

This property is used to indicate a preference in the scaling/sizing tradeoff to be used when formatting bitmapped graphics.

NOTE: 

This is defined as a preference to allow the user agent the flexibility to adapt to device limitations and to accommodate over-constrained situations involving min/max dimensions and scale factors.

width[top]

CSS2 Definition:

CSS2 Reference: [ "width" property ] http://www.w3.org/TR/REC-CSS2/visudet.html#propdef-width

This property specifies 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.

The width of a replaced element's box is intrinsic and may be scaled by the user agent if the value of this property is different than 'auto'.

Values have the following meanings:

auto

The width depends on the values of other properties.

<length>

Specifies a fixed width.

<percentage>

Specifies a percentage width. The percentage is calculated with respect to the width of the generated box's containing block.

Negative values for "width" are illegal.

XSL modifications to the CSS definition:

In XSL, this property is mapped to either "inline-progression-dimension" or "block-progression-dimension", based on the applicable values of the "writing-mode" and "reference-orientation" properties. Details on the mapping are given in [refinement] .