lost-civilizations-timeline
A JavaScript library for visualizing timelines of lost civilizations using vis-timeline
and d3
. This library allows you to easily create interactive timelines to explore events from civilizations long gone.
Installation
To use lost-civilizations-timeline
in your project, run:
npm install lost-civilizations-timeline
Ensure you have vis-timeline
, d3
, and moment
installed as they are peer dependencies:
npm install vis-timeline d3 moment
Usage
First, import LostCivilizationsTimeline
into your project:
import LostCivilizationsTimeline from 'lost-civilizations-timeline';
Then, initialize the timeline by providing a container ID and an array of events:
const events = [
{
id: 1,
name: 'The Rise of Atlantis',
startDate: '2020-01-01',
endDate: '2020-12-31'
},
];
new LostCivilizationsTimeline('timeline-container', events);
Ensure you have a div with the id timeline-container
in your HTML:
<div id="timeline-container"></div>
API
Constructor
LostCivilizationsTimeline(containerId, events)
containerId
: String. The ID of the DOM element where the timeline will be rendered.events
: Array. An array of event objects to be displayed on the timeline. Each event object should have the following properties:
id
: Unique identifier for the event.name
: The name or title of the event.startDate
: The start date of the event in YYYY-MM-DD format.endDate
: (Optional) The end date of the event in YYYY-MM-DD format. If not provided, the event will be displayed as a point.
Event Object Properties
id
: Number or String. A unique identifier for the event.name
: String. The name or description of the event.startDate
: String. The start date of the event in 'YYYY-MM-DD' format.endDate
: String (optional). The end date of the event in 'YYYY-MM-DD' format. If not provided, the event is considered as a single point in time.
Contributing
We welcome contributions to lost-civilizations-timeline
! Please open an issue or submit a pull request if you have a feature request, bug fix, or improvement.
License
This project is licensed under the MIT License - see the LICENSE file for details.