alignment | Alignment | Effective alignment, the one Word paints: direct w:jc, else the style chain’s, else the docDefaults’, else Left. Unknown only for a jc value with no OfficeJS name; null on write removes the direct w:jc. |
borders | BorderUniversalCollection | read-only office.js Paragraph.borders: Top, Left, Bottom, Right, Between, in that order. |
contentControls | ContentControlCollection | read-only |
dropCap | DropCap | read-only VBA Paragraph.DropCap as a Word.DropCap: the framed initial that starts this paragraph. |
endnotes | HandleCollection<NoteItem> | read-only office.js Paragraph.endnotes: the endnotes whose reference mark sits in this paragraph. |
equations | HandleCollection<Equation> | read-only Extension: the equations in this paragraph, read and rewritten as TeX. |
fields | FieldCollection | read-only Fields whose begin anchor sits in this paragraph, in document order. |
firstLineIndent | number | First-line indent in points: positive is a first-line indent, negative a hanging indent (the OfficeJS convention). Reads direct w:ind, falling back to the paragraph style’s chain, else 0; null clears the direct one. |
font | Font | read-only Run formatting over the paragraph’s whole text; write is a no-op when empty. |
footnotes | HandleCollection<NoteItem> | read-only office.js Paragraph.footnotes: the footnotes whose reference mark sits in this paragraph. |
frame | ParagraphFrame | undefined | The paragraph’s direct text frame or drop cap (w:framePr; extension, VBA’s Frame and DropCap), undefined when it has none. Setting replaces the frame; null removes it. |
hasPageBreak | boolean | read-only Readback for insertBreak(“Page”): true when any run carries an explicit page break (w:br w:type="page"). Page breaks NEVER show in text, and no other property accounts for them — a paragraph whose every readable property is clean can still end the page here. Check this before reasoning about why content refuses to share a page. |
inlinePictures | HandleCollection<InlinePicture> | read-only |
isBlank | boolean | read-only True when the paragraph carries neither text nor inline ink. |
isLastParagraph | boolean | read-only Whether this is the final paragraph in its parent body or table cell. |
isListItem | boolean | read-only True when the paragraph belongs to a list — its rendered marker is not in text. |
keepTogether | boolean | Keep all lines of this paragraph on one page (w:keepLines; extension, VBA’s KeepTogether): direct, else the style chain, else false. |
keepWithNext | boolean | Keep this paragraph on the same page as the next one (w:keepNext; extension, VBA’s KeepWithNext; Office.js has it on Style only): direct, else the style chain, else false. null clears the direct value. |
leftIndent | number | Left indent in points: direct w:ind, falling back to the paragraph style’s chain, so a visibly indented paragraph reads its real value. 0 when neither declares one. Writes are direct; null removes the direct one. |
lineSpacing | number | Effective line spacing as Word’s API counts it: direct, else the style chain and docDefaults, else 12 (single). Under the Multiple rule (the default) 12 is one line of the paragraph’s font, so 84 lays seven lines, not 84 points; for a fixed pitch use setLineSpacing({ rule: “Exactly”, points }). Writing null removes the direct value. |
lineSpacingRule | LineSpacingRule | read-only How lineSpacing reads: Multiple (Word’s auto), Exactly or AtLeast; effective through the style chain. |
lineUnitAfter | number | undefined | Direct spacing after this paragraph, measured in document-grid lines. |
lineUnitBefore | number | undefined | Direct spacing before this paragraph, measured in document-grid lines. |
list | List | read-only Gets the list to which this paragraph belongs. |
listItem | ListItem | read-only Gets this paragraph’s list item, matching OfficeJS’s throwing property. |
listItemOrNullObject | ListItem & { isNullObject: boolean } | read-only This paragraph’s list item, or an OfficeJS null object when it is plain text. |
listOrNullObject | List & { isNullObject: boolean } | read-only This paragraph’s list, or an OfficeJS null object when it is plain text. |
noSpaceBetweenParagraphsOfSameStyle | boolean | Word’s “Don’t add space between paragraphs of the same style” on this paragraph (w:contextualSpacing; extension, Office.js has it on Style only): direct, else the style chain, else false. null clears the direct value. |
outlineLevel | number | Effective Word outline level (1..9 are headings, 10 is body text): the direct w:outlineLvl, else the style chain’s, else the heading style’s own level. |
pageBreakBefore | boolean | Start this paragraph on a fresh page (w:pPr/w:pageBreakBefore). The read reports the DIRECT property only: a style’s page break does not show here, though the renderer honours it. Writing false removes the element. This property is NOT the only way a paragraph pins to a page: a run-level w:br w:type="page" never shows in text — read hasPageBreak. |
parentBody | Body | read-only Closest body scope: the containing cell body, or the main document body. |
parentContentControl | ContentControl | read-only |
parentContentControlOrNullObject | ContentControl | read-only |
parentSection | Section | read-only The section whose page setup lays this paragraph — an extension for multi-section documents (Body.parentSection reports the terminal section only). The paragraph’s own w:sectPr when its mark carries a section break, else the first break at or after its top-level block, else the final body-level section. Header, footer, and note paragraphs belong to no body section: this throws ItemNotFound. |
parentSectionOrNullObject | Section & { isNullObject: boolean } | read-only |
parentTable | Table | read-only Nearest containing table; throws ItemNotFound for a body paragraph. |
parentTableCell | TableCell | read-only Nearest containing table cell; throws ItemNotFound for a body paragraph. |
parentTableCellOrNullObject | TableCell & { isNullObject: boolean } | read-only |
parentTableOrNullObject | Table & { isNullObject: boolean } | read-only |
rightIndent | number | Right indent in points; reads like leftIndent, and null clears like it too. |
rightToLeft | boolean | Effective paragraph direction, the one Word paints: direct w:bidi, else the style chain’s (docDefaults included), else false (left-to-right). Writing either boolean emits an explicit direct property, so false turns an RTL-styled paragraph LTR; null clears it so the style shows through. |
shading | ParagraphShadingUniversal | read-only office.js Paragraph.shading: this paragraph’s w:pPr/w:shd, read effective. |
shapes | HandleCollection<Shape> | read-only Floating textboxes and pictures anchored to this paragraph. |
spaceAfter | number | Effective space after the paragraph, in points: direct, else the style chain, else Word’s 0. Writing null removes the direct w:spacing value. |
spaceBefore | number | Effective space before the paragraph, in points: direct, else the style chain, else Word’s 0. Writing null removes the direct w:spacing value. |
style | string | undefined | The paragraph’s style name (“Heading 1”): its direct w:pStyle, or the document default paragraph style (usually “Normal”) like OfficeJS. Accepts a style name, style ID, or OfficeJS BuiltInStyleName spelling on write; a Word built-in the document never defined is injected with its factory definition, like Word’s own lazy built-ins. |
styleBuiltIn | string | undefined | OfficeJS spelling: reads the Word built-in name (“Heading1” even when the document’s ID is localized, e.g. “Nadpis1”), falling back to the raw style ID for custom styles; writes like style. |
tableNestingLevel | number | read-only Number of containing tables; body paragraphs are level zero. |
tabStops | TabStop[] | Extension: the paragraph’s own tab stops (w:pPr/w:tabs), positions in points and sorted. Reads only DIRECT stops — a style’s are Style.paragraphFormat.tabStops. Writing REPLACES the set; an empty array or null removes it. |
text | string | read-only |
uniqueLocalId | string | read-only A GUID built from the paragraph’s w14:paraId: the same after a save, a reload or a Word round trip (an extension; Word’s changes on each launch). Find it with getParagraphByUniqueLocalId. |
widowControl | boolean | Widow and orphan control (w:widowControl; extension, VBA’s WidowControl): direct, else the style chain, else false. |