Package Exports
- wordwrapjs
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (wordwrapjs) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
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.
> 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.
> 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
- wordwrapjs
- WordWrap ⏏
- .wrap(text, [options]) ⇒
string - .lines(text, options)
- .isWrappable(text) ⇒
boolean - .getChunks(text) ⇒
Array.<string>
- .wrap(text, [options]) ⇒
- WordWrap ⏏
WordWrap ⏏
wordwrap.wrap(text, [options]) ⇒ string
Kind: static method of WordWrap
| Param | Type | Description |
|---|---|---|
| text | string |
the input text to wrap |
| [options] | object |
optional configuration |
| [options.width] | number |
the max column width in characters (defaults to 30). |
| [options.break] | boolean |
if true, words exceeding the specified width will be forcefully broken |
| [options.noTrim] | boolean |
By default, each line output is trimmed. If noTrim is set, no line-trimming occurs - all whitespace from the input text is left in. |
wordwrap.lines(text, options)
Wraps the input text, returning an array of strings (lines).
Kind: static method of WordWrap
| Param | Type | Description |
|---|---|---|
| text | string |
input text |
| options | object |
Accepts same options as constructor. |
wordwrap.isWrappable(text) ⇒ boolean
Returns true if the input text would be wrapped if passed into .wrap().
Kind: static method of WordWrap
| Param | Type | Description |
|---|---|---|
| text | string |
input text |
wordwrap.getChunks(text) ⇒ Array.<string>
Splits the input text into an array of words and whitespace.
Kind: static method of WordWrap
| Param | Type | Description |
|---|---|---|
| text | string |
input text |
© 2015-16 Lloyd Brookes <75pound@gmail.com>. Documented by jsdoc-to-markdown.