Uploaded image for project: 'OASIS Open Document Format for Office Applications (OpenDocument) TC'
  1. OASIS Open Document Format for Office Applications (OpenDocument) TC
  2. OFFICE-4124

'clear' attribute for line breaks

    XMLWordPrintable

    Details

    • Type: Improvement
    • Status: Open
    • Priority: Major
    • Resolution: Unresolved
    • Affects Version/s: ODF 1.3
    • Fix Version/s: ODF 1.5
    • Component/s: Part 3 (Schema) [1.2: 1], Text
    • Labels:
      None
    • Proposal:
      Hide

      Requested changes to the ODF Standard

      Text changes/additions (compared to ODF 1.3)

      6.1.5 <text:line-break> (existing section)

      Append to the end of allowed attributes: text:clear.

      20.436 text:clear (new section)

      Specifies where the next line should appear after a line break. Possible values:

      • none: continue right after the current line
      • all: continue at the next full line, that is below all of the anchored objects intersecting with the current line
      • left: continue at the next line which is unblocked on the left hand side
      • right: continue at the next line which is unblocked on the right hand side

       The default value for the text:clear attribute is none.

      Schema changes/additions:

        <rng:define name="paragraph-content" combine="choice">
    <rng:element name="text:line-break">
      <rng:optional>
        <!-- default value: none -->
        <rng:attribute name="text:clear">
          <rng:choice>
            <rng:value>none</rng:value>
            <rng:value>left</rng:value>
            <rng:value>right</rng:value>
            <rng:value>all</rng:value>
          </rng:choice>
        </rng:attribute>
      </rng:optional>
    </rng:element>
  </rng:define>

      In other words, allow text:clear as a new attribute of the existing
      <text:line-break> element.

       

      Show
      Requested changes to the ODF Standard Text changes/additions (compared to ODF 1.3) 6.1.5 <text:line-break> (existing section) Append to the end of allowed attributes: text:clear . 20.436 text:clear (new section) Specifies where the next line should appear after a line break. Possible values: none : continue right after the current line all : continue at the next full line, that is below all of the anchored objects intersecting with the current line left : continue at the next line which is unblocked on the left hand side right : continue at the next line which is unblocked on the right hand side  The default value for the text:clear attribute is none . Schema changes/additions: <rng:define name= "paragraph-content" combine= "choice" > <rng:element name= "text:line-break" > <rng:optional> <!-- default value: none --> <rng:attribute name= "text:clear" > <rng:choice> <rng:value> none </rng:value> <rng:value> left </rng:value> <rng:value> right </rng:value> <rng:value> all </rng:value> </rng:choice> </rng:attribute> </rng:optional> </rng:element> </rng:define> In other words, allow text:clear as a new attribute of the existing <text:line-break> element.  

      Description

      Rationale

      Use cases

      The clear attribute for a line break defines where a next line should appear after line break in case anchored objects intersect with the current line.

      Users sometimes want to make sure that the next line continues at the next full line, below an anchored object, without starting a new paragraph.

      Alternatives considered

      It is possible to have a similar (but not exactly the same) layout by expressing the same content with two paragraphs, and enabling "anchor only" wrapping for the anchored object. The problem is that this works with two paragraphs, so it's different layout when it comes to various paragraph properties (spacing, etc). 

      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 <w:br w:clear="..."/> markup to describe the same, this proposal allows roundtripping that feature in ODF. LibreOffice 7.4 implements this layout feature in its ODF extension namespace.

      HTML, combined with CSS also allows to describe the same, this proposal allows roundtripping that feature in ODF.

        Attachments

          Activity

            People

            • Assignee:
              regina.henschel Regina Henschel
              Reporter:
              regina.henschel Regina Henschel
            • Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated: