How to prevent a block of text from splitting at page boundary

[ThinkTRG]

I have some blocks of text wherein every line should be on the same page, without a page break splitting the block.

Here's an example:

Hdr1 Hdr2 Hdr3.....
This That The other
More Like The first
Just Keep Together!

What I don't want to happen is for a page break to split this block and force some of the lines onto a different page:

Hdr1 Hdr2 Hdr3.....
This That The other
------------------- (page break)
More Like The first
Just Keep Together!

Sometimes this is called "widow/orphan control".

Is this something I can do with docx.js?

I searched a bit and found [this page](https://github.com/dolanmiu/docx/discussions/1832) but I don't think that's exactly what I'm looking for.

-- 
John Treankler

[ThinkTRG]

The documentation for paragraphs references "Page Break Control" and .keepLines() and .keepNext(). There's a link to an article on the help page, but the page at that link doesn't speak to widow/orphan control and I find no examples of how to code keepLines() or keepNext() in docx.js.

[ThinkTRG]

There's "Widow Control" in the doc which sounds exactly like what I want but I've hit the paragraph with both widowControl: false, and widowControl: true, with no effect.

[ThinkTRG]

Libre Office Writer app gives me what I want if I select the paragraph, then go to Format > Paragraph > Text Flow (tab) > ✅ Do not split paragraph.

[ThinkTRG]

So maybe what I'm asking is, how to set the 'do not split' attribute of a paragraph in docx.js?

[dolanmiu]

Can you try something like this:

const paragraph = new Paragraph({
    text: "Stay on the same page",
    keepLines: true,
    keepNext: true,
});

[ThinkTRG]

Thank you for that very quick response, @dolanmiu! I was certain I tried that combination earlier, but when I tried it just now, it seems to be working perfectly. I'll do some more testing and report my results back here.

[ThinkTRG]

Only the keepLines attribute of a Paragraph is needed to accomplish my goal. Here's how keepLines (left) and keepNext (right) in LibreOffice > Format > Paragrah > Text Flow:

So keepLines implements Do not split paragraph which is exactly what I want. 😁😎👏🏼

[dolanmiu]

Good to know it worked! I will update the documentation later. Currently blocked by DefinitelyTyped/DefinitelyTyped#64806

Documentation build is failing