page-break-before

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

警告:此屬性已被 break-before 屬性取代。

page-break-before CSS 屬性調整當前元素之前的分頁符。

此屬性適用於生成盒的塊級元素。它不適用於不生成盒的空 <div>

試一試

page-break-before: auto;
page-break-before: always;
<div>
  <p>
    The effect of this property can be noticed when the document is being
    printed or a preview of a print is displayed.
  </p>
  <button id="print-btn">Show Print Preview</button>
  <div class="box-container">
    <div class="box">Content before the property</div>
    <div class="box" id="example-element">Content with 'page-break-before'</div>
    <div class="box">Content after the property</div>
  </div>
</div>
.box {
  border: solid #5b6dcd 5px;
  background-color: #5b6dcd;
  margin: 10px 0;
  padding: 5px;
}

#example-element {
  border: solid 5px #ffc129;
  background-color: #ffc129;
  color: black;
}
const btn = document.getElementById("print-btn");

btn.addEventListener("click", () => {
  window.print();
});

語法

css
/* Keyword values */
page-break-before: auto;
page-break-before: always;
page-break-before: avoid;
page-break-before: left;
page-break-before: right;
page-break-before: recto;
page-break-before: verso;

/* Global values */
page-break-before: inherit;
page-break-before: initial;
page-break-before: revert;
page-break-before: revert-layer;
page-break-before: unset;

auto

初始值。自動分頁(不強制也不禁止)。

always

總是在元素之前強制分頁。

avoid

避免在元素之前分頁。

left

在元素之前強制分頁,以便下一頁格式化為左頁。它是在書脊左側的頁面,或雙面列印時的背面。

在元素之前強制分頁,以便下一頁格式化為右頁。它是在書脊右側的頁面,或雙面列印時的正面。

recto

如果頁面從左向右進行,則其作用類似於 right。如果頁面從右向左進行,則其作用類似於 left

verso

如果頁面從左向右進行,則其作用類似於 left。如果頁面從右向左進行,則其作用類似於 right

分頁別名

page-break-before 屬性現在是舊屬性,已被 break-before 取代。

出於相容性考慮,瀏覽器應將 page-break-before 視為 break-before 的別名。這確保了使用 page-break-before 的網站能夠按預期執行。部分值應按如下方式進行別名處理

page-break-before break-before
auto auto
left left
right right
avoid avoid
always page

正式定義

初始值auto
應用於根元素的正常流中的塊級元素。使用者代理還可以將其應用於其他元素,如 table-row 元素。
繼承性
計算值同指定值
動畫型別離散

正式語法

page-break-before = 
auto |
always |
avoid |
left |
right |
inherit

示例

避免在元素之前分頁

css
/* Avoid page break before div elements of class note */
div.note {
  page-break-before: avoid;
}

規範

規範
CSS 邏輯屬性和值第 1 級
# page
CSS Fragmentation Module Level 3
# 分頁屬性

瀏覽器相容性

另見