# css-line-break

> css-line-break ==============

Latest version **2.1.0** (published 2022-01-22) · MIT license · 0 weekly downloads

## Install

```sh
npm install css-line-break
pnpm add css-line-break
yarn add css-line-break
bun add css-line-break
```

## Health

**Score 30/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.1.0 |
| Published | 2022-01-22 |
| First published | 2017-12-30 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 540 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 129 |
| Author | Niklas von Hertzen |
| Maintainers | niklasvh |
| Keywords | white-space, line-break, word-break, word-wrap, overflow-wrap |

## Links

- npm: https://www.npmjs.com/package/css-line-break
- Repository: https://github.com/niklasvh/css-line-break
- Homepage: https://github.com/niklasvh/css-line-break#readme
- Issues: https://github.com/niklasvh/css-line-break/issues
- npm.io page: https://npm.io/package/css-line-break

## Dependencies (1)

- [utrie](https://npm.io/package/utrie.md) ^1.0.2

## Recent versions

- 2.1.0 (latest) — 2022-01-22
- 2.0.1 — 2021-08-04
- 2.0.0 — 2021-08-02
- 1.1.3-0 — 2021-07-15
- 1.1.2-0 — 2021-07-04
- 1.1.1 — 2019-04-28
- 1.1.0 — 2019-04-28
- 1.0.1 — 2017-12-30
- 1.0.0 — 2017-12-30

## README

css-line-break
==============

![CI](https://github.com/niklasvh/css-line-break/workflows/CI/badge.svg?branch=master)
[![NPM Downloads](https://img.shields.io/npm/dm/css-line-break.svg)](https://www.npmjs.org/package/css-line-break)
[![NPM Version](https://img.shields.io/npm/v/css-line-break.svg)](https://www.npmjs.org/package/css-line-break)

A JavaScript library for Line Breaking and identifying Word Boundaries, 
[implementing the Unicode Line Breaking Algorithm (UAX #14)](http://unicode.org/reports/tr14/)  

>> 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](https://www.w3.org/TR/css-text-3/#line-breaking).

### Installing
You can install the module via npm:

    npm install css-line-break
  
### Usage
The `LineBreaker` creates an [iterator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Iterators_and_Generators) that returns `Break`s for a given text.

    LineBreaker(text, [options]);
    
### Example
[JSFiddle](https://jsfiddle.net/ofd3752k)
```javascript
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.']);
```    
### Options
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](https://www.w3.org/TR/css-text-3/#line-breaking).

### Testing
You can run the test suite with:

    npm test

The library implements all the [LineBreakTest.txt tests](http://www.unicode.org/Public/10.0.0/ucd/auxiliary/LineBreakTest.txt) 
 and a number of CSS web-platform-tests.

---
_Source: https://npm.io/package/css-line-break · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._