break-before

CSS の break-after プロパティは、生成されたボックスの前で、ページ、段、領域をどのように区切るかを設定します。ボックスが生成されない場合は、このプロパティは無視されます。

/* 全般的な区切り値 */
break-before: auto;
break-before: avoid;

/* 改ページ値 */
break-before: avoid-page;
break-before: page;
break-before: always;
break-before: left;
break-before: right;
break-before: recto;
break-before: verso;

/* 段区切り値 */
break-before: avoid-column;
break-before: column;

/* 領域区切り値 */
break-before: avoid-region;
break-before: region;

/* グローバル値 */
break-before: inherit;
break-before: initial;
break-before: unset;

区切り位置になる可能性のある場所 (言い換えれば、要素の境界) は、三つのプロパティに影響されます。前の要素の break-after の値、次の要素の break-before の値、包含要素の break-inside の値です。

区切られるかどうかを判断するために、以下の規則が適用されます。

1. 考慮される三つの値の中の何れかに区切りを強制する値 (always, left, right, page, column, region の何れか) がある場合、それが優先されます。そのような区切りが複数ある場合は、フローの中で最も後に現れる要素のものが使用されます (つまり、 break-before の値は break-after の値より優先し、それは更に break-inside よりも優先します)。
2. 考慮される三つの値の中に区切りを防止する値 (avoid, avoid-page, avoid-region, avoid-column の何れか) が含まれていた場合は、その場所で区切りは適用されません。

強制的な区切りが適用されると、必要に応じてソフトな区切りが追加される場合がありますが、 avoid に関する値に解決される要素の境界には追加されません。

構文

break-before プロパティは、以下の一覧にあるキーワード値のうちの一つで指定します。

値

全般的な区切り値

auto

該当するボックスの直前に何らかの (ページ、段、領域の) 区切りを挿入することを許可しますが、強制はしません。

avoid

該当するボックスの直前に何らかの (ページ、段、領域の) 区切りを挿入することを禁止します。

改ページ値

avoid-page

該当するボックスの直前の改ページを禁止します。

page

該当するボックスの直前で改ページを行います。

always

該当するボックスの直前で改ページを行います。 (これは page の別名であり、このプロパティのサブセットであった page-break-after からの移行がしやすいように残されています。)

left

該当するボックスの直前で一つ又は二つの改ページを行い、次のページが左ページになるようにします。

right

該当するボックスの直前で一つ又は二つの改ページを行い、次のページが右ページになるようにします。

recto

該当するボックスの直前で一つ又は二つの改ページを行い、次のページが奇数ページになるようにします。 (奇数ページは左から右に開く場合は右ページになり、右から左に開く場合は左ページになります。)

verso

該当するボックスの直前で一つ又は二つの改ページを行い、次のページが偶数ページになるようにします。 (奇数ページは左から右に開く場合は左ページになり、右から左に開く場合は右ページになります。)

段区切り値

avoid-column

該当するボックスの直前の段区切りを禁止します。

column

該当するボックスの直前で段区切りを行います。

領域区切り値

avoid-region

該当するボックスの直前の領域区切りを禁止します。

region

該当するボックスの直前で領域区切りを行います。

形式文法

auto | avoid | avoid-page | page | left | right | recto | verso | avoid-column | column | avoid-region | region

仕様書

ブラウザーの対応