react-text-overflow
v1.0.2
Published
Controls when and how to overflow text
Downloads
3,376
Maintainers
Readme
React Text Overflow Component
See it in action
React Text Overflow is a React component that targets the ability to overflow a single line of text (with ellipses) from the left, or the center, or from an offset. Hoping one day this is entireably possible with CSS but we're not quite there yet.
Installation
React Text Overflow requires React 17 or later.
npm i -S react-text-overflow
Examples
Examples
Basic Usage
This is the most basic usecase, which honestly you should just use vanilla CSS for this piece. It will overflow text from the end.
import React from 'react';
import TextOverflow from 'react-text-overflow';
const MyComponent = () => (
<TextOverflow text="this is some text that we want to truncate." />
)
Overflow in the center
This will break the text in the center allowing the beginning and end to show.
const MyComponent = () => (
<TextOverflow truncatePosition="middle" text="this is some text that we want to truncate." />
)
Offsetting the overflow
This will break after the first 10 characters.
const MyComponent = () => (
<TextOverflow startPos={10} truncatePosition="middle" text="this is some text that we want to truncate." />
)
Overflowing from the start
This causes the text to overflow from the left of the element.
const MyComponent = () => (
<TextOverflow truncatePosition="start" text="this is some text that we want to truncate." />
)
Props
truncatePosition
Type: start | middle | end
Default: end
This is what determines where the text will overflow.
startPos
Type: Number
Default: 0
This is to be used in combination with truncatePosition
center
, this will break the text in that location.
Building TextOverflow
npm run build
Running examples
cd examples
npm run dev