Summary

Proposal owner: Miklos Vajna

Proposal short name: Page-content-bottom vertical relation

Rationale

Use cases

Users sometimes want to specify the vertical position of their shapes in text documents in a way that is relative from the bottom of the page content area.

Also, this improves consistency, specifying a position that is relative from the top of the page content area is already possible.

Alternatives considered

It is possible to have the same calculated position when positioning from the top of the page content area. The downside of this approach is that the position changes when the page height changes. So if the user intention is to position a shape 2 cm above the bottom of the page content area and the page height changes, the shape has to be manually re-positioned. This manual re-positioning is not needed with the proposed markup.

For example, if a shape has a height of 10 cm and a 2 cm spacing is wanted between the bottom of the shape and the bottom of the page content area, the position can be set to -12 cm, and then the 2 cm spacing will be maintained, even after the page height changes.

Requested changes to the ODF Standard

Text changes/additions (compared to ODF 1.2)

20.388 <style:vertical-rel> (existing section)

Append to the end of defined values for the style:vertical-rel attribute list:

page-content-bottom: vertical position of frame positioned relative to the
bottom of page content.

Append to the end of style:vertical-rel attribute value list:
page-content-bottom.

Table 23 - Vertical Relation Values:

page-content-bottom is allowed for page, paragraph and char text:anchor-type
values.

Schema changes/additions

<rng:define name="common-vertical-rel-attlist" combine="interleave">
{{ <rng:optional>}}
{{ <rng:attribute name="loext:vertical-rel">}}
{{ <rng:choice>}}
{{ <rng:value>page-content-bottom</rng:value>}}
{{ </rng:choice>}}
{{ </rng:attribute>}}
{{ </rng:optional>}}
{{ </rng:define>}}

In other words, allow page-content-bottom as a new value of the
style:vertical-rel attribute.

Impacts

Conformance

This proposal will not add any mandatory features or behaviors.

Backwards compatibility

This change will not impact existing ODF processors, the usage of the new attribute value is optional.

Accessibility impact

This change will not impact accessibility.

Interoperability

OOXML's wordprocessingML has a <wp:positionV relativeFrom="bottomMargin"> markup to describe the same, this proposal allows roundtripping that feature in ODF. LibreOffice 7.0 implements this layout feature in its ODF extension namespace.

As per attachment:

20.397 style:vertical-pos

The style:vertical-pos attribute specifies the vertical alignment of a frame in relation to an area or line specified by the style:vertical-rel [20.402] attribute.

The defined values for the style:vertical-pos attribute are:

• below: the top corner of the frame is positioned below the reference area or line.

• bottom: the bottom of the frame is aligned with the bottom edge of the reference area or line.

• from-top: the svg:y attribute associated with the frame element specifies the vertical position of the the top edge of the frame relative to a reference line. Otherwise, the svg:y attribute is ignored for text documents.

In case the attribute style:vertical-rel specifies an area, the top edge of the area is used as reference line.

• middle: the middle of the frame is aligned with the middle of the reference area or line.

• top: the top of the frame is aligned with the top edge of the reference area or line.

20.398 style:vertical-rel

The style:vertical-rel attribute specifies the area or line against which the vertical position of a frame is positioned.

The defined values for the style:vertical-rel attribute are:
baseline: vertical position of frame positioned relative to a baseline.
char: vertical position of frame positioned relative to a character.
frame: vertical position of frame positioned relative to a frame area.
frame-content: vertical position of frame positioned relative to frame content area.
line: vertical position of frame positioned relative to a line.
page: vertical position of frame positioned relative to a page area.
page-content: vertical position of frame positioned relative to page content area.
page-content-bottom: vertical position of frame positioned relative to the area below the page content area.
paragraph: vertical position of frame positioned relative to a paragraph area.
paragraph-content: vertical position of frame positioned relative to paragraph content area.
text: vertical position of frame positioned relative to text.

Table 24 displays the defined values of style:vertical-rel and text:anchor-type attributes. Value combinations that can appear in a document are marked with an X.

Editorial note: See attached image of revised Table 24.