@cielblog/react-horizontal-timeline
v1.0.2
Published
A horizontal timeline component made using react.
Downloads
194
Maintainers
Readme
React Horizontal Timeline
A React port of the horizontal time-line developed by sherubthakur and re-developed by twinkble
Here is a demo.
NOTE
The original package sherubthakur/react-horizontal-timeline is no longer maintained, and I re-developed the package and added additional features.
Support
I will appreciate your support to keep me going on maintaining & making packages like this one.
Install
$ yarn insall @cielblog/react-horizontal-timeline
// Or use npm
$ npm install @cielblog/react-horizontal-timeline
API
It will just render a timeline with the titles (can be dates or anything) that you provided, and it is up to you what to do when a title is selected. i.e. it will give you the index of the title that was clicked, and you can do anything with it.
| Property | Type | Required? | Default | Description |
|---------------------|------------|-----------|------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| titles
| string[]
| ✅ | undefined
| Stored array of titles. |
| index
| number
| ✅ | undefined
| The index of the selected title. |
| onTitleClick
| function
| ✅ | undefined
| Function that takes the index of array as argument. |
| renderTitles
| function
| | string
| Custom rendering title function. |
| maxEventPadding
| number
| | 20
| The minimum padding between two event titles. |
| maxEventPadding
| number
| | 120
| The maximum padding between two event titles. |
| linePadding
| number
| | 100
| Padding used at the start and end of the timeline, |
| titleWidth
| number
| | 85
| The width of an individual title. |
| fillingMotion
| object
| | { stiffness: 150, damping: 25 }
| Sets the animation style of how filling motion will look. |
| slidingMotion
| object
| | { stiffness: 150, damping: 25 }
| Sets the animation style of how sliding motion will look. |
| styles
| object
| | { background: '#f8f8f8', foreground: '#7b9d6f', outline: '#dfdfdf' }
| Object containing the styles for the timeline currently outline (the color of the boundaries of the timeline and the buttons on it's either side), foreground (the filling color, active color) and background (the background color of your page) colors of the timeline can be changed. |
| isRtl
| boolean
| | false
| Used to make the timeline support RTL languages. |
| isTouchEnabled
| boolean
| | true
| Enable touch events (swipe left, right). |
| isKeyboardEnabled
| boolean
| | true
| Enable keyboard events (up, down, left, right). |
| isOpenBeginning
| boolean
| | true
| Show the ending of the timeline as open ended. |
Usage
import React, {useState} from 'react'
import HorizontalTimeline from "@cielblog/react-horizontal-timeline";
const TITLES = [
'Title1',
'Title 2',
'Title 3',
];
export const MyTimeline = (props) => {
const [current, setCurrent] = useState(0)
return (
<div>
<HorizontalTimeline titles={TITLES} index={current} onTitleClick={(index) => setCurrent(index)}/>
</div>
)
}