61 lines
1.7 KiB
Handlebars
61 lines
1.7 KiB
Handlebars
|
[![view on npm](http://img.shields.io/npm/v/wordwrapjs.svg)](https://www.npmjs.org/package/wordwrapjs)
|
||
|
[![npm module downloads](http://img.shields.io/npm/dt/wordwrapjs.svg)](https://www.npmjs.org/package/wordwrapjs)
|
||
|
[![Build Status](https://travis-ci.org/75lb/wordwrapjs.svg?branch=master)](https://travis-ci.org/75lb/wordwrapjs)
|
||
|
[![Dependency Status](https://david-dm.org/75lb/wordwrapjs.svg)](https://david-dm.org/75lb/wordwrapjs)
|
||
|
[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg)](https://github.com/feross/standard)
|
||
|
|
||
|
# wordwrapjs
|
||
|
|
||
|
Word wrapping, with a few features.
|
||
|
|
||
|
- force-break option
|
||
|
- wraps hypenated words
|
||
|
- multilingual - wraps any language that uses whitespace for word separation.
|
||
|
|
||
|
## Synopsis
|
||
|
|
||
|
Wrap some text in a 20 character column.
|
||
|
|
||
|
```js
|
||
|
> wordwrap = require('wordwrapjs')
|
||
|
|
||
|
> text = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.'
|
||
|
|
||
|
> result = wordwrap.wrap(text, { width: 20 })
|
||
|
```
|
||
|
|
||
|
`result` now looks like this:
|
||
|
```
|
||
|
Lorem ipsum dolor
|
||
|
sit amet,
|
||
|
consectetur
|
||
|
adipiscing elit, sed
|
||
|
do eiusmod tempor
|
||
|
incididunt ut labore
|
||
|
et dolore magna
|
||
|
aliqua.
|
||
|
```
|
||
|
|
||
|
By default, long words will not break. Unless you set the `break` option.
|
||
|
```js
|
||
|
> url = 'https://github.com/75lb/wordwrapjs'
|
||
|
|
||
|
> wrap.lines(url, { width: 18 })
|
||
|
[ 'https://github.com/75lb/wordwrapjs' ]
|
||
|
|
||
|
> wrap.lines(url, { width: 18, break: true })
|
||
|
[ 'https://github.com', '/75lb/wordwrapjs' ]
|
||
|
```
|
||
|
|
||
|
## API Reference
|
||
|
|
||
|
{{#module name="wordwrapjs"}}
|
||
|
{{>body~}}
|
||
|
{{>member-index~}}
|
||
|
{{>members~}}
|
||
|
{{/module}}
|
||
|
|
||
|
* * *
|
||
|
|
||
|
© 2015-17 Lloyd Brookes \<75pound@gmail.com\>. Documented by [jsdoc-to-markdown](https://github.com/jsdoc2md/jsdoc-to-markdown).
|