XuelesszzZ 94af2b8e7b 6-30-5 | 1 год назад | |
---|---|---|
.. | ||
dist | 1 год назад | |
CHANGELOG.md | 1 год назад | |
LICENSE | 1 год назад | |
README.md | 1 год назад | |
package.json | 1 год назад | |
rollup.config.ts | 1 год назад |
A JavaScript library for Line Breaking and identifying Word Boundaries, implementing the Unicode Line Breaking Algorithm (UAX #14)
Line breaking, also known as word wrapping, is the process of breaking a section of text into lines such that it will fit in the available width of a page, window or other display area. The Unicode Line Breaking Algorithm performs part of this process. Given an input text, it produces a set of positions called "break opportunities" that are appropriate points to begin a new line. The selection of actual line break positions from the set of break opportunities is not covered by the Unicode Line Breaking Algorithm, but is in the domain of higher level software with knowledge of the available width and the display size of the text.
In addition, the module implements CSS specific tailoring options to line breaking as defined in CSS Text Module Level 3.
You can install the module via npm:
npm install css-line-break
The LineBreaker
creates an iterator that returns Break
s for a given text.
LineBreaker(text, [options]);
import {LineBreaker} from 'css-line-break';
const breaker = LineBreaker('Lorem ipsum lol.', {
lineBreak: 'strict',
wordBreak: 'normal'
});
const words = [];
let bk;
while (!(bk = breaker.next()).done) {
words.push(bk.value.slice());
}
assert.deepEqual(words, ['Lorem ', 'ipsum ', 'lol.']);
The following parameters are available for the options:
lineBreak
: normal
| strict
wordBreak
: normal
| break-all
| break-word
| keep-all
For more information how they affect the line breaking algorithms, check out CSS Text Module Level 3.
You can run the test suite with:
npm test
The library implements all the LineBreakTest.txt tests and a number of CSS web-platform-tests.