1.0.9 • Published 9 months ago

react-elegant-timeline v1.0.9

Weekly downloads
-
License
MIT
Repository
github
Last release
9 months ago

react-elegant-timeline

A React timeline component with elegant styles.

npm version License: MIT npm downloads Coverage Status

Demo

gif

or check it out at my personal website (click the "MY EXPE." button and start scrolling!)

Installation

# Install with npm
npm install react-elegant-timeline

or

# Install with yarn
yarn add react-elegant-timeline

Usage Example

import React from 'react';
import Timeline from 'react-elegant-timeline';
import "react-elegant-timeline/dist/styles.css";

const data = [
    {
      title: "Event 1",
      description: "Description of event 1",
      tagline: "Tagline 1",
      link: "https://example1.com",
      image: "image1.png",
    },
    {
      title: "Event 2",
      description: "Description of event 2",
      tagline: "Tagline 2",
      link: "https://example2.com",
      buttonText: "Custom button text for button 2",
    },
    {
      title: "Event 3",
      description: "Description of event 3",
      showButton: false,
    },
  ];

const App = () => {
  return <Timeline data={data} />;
};

export default App;

Props

data: Array of Objects

List of timeline items to render.

Each object in the data array should have the following properties:

PropTypeRequiredDefaultDescription
titlestring☑️NoneTitle of the timeline item
descriptionstring☑️NoneDescription text for the item
taglinestringNone(optional) Tagline of the item
linkstringNone(optional) URL to open when the button is clicked
imagestringNone(optional) URL of the image that you want to show
buttonTextstring"Click for more"(optional) Custom text for the button
showButtonbooleantrue(optional) Controls whether the button should show

onButtonClick: Function (optional)

A custom click handler function to be called when the button is clicked. If both onButtonClick and link are provided, onButtonClick is called first, and the link will open afterward. If no link is provided and onButtonClick is not defined, the button will do nothing.

•	Type: (data: TimelineItemData, index: number) => void
•	Default: undefined

Custom Styles

By default, the timeline is styled with timeline.css. You can override the styles by providing your own custom CSS.

.timeline__item {
  background-color: #f4f4f4; /* Custom styles to override the default timeline item background */
}

License

MIT © Andus Cheung

1.0.9

9 months ago

1.0.8

9 months ago

1.0.7

9 months ago

1.0.6

9 months ago

1.0.5

9 months ago

1.0.4

9 months ago

1.0.3

9 months ago

1.0.2

9 months ago

1.0.1

9 months ago

1.0.0

9 months ago