1.0.2 • Published 2 years ago

react-text-overflow v1.0.2

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

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.

npm downloads Node.js CI pages-build-deployment

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
1.0.2

2 years ago

1.0.1

2 years ago

1.0.0

2 years ago

0.0.1

2 years ago