0.2.0 • Published 6 years ago

react-vertical-timeline v0.2.0

Weekly downloads
45
License
MIT
Repository
github
Last release
6 years ago

build status Dependency Status

react-vertical-timeline - Vertical progress bar with bookmarks support

Basic Usage

Include the following package in your package.json : npm install --save react-vertical-timeline'.

Import the UI components into your App:

import { Timeline, Bookmark } from 'react-vertical-timeline';

...

See demo section

Development

Clone the repo : git clone https://github.com/yeyus/react-vertical-timeline.

To get started with fresh history, do this:

  1. cd react-vertical-timeline
  2. npm install - Install all dependencies
  3. npm start - Start demo site

Common Tasks

  • Developing - npm start - Runs the development server at localhost:8080 and use Hot Module Replacement. You can override the default host and port through env (HOST, PORT).
  • Creating a version - npm version <x.y.z>.
  • Publishing a version - npm publish - Pushes a new version to npm and updates the project site.

Testing

The test setup is based on Jest. Code coverage report is generated to coverage/. The coverage information is also uploaded to codecov.io after a successful Travis build.

  • Running tests once - npm test
  • Running tests continuously - npm run test:watch
  • Running individual tests - npm test -- - Works with test:watch too.
  • Linting - npm run test:lint - Runs ESLint.

Documentation Site

The boilerplate includes a GitHub Pages specific portion for setting up a documentation site for the component. The main commands handle with the details for you. Sometimes you might want to generate and deploy it by hand, or just investigate the generated bundle.

  • Building - npm run gh-pages - Builds the documentation into ./gh-pages directory.
  • Deploying - npm run deploy-gh-pages - Deploys the contents of ./gh-pages to the gh-pages branch. GitHub will pick this up automatically. Your site will be available through *.github.io/`.
  • Generating stats - npm run stats - Generates stats that can be passed to webpack analyse tool. This is useful for investigating what the build consists of.

Demo

state: { progress: 50 }
---
<Timeline height={300} progress={ state.progress } onSelect={p => setState({ progress: p })}>
  <Bookmark progress={20} onSelect={p => setState({ progress: p})}>
    Hi there 20%
  </Bookmark>
  <Marker progress={33}/>
  <Bookmark progress={55} onSelect={p => setState({ progress: p})}>
    Hi there 55%
  </Bookmark>
  <Bookmark progress={75} onSelect={p => setState({ progress: p})}>
    Hi there 75%
  </Bookmark>
</Timeline>

License

react-vertical-timeline is available under MIT. See LICENSE for more details. Based on react-component-boilerplate