Skip to content

A react hook to truncate sentences, build in Typescript, supporting CJS and ESM.

License

Notifications You must be signed in to change notification settings

IzioDev/use-truncate

Repository files navigation

npm version

use-truncate

use-truncate is a lightweight (no dependencies) and straightforward truncate function. It's inspired by cli-truncate. The main reason use-truncate exists is that I could not find any other way to truncate a string easily in react. The other reason is that I wanted a package that supports both ESM and CJS.

Installation

  • Npm : npm i use-truncate
  • Yarn : yarn add use-truncate
  • Pnpm : pnpm add use-truncate

Usage

The most common use case is to truncate a string to a certain length :

const truncatedValue = useTruncate("This string is too long I guess", {
  maxLength: 10,
});

Options

  • maxLength: The maximum length of the string.
  • ellipsis: The string to use as ellipsis.

ESM or CJS

  • ESM : /dist/esm/index.js
  • CJS : /dist/cjs/index.js

Contributions

Feel free to open an issue or create a pull request to add your needed features.

Peer Depedenencies

  • react: "^16.8.0 || ^17.0.0 || ^18.0.0"
  • react-dom: "^16.8.0 || ^17.0.0 || ^18.0.0"

Tests

Tests can be run using Jest. There is a test script inside the package.json, feel free to use your favorite package manager to run it (npm run test, yarn test, pnpm test).

About

A react hook to truncate sentences, build in Typescript, supporting CJS and ESM.

Resources

License

Stars

Watchers

Forks

Packages

No packages published