react-event-timeline

A react component to generate a responsive event-timeline

See the storybook demo here: https://rcdexta.github.io/react-event-timeline

Features

• It's lightweight
• Responsive and extensible

Getting started

npm install --save react-event-timeline

or if you are using yarn

yarn add react-event-timeline

Usage

The following snippet generates the timeline you see in the demo:

import {Timeline, TimelineEvent} from '../components/index'

ReactDOM.render(
    <Timeline>
            <TimelineEvent title="John Doe sent a SMS"
                           createdAt="2016-09-12 10:06 PM"
                           icon={<i className="material-icons md-18">textsms</i>}
            >
                I received the payment for $543. Should be shipping the item within a couple of hours.
            </TimelineEvent>
            <TimelineEvent
                title="You sent an email to John Doe"
                createdAt="2016-09-11 09:06 AM"
                icon={<i className="material-icons md-18">email</i>}
            >
                Like we talked, you said that you would share the shipment details? This is an urgent order and so I
                    am losing patience. Can you expedite the process and pls do share the details asap. Consider this a
                    gentle reminder if you are on track already!
            </TimelineEvent>
    </Timeline>,
      document.getElementById('container')
);

Please refer to story description to check out code for all the examples in the storybook

API Documentation

Timeline

This is the wrapper component that creates the infinite vertical timeline

Name	Type	Description
className	string	The css class name of the root timeline element
style	object	Override the inline styles of the timeline element

TimelineEvent

Each event in the timeline will be represented by the TimelineEvent component. There can be multiple repeating instances of this component inside Timeline wrapper

Name	Type	Description
title	node	The title of the event. Can be string or any DOM element node(s)
createdAt	node	The time at which the event occurred. Can be datetime string or any DOM element node(s)
icon	node	The icon to show as event lable. Can be a SVG or font icon
iconColor	string	CSS color code for icon
iconStyle	object	Custom CSS for the icon
buttons	node	Action buttons to display to the right of the event content
contentStyle	node	Override content style
container	string	Optional value card will render event as a Card
style	object	Override style for the entire event container. Can be used to modify card appearance if container is selected as card
cardHeaderStyle	object	Override style for the card header if container is card

TimelineBlip

Use this component if your event is too small and can be described in a single line

Name	Type	Description
title	node	The title of the event. Can be string or any DOM element node(s)
icon	node	The icon to show as event lable. Can be a SVG or font icon
iconColor	string	CSS color code for icon
iconStyle	object	Custom CSS for the icon
style	object	Override style for the entire event container

Refere to Condensed Timeline in Storybook for examples of using this component

Development

This project recommends using react-storybook as a UI component development environment. Use the following scripts for your development workflow:

1. yarn storybook: Start developing by using storybook
2. yarn lint : Lint all js files
3. yarn lintfix : fix linting errors of all js files
4. yarn build: transpile all ES6 component files into ES5(commonjs) and put it in dist directory
5. yarn docs: create static build of storybook in docs directory that can be used for github pages

The storybook artefacts can be found in stories folder. Run npm run storybook and you should see your code changes live reloaded on the browser

Also use semantic-release to automate release to npm. Use npm run commit to commit your changes and then npm run semantic-release to automate deployment and publishing to npm repository.

License

MIT