📐 truncate html by text length
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
.travis.yml
README.md
index.js
license
package.json
test.js

README.md

trunc-html

Build Status

truncate html by text length

install

using npm.

npm install -S trunc-html

features

  • fast, lean, extensible
  • truncate by text length, not html length
  • truncate by complete words, not just by characters

trunc(html, limit, options?)

Returns the result of truncating the provided html. A plain-text version is provided as well.

var html = 'the force is <strong>with this one</strong>. some more rubbish';
trunc(html, 30);
// <-
//    { html: 'the force is <strong>with this one</strong>. …',
//      text: 'the force is with this one. …' }

limit

Maximum amount of text characters allowed. When the limit is reached, the algorithm will trace back to the last word separator and trim the rest into a glyph.

options.ignoreTags

If you'd like to supress certain HTML tags from being output you can provide an array of tags to be excluded, set ignoreTags to something like ['strong'].

options.imageAltText

If you'd like to use the alt attribute for the text portion of the result, instead of dropping images entirely in text flavor, set imageAltText to true.

options.sanitizer

Options passed to insane. Note that these options are overridden by the options provided by trunc-html, so you can't use transformText, which trunc-html reserves for itself.

related

license

MIT