Timelinr

Timelinr provides a Views display style and row plugin for building timelines in Drupal. It is a complete rewrite for Drupal 11.3+: the old jQuery Timelinr plugin has been replaced by timelinr-ts, a dependency-free
TypeScript custom element with CSS custom properties, five layout variants and full ARIA support.

Library homepage and live demos: https://steffenr.github.io/timelinr-ts/

Features

• A Views display style exposing every library option: variant, orientation, start index, arrow-key navigation, autoplay (direction and interval), theme, prev/next buttons, position counter
  and dot pagination.
• A Views row plugin that maps view fields to the timeline parts: date label, title, body, image and — optionally — a UI Icons field
  rendered as the date medallion glyph.
• Five layout variants: rail (horizontal year strip), stack (vertical date column), tabs (compact pills with dot pagination), list (windowed full-width entries) and list-alternating (entries
  alternating on a central rail).
• Five built-in themes (default, dark, ocean, forest, sunset) plus per-display CSS custom property overrides for colors, sizing, spacing and scroll offsets — validated on save, no raw CSS injection.
• Fully themeable: both templates ship with view-, display- and view+display-specific suggestions.

The timelinr library

timelinr-ts is a standalone custom element: zero dependencies, ESM, no jQuery, no Drupal behaviors. The module itself ships no JavaScript at all — it only renders markup and attaches the library.

Requirements

• Drupal 11.3+ (Drupal 12 ready)
• PHP 8.3+
• Views (core)
• The timelinr-ts library, installed separately

Installation

Install the library through asset-packagist:

composer require npm-asset/timelinr-ts:^1.2

It lands in web/libraries/timelinr-ts/dist/. Alternatively, download the dist/ folder manually into that path. Then enable the module:

drush en timelinr

See README.md in the module for the required installer-types / installer-paths settings, the full options reference and the JavaScript API.

Upgrading from 7.x

There is no upgrade path. The old jQuery plugin, the libraries module dependency and the 7.x settings are all gone; the view has to be reconfigured with the new style and row
plugin.

Similar modules

• views_timelinejs - a more complex solutions based on TimelineJS3 library