npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

react-lms-vis-timeline

v3.0.1

Published

React component for the vis-timeline module

Downloads

239

Readme

React vis-timeline component

React component for the vis-timeline timeline module.

vis-timeline documentation

example chart

vis-timeline documentation

Installation

npm install --save react-lms-vis-timeline

OR

yarn add react-lms-vis-timeline

Getting Started

import Timeline from 'react-lms-vis-timeline'

// https://visjs.github.io/vis-timeline/docs/timeline/#Configuration_Options

const options = {
  width: '100%',
  height: '100px',
  // ...
  // ...
}

// JSX
<Timeline options={options} />

What are the differences from react-visjs-timeline ?

  • Written in Typescript

  • Using vis-timeline library! without the old vis.js

  • No unnecessary re-renders

    The old lib caused re-renders on each prop changed, and using immutable objects to detect changes. This was very problematic and caused performance issues. We don't want to re-render the whole timeline, just because 1 item added to the items array.

  • API changes (items, groups)

    vis-timeline already knows how to detect changes with vis-data's DataSet object. So in this library, we take it as an advantage and using these DataSets. While exposing them to the user within ref.

    You can also insert initial data with props, and update/add/remove later with ref API.

  • Expose the timeline's API.

    Methods like focus, fit, and many more native vis-timeline methods exposed as well in optional ref.

Supported Features

  • Configuration Options
  • Items
  • Groups
  • Custom Times
  • Events
  • Selection
  • Timeline's API

Items

Items follow the exact same for format as they do in `vis-timeline``. See the vis-timeline documentation for more information.

const items = [{
  start: new Date(2010, 7, 15),
  end: new Date(2010, 8, 2),  // end is optional
  content: 'Trajectory A',
}]

<Timeline
  options={options}
  initialItems={items}
/>

Groups

Groups follow the exact same for format as they do in vis-timeline. See the vis-timeline documentation for more information.

const groups = [{
  id: 1,
  content: 'Group A',
}]

<Timeline
  options={options}
  initialGroups={groups}
/>

Custom Times

CustomTimes defined more declaratively in the component, via the customTimes prop.

const customTimes = [
  {
    id: 'one',
    datetime: new Date()
  },
  {
    id: 'two',
    datetime: 'Tue May 10 2016 16:17:44 GMT+1000 (AEST)'
  }
]

When the customTimes prop changes, the updated times will be reflected in the timeline.

Events

All events are supported via prop function handlers. The prop name follows the convention <eventName>Handler and the specified function will receive the same arguments as the vis-timeline counterparts. Some vis-timeline event names are not camelcased (e.g. rangechange), so the corresponding React prop names need to follow that convention where necessary:

<Timeline
  options={options}
  clickHandler={clickHandler}
  rangechangeHandler={rangeChangeHandler}
/>

function clickHandler(props) {
  // handle click event
}

function rangeChangeHandler(props) {
  // handle range change
}

Animation

You can enable animation (when the options start/end values change) by passing a prop of animation to the component. The available options for this prop follow the same conventions as setWindow in vis-timeline. So you can either pass a boolean value (true by default) or an object specifying your animation configuration, e.g:

// animate prop...
{
  duration: 3000,
  easingFunction: 'easeInQuint'
}

Styling

Import your custom CSS after you import the component from the module, e.g:

import Timeline from 'react-lms-vis-timeline';
import './my-custom-css.css';