Kurzbeschreibung

Das XML-Element <Break> erzeugt einen Umbruch innerhalb des Dokuments.

Abhängig vom Attribut BreakType kann ein Zeilenumbruch, Spaltenumbruch oder Seitenumbruch eingefügt werden.

Einordnung

Bereich: Inhalte

Schwierigkeitsgrad: ⭐☆☆☆☆

Vorkenntnisse: Block · Content

Siehe auch

• Block
• Content
• Text

Zweck

Mit <Break> kann die laufende Ausgabe an einer bestimmten Stelle unterbrochen und anschließend an einer neuen Zeile, in der nächsten Spalte oder auf einer neuen Seite fortgesetzt werden.

Typische Einsatzgebiete sind:

• Zeilenumbrüche innerhalb eines Blocks,
• Spaltenwechsel in mehrspaltigen Bereichen,
• gezielte Seitenumbrüche,
• Trennung logisch zusammengehörender Inhalte.

Position innerhalb der Dokumentvorlage

<Break> erzeugt einen sichtbaren Umbruch und wird deshalb innerhalb eines <Content> verwendet.

<Block>

    <Content>

        <Text Content="Erste Zeile">
        </Text>

        <Break BreakType="textWrapping">
        </Break>

        <Text Content="Zweite Zeile">
        </Text>

    </Content>

</Block>

Beide Texte gehören zum selben Block. Durch <Break> wird der zweite Text jedoch in einer neuen Zeile ausgegeben.

Eigenschaften

Attribute

BreakType

Über BreakType wird die Art des Umbruchs festgelegt.

Hinweis

Wird BreakType nicht angegeben, erzeugt <Break> standardmäßig einen Zeilenumbruch.

Zeilenumbruch

Ein Zeilenumbruch setzt die Ausgabe innerhalb desselben Blocks in einer neuen Zeile fort.

<Block>

    <Content>

        <Text Content="Name: Max Mustermann">
        </Text>

        <Break BreakType="textWrapping">
        </Break>

        <Text Content="Versicherungsnummer: A123456789">
        </Text>

    </Content>

</Block>

Die Inhalte bleiben Bestandteil desselben Dokumentabschnitts, werden jedoch untereinander ausgegeben.

Da der Zeilenumbruch dem Standardverhalten entspricht, ist auch folgende Schreibweise möglich:

<Break>
</Break>

Für eine bessere Lesbarkeit des XML-Codes kann BreakType="textWrapping" dennoch ausdrücklich angegeben werden.

Seitenumbruch

Mit BreakType="page" wird die weitere Ausgabe auf einer neuen Seite fortgesetzt.

<Block>

    <Content>

        <Text Content="Dieser Inhalt steht auf der aktuellen Seite.">
        </Text>

        <Break BreakType="page">
        </Break>

        <Text Content="Dieser Inhalt beginnt auf einer neuen Seite.">
        </Text>

    </Content>

</Block>

Seitenumbrüche können auch innerhalb komplexerer Strukturen vorkommen. In vorhandenen Dokumentvorlagen werden sie beispielsweise innerhalb eines Blocks in einer Tabellenzelle eingesetzt. :contentReference[oaicite:0]{index=0}

Hinweis

Ein Seitenumbruch sollte gezielt eingesetzt werden.

Mehrere unmittelbar aufeinanderfolgende Seitenumbrüche können zusätzliche leere Seiten oder unerwartete Abstände erzeugen.

Spaltenumbruch

Mit BreakType="column" wird die Ausgabe in der nächsten Spalte fortgesetzt.

<Block>

    <Content>

        <Text Content="Inhalt der aktuellen Spalte">
        </Text>

        <Break BreakType="column">
        </Break>

        <Text Content="Inhalt der nächsten Spalte">
        </Text>

    </Content>

</Block>

Ein Spaltenumbruch ist insbesondere bei Dokumentbereichen sinnvoll, für die ein mehrspaltiges Layout eingerichtet wurde.

