| 1 | # postcss-page-break
|
|---|
| 2 |
|
|---|
| 3 | [![NPM Package][npm-img]][npm]
|
|---|
| 4 | [![Build Status][ci-img]][ci]
|
|---|
| 5 | [![License: MIT][mit-img]][mit]
|
|---|
| 6 |
|
|---|
| 7 | [PostCSS] plugin to fallback `break-` properties with `page-break-` alias.
|
|---|
| 8 |
|
|---|
| 9 | [](https://caniuse.com/#feat=multicolumn)
|
|---|
| 10 |
|
|---|
| 11 | [PostCSS]: https://github.com/postcss/postcss
|
|---|
| 12 | [npm-img]: https://img.shields.io/npm/v/postcss-page-break.svg
|
|---|
| 13 | [npm]: https://www.npmjs.org/package/postcss-page-break
|
|---|
| 14 | [ci-img]: https://travis-ci.org/shrpne/postcss-page-break.svg
|
|---|
| 15 | [ci]: https://travis-ci.org/shrpne/postcss-page-break
|
|---|
| 16 | [mit-img]: https://img.shields.io/badge/License-MIT-yellow.svg
|
|---|
| 17 | [mit]: https://github.com/shrpne/postcss-page-break/blob/master/LICENSE
|
|---|
| 18 |
|
|---|
| 19 | ```css
|
|---|
| 20 | /* before */
|
|---|
| 21 | .foo {
|
|---|
| 22 | break-inside: avoid;
|
|---|
| 23 | break-after: page;
|
|---|
| 24 | }
|
|---|
| 25 |
|
|---|
| 26 | /* after */
|
|---|
| 27 | .foo {
|
|---|
| 28 | page-break-inside: avoid;
|
|---|
| 29 | break-inside: avoid;
|
|---|
| 30 | page-break-after: always;
|
|---|
| 31 | break-after: page;
|
|---|
| 32 | }
|
|---|
| 33 | ```
|
|---|
| 34 |
|
|---|
| 35 | Available fallbacks:
|
|---|
| 36 | ```
|
|---|
| 37 | break-inside: auto => page-break-inside: auto
|
|---|
| 38 | break-inside: avoid => page-break-inside: avoid
|
|---|
| 39 | break-inside: avoid-page => page-break-inside: avoid
|
|---|
| 40 | break-inside: inherit => page-break-inside: inherit
|
|---|
| 41 | break-inside: initial => page-break-inside: initial
|
|---|
| 42 | break-inside: unset => page-break-inside: unset
|
|---|
| 43 |
|
|---|
| 44 | break-before: auto => page-break-before: auto;
|
|---|
| 45 | break-before: avoid => page-break-before: avoid;
|
|---|
| 46 | break-before: avoid-page => page-break-before: avoid;
|
|---|
| 47 | break-before: page => page-break-before: always;
|
|---|
| 48 | break-before: always => page-break-before: always;
|
|---|
| 49 | break-before: left => page-break-before: left;
|
|---|
| 50 | break-before: right => page-break-before: right;
|
|---|
| 51 | break-before: recto => page-break-before: recto;
|
|---|
| 52 | break-before: verso => page-break-before: verso;
|
|---|
| 53 | break-before: inherit => page-break-before: inherit;
|
|---|
| 54 | break-before: initial => page-break-before: initial;
|
|---|
| 55 | break-before: unset => page-break-before: unset;
|
|---|
| 56 |
|
|---|
| 57 | break-after: auto => page-break-after: auto;
|
|---|
| 58 | break-after: avoid => page-break-after: avoid;
|
|---|
| 59 | break-after: avoid-page => page-break-after: avoid;
|
|---|
| 60 | break-after: page => page-break-after: always;
|
|---|
| 61 | break-after: always => page-break-after: always;
|
|---|
| 62 | break-after: left => page-break-after: left;
|
|---|
| 63 | break-after: right => page-break-after: right;
|
|---|
| 64 | break-after: recto => page-break-after: recto;
|
|---|
| 65 | break-after: verso => page-break-after: verso;
|
|---|
| 66 | break-after: inherit => page-break-after: inherit;
|
|---|
| 67 | break-after: initial => page-break-after: initial;
|
|---|
| 68 | break-after: unset => page-break-after: unset;
|
|---|
| 69 | ```
|
|---|
| 70 |
|
|---|
| 71 | ## Installation
|
|---|
| 72 | ```bash
|
|---|
| 73 | npm install --save-dev postcss postcss-page-break
|
|---|
| 74 | ```
|
|---|
| 75 |
|
|---|
| 76 |
|
|---|
| 77 | ## Usage
|
|---|
| 78 |
|
|---|
| 79 | ```js
|
|---|
| 80 | postcss([ require('postcss-page-break') ])
|
|---|
| 81 | ```
|
|---|
| 82 |
|
|---|
| 83 | See [PostCSS] docs for examples for your environment (webpack, gulp, grunt).
|
|---|
