Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

limit-characters

Limit characters with different criteria

truncate, characters, limit, break-word

readme

limit-characters

Limits the length of a given text with different options. Types included.

Install

npm

npm i limit-characters

Yarn

yarn add limit-characters

Usage

CommonJS

var limitCharacters = require("limit-characters")

ES6

import limitCharacters from "limit-characters"

Example

import limitCharacters from "limit-characters";

const originalText = "This library helps limit the characters of a given text"

const excerpt = limitCharacters({ text: originalText, length: 20 })
// Returns "This library help..."

const excerpt2 = limitCharacters({ text: originalText, length: 20, breakWord: false })
// Returns "This library..."

const excerpt3 = limitCharacters({ text: originalText, length: 32, breakWord: false, more: "... read more" })
// Returns "This library helps... read more"

Options

Option Type Required Default Description
text string Required | Original text to trim
length number Optional 144 Max length of characters including ellipsis
breakWord boolean Optional true Break the word or keep the whole word that fits the length
more string Optional ... Appended at the end of string if original text exceeded the length