Besitzt der aktuelle Dokumentbereich keine entsprechende Spaltenkonfiguration, kann das Ergebnis vom erwarteten Layout abweichen.

Clear

Das Attribut Clear stellt folgende Werte bereit:

Clear ist insbesondere für Layoutsituationen vorgesehen, in denen Text mit seitlich oder frei positionierten Elementen zusammentrifft.

<Break
    BreakType="textWrapping"
    Clear="all">
</Break>

Hinweis

Die Elementkonfiguration nennt die verfügbaren Werte, beschreibt ihre genaue Wirkung innerhalb der Render-Engine jedoch nicht näher.

Verwenden Sie Clear deshalb nur, wenn das gewünschte Verhalten anhand einer Vorschau und eines erzeugten Testdokuments geprüft wurde.

Break und neuer Block

Ein Zeilenumbruch und ein neuer Block erfüllen unterschiedliche Aufgaben.

Als Faustregel gilt:

• Verwenden Sie <Break>, wenn der Inhalt logisch zum bestehenden Block gehört.
• Verwenden Sie einen neuen <Block>, wenn ein eigenständiger Dokumentabschnitt beginnt oder andere Blockeigenschaften benötigt werden.

Typische Einsatzgebiete

<Break> eignet sich beispielsweise für:

• mehrzeilige Anschriften,
• Kontaktinformationen untereinander,
• Zeilenwechsel innerhalb eines Informationsblocks,
• Beginn eines neuen Seitenabschnitts,
• Wechsel in die nächste Spalte,
• Umbrüche innerhalb von Tabellenzellen.

Best Practices

• Für einfache Zeilenwechsel <Break> anstelle leerer Texte verwenden.
• Seitenumbrüche nur gezielt einsetzen.
• Für neue Absätze mit eigenen Eigenschaften einen neuen <Block> verwenden.
• Spaltenumbrüche nur in entsprechend eingerichteten mehrspaltigen Bereichen verwenden.
• Die Schreibweise der von der IntelliSense angebotenen Werte übernehmen.
• Umbrüche immer anhand eines erzeugten Testdokuments prüfen.

Developer-Tipp

Verwenden Sie <Break> für einen Umbruch innerhalb eines zusammengehörenden Inhalts.

Beginnt dagegen ein neuer logisch oder gestalterisch eigenständiger Abschnitt, ist ein neuer <Block> meist die bessere Wahl.

XML-Wissen

<Break> ist kein Container und enthält keine weiteren XML-Elemente.

Das Element wirkt ausschließlich an seiner Position innerhalb des laufenden Inhalts.

Der nachfolgende Inhalt wird abhängig von BreakType

• in einer neuen Zeile,
• in der nächsten Spalte oder
• auf einer neuen Seite

fortgesetzt.

Typische Fehler

Leerzeichen oder leere Texte als Zeilenumbruch verwenden

Ein leerer Text erzeugt keinen eindeutig definierten Umbruch und erschwert die Lesbarkeit des XML-Codes.

Für einen gezielten Zeilenwechsel sollte <Break> verwendet werden.

Zeilenumbruch und neuen Block verwechseln

Ein <Break> beginnt keinen neuen eigenständigen Dokumentabschnitt.

Werden andere Absatz- oder Blockeigenschaften benötigt, sollte stattdessen ein neuer <Block> erstellt werden.

Seitenumbrüche mehrfach hintereinander verwenden

Mehrere unmittelbar aufeinanderfolgende Seitenumbrüche können unerwünschte leere Seiten erzeugen. In konvertierten Vorlagen kommen solche Folgen tatsächlich vor und sollten bei einer manuellen Überarbeitung kritisch geprüft werden. :contentReference[oaicite:1]{index=1}

Groß- und Kleinschreibung übernehmen

In älteren oder konvertierten XML-Dateien kann beispielsweise BreakType="Page" vorkommen. Die aktuelle Elementkonfiguration führt dagegen die Werte page, column und textWrapping.

Verwenden Sie bei neuen Implementierungen die von der IntelliSense angebotene Schreibweise.