1.0.2 • Published 3 years ago

@cielblog/react-horizontal-timeline v1.0.2

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

image

React Horizontal Timeline

npm version Build Status Code Climate Dependency Status devDependency Status devDependency Status

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.

PropertyTypeRequired?DefaultDescription
titlesstring[]undefinedStored array of titles.
indexnumberundefinedThe index of the selected title.
onTitleClickfunctionundefinedFunction that takes the index of array as argument.
renderTitlesfunctionstringCustom rendering title function.
maxEventPaddingnumber20The minimum padding between two event titles.
maxEventPaddingnumber120The maximum padding between two event titles.
linePaddingnumber100Padding used at the start and end of the timeline,
titleWidthnumber85The width of an individual title.
fillingMotionobject{ stiffness: 150, damping: 25 }Sets the animation style of how filling motion will look.
slidingMotionobject{ stiffness: 150, damping: 25 }Sets the animation style of how sliding motion will look.
stylesobject{ 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.
isRtlbooleanfalseUsed to make the timeline support RTL languages.
isTouchEnabledbooleantrueEnable touch events (swipe left, right).
isKeyboardEnabledbooleantrueEnable keyboard events (up, down, left, right).
isOpenBeginningbooleantrueShow 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>
    )
}