w:br (Break)
Inserts a line break, page break, or column break at the current position within a run.
Parent elements
Description
w:br inserts a break character into a run. It is defined in ECMA-376 Part 1 §17.3.3.1.
Three break types are supported: a line break within the paragraph (soft return), a column break, and a page break. A text-wrapping break can additionally specify how text resumes after a floating object.
Attributes
| Attribute | Type | Possible Values | Description |
|---|---|---|---|
w:type |
ST_BrType |
textWrapping (default — soft line break within paragraph), page (page break), column (column break) |
The kind of break inserted. |
w:clear |
ST_BrClear |
none (default), left, right, all |
For textWrapping breaks only: specifies which side of a floating object the text must clear before resuming. |
Examples
Soft line break (Shift+Enter)
<w:r>
<w:br/>
</w:r>new Run(new Break());Page break
<w:r>
<w:br w:type="page"/>
</w:r>new Run(new Break { Type = BreakValues.Page });Notes
- A page break via
w:br w:type="page"is semantically different fromw:pageBreakBefore: the break is at the end of the preceding run, whilew:pageBreakBeforeis a property of the target paragraph. - For conditional section breaks (e.g. odd-page), use a new section (
w:sectPr) rather thanw:br.