1. css-line-break
css-line-break ==============
css-line-break
Package: css-line-break
Created by: niklasvh
Last modified: Tue, 14 Jun 2022 04:40:23 GMT
Version: 2.1.0
License: MIT
Downloads: 6,962,884
Repository: https://github.com/niklasvh/css-line-break

Install

npm install css-line-break
yarn add css-line-break

css-line-break

CI
NPM Downloads
NPM Version

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.

Installing

You can install the module via npm:

npm install css-line-break

Usage

The LineBreaker creates an iterator that returns Breaks for a given text.

LineBreaker(text, [options]);

Example

JSFiddle

 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.

Testing

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.

Dependencies

RELATED POST

10 Must-Know Windows Shortcuts That Will Save You Time

10 Must-Know Windows Shortcuts That Will Save You Time

Arrays vs Linked Lists: Which is Better for Memory Management in Data Structures?

Arrays vs Linked Lists: Which is Better for Memory Management in Data Structures?

Navigating AWS Networking: Essential Hacks for Smooth Operation

Navigating AWS Networking: Essential Hacks for Smooth Operation

Achieving Stunning Visuals with Unity's Global Illumination

Achieving Stunning Visuals with Unity's Global Illumination

Nim's Hidden Gems: Lesser-known Features for Writing Efficient Code

Nim's Hidden Gems: Lesser-known Features for Writing Efficient Code