jQuery Timelinr

Dando vida al tiempo / Giving life to time

Selecciona tu idioma / Select your language:⌗

English
Español

EN

This simple plugin helps you to give more life to the boring timelines. Supports horizontal and vertical layouts, and you can specify parameters for most attributes: speed, transparency, etc.

Last stable version: 0.9.6

Configuration:

Include the jQuery library and this plugin:

<script src="js/jquery-1.x.x.min.js"></script>
<script src="js/jquery.timelinr-0.9.x.js"></script>

Inicialize-it with the default parameters:

$(function(){
   $().timelinr();
});

Or configure it as preferred:

$(function(){
   $().timelinr({<br />
      orientation: 'horizontal',
      <span class="commentjs">// value: horizontal | vertical, default to horizontal</span><br />
      containerDiv: '#timeline',
      <span class="commentjs">// value: any HTML tag or #id, default to #timeline</span><br />
      datesDiv: '#dates',
      <span class="commentjs">// value: any HTML tag or #id, default to #dates</span><br />
      datesSelectedClass: 'selected',
      <span class="commentjs">// value: any class, default to selected</span>
      datesSpeed: 'normal',
      <span class="commentjs">// value: integer between 100 and 1000 (recommended) or 'slow', 'normal' or 'fast'; default to normal</span>
      issuesDiv : '#issues',
      <span class="commentjs">// value: any HTML tag or #id, default to #issues</span>
      issuesSelectedClass: 'selected',
      <span class="commentjs">// value: any class, default to selected</span>
      issuesSpeed: 'fast',
      <span class="commentjs">// value: integer between 100 and 1000 (recommended) or 'slow', 'normal' or 'fast'; default to fast</span>
      issuesTransparency: 0.2,
      <span class="commentjs">// value: integer between 0 and 1 (recommended), default to 0.2</span>
      issuesTransparencySpeed: 500,
      <span class="commentjs">// value: integer between 100 and 1000 (recommended), default to 500 (normal)</span>
      prevButton: '#prev',
      <span class="commentjs">// value: any HTML tag or #id, default to #prev</span>
      nextButton: '#next',
      <span class="commentjs">// value: any HTML tag or #id, default to #next</span><br />
      arrowKeys: 'false',
      <span class="commentjs">// value: true/false, default to false</span>
      startAt: 1,
      <span class="commentjs">// value: integer, default to 1 (first)</span>
      autoPlay: 'false',
      <span class="commentjs">// value: true | false, default to false</span>
      autoPlayDirection: 'forward',
      <span class="commentjs">// value: forward | backward, default to forward</span>
      autoPlayPause: 2000
      <span class="commentjs">// value: integer (1000 = 1 seg), default to 2000 (2segs)</span>< });
   });</code>

HTML markup must be as follows:

<div id="timeline">
   <ul id="dates">
      <li><a href="#">date1</a></li>
      <li><a href="#">date2</a></li>
   </ul>
   <ul id="issues">
      <li id="date1">
         <p>Lorem ipsum.</p>
      </li>
      <li id="date2">
         <p>Lorem ipsum.</p>
      </li>
   </ul>
   <a href="#" id="next">+</a> <span class="commenthtml"><!-- optional --></span>
   <a href="#" id="prev">-</a> <span class="commenthtml"><!-- optional --></span>
</div>

Icon designed by Sebastián Cortés

Changelog:

0.9.6: check if required elements exist on page before initializing timelinr
0.9.54: Bugfix: large timelines now gets centered.
0.9.53: Bugfix: arrows hidden when jumping from first and last dates resolved.
0.9.52: Problem with arrows nav and 2 or less issues now fixed.
0.9.51: As requested, now prev/next buttons are hidden if the issue is in the first/last position. Also, jQuery updated to 1.7.2 version (latest) and HTML markup now is HTML5 doctype.
0.9.5: IE8 bug smashed while dates are animated (vertical); CSS updated: filter added due to IE8 bad-support of PNG transparency (#issues img).
0.9.4: Added autoPlay, autoPlayPause and autoPlayDirection (disabled by default).
0.9.3: Added startAt: select where do you want the timeline to start.
0.9.3: Fixed bug with animation while pressing the navigation buttons.
0.9.2: Fixed Firefox bug with event.preventDefault();
0.9.1: Added keyboard navigation, see vertical demo.
0.9.1: preventDefault(); added to arrows.
0.9.1: Documentation improved.

ES

Este sencillo plugin ayuda a que le des más vida y estilo a las aburridas líneas de tiempo. Soporta diagramaciones horizontales y verticales, y puedes parametrizar la mayoría de los atributos: velocidades, transparencias, etc.

Última versión estable: 0.9.6

Configuración:

Incluye la librería jQuery y luego este plugin:

<script src="js/jquery-1.x.x.min.js"></script>
<script src="js/jquery.timelinr-0.9.x.js"></script>

Inicialízalo con los parámetros por defecto:

$(function(){<br />
   $().timelinr();<br />
});

O customízalos:

$(function(){<br />
   $().timelinr({<br />
      orientation: 'horizontal',
      <span class="commentjs">// valores: horizontal | vertical, por defecto horizontal</span>
      containerDiv: '#timeline',
      <span class="commentjs">// valores: cualquier etiqueta HTML ó #id, por defecto #timeline</span>
      datesDiv: '#dates',
      <span class="commentjs">// valores: cualquier etiqueta HTML ó #id, por defecto #dates</span>
      datesSelectedClass: 'selected',
      <span class="commentjs">// valores: cualquier clase, por defecto selected</span>
      datesSpeed: 'normal',
      <span class="commentjs">// valores: número entre 100 y 1000 (recomendado) ó 'slow', 'normal', 'fast', por defecto normal</span>
      issuesDiv : '#issues',
      <span class="commentjs">// valores: cualquier etiqueta HTML ó #id, por defecto #issues</span>
      issuesSelectedClass: 'selected',
      <span class="commentjs">// valores: cualquier clase, por defecto selected</span>
      issuesSpeed: 'fast',
      <span class="commentjs">// valores: número entre 100 y 1000 (recomendado)ó 'slow', 'normal', 'fast', por defecto fast</span>
      issuesTransparency: 0.2,
      <span class="commentjs">// valores: número entre 0 y 1 (recomendado), por defecto 0.2</span>
      issuesTransparencySpeed: 500,
      <span class="commentjs">// valores: número entre 100 y 1000 (recomendado), por defecto 500 (normal)</span>
      prevButton: '#prev',
      <span class="commentjs">// valores: cualquier etiqueta HTML ó #id, por defecto #prev</span>
      nextButton: '#next',
      <span class="commentjs">// valores: cualquier etiqueta HTML ó #id, por defecto #next</span>
      arrowKeys: 'false',
      <span class="commentjs">// valores: true/false, por defecto false</span>
      startAt: 1,
      <span class="commentjs">// valor: número entre 1 y el máximo de elementos, por defecto 1 (primero)</span>
      autoPlay: 'false',
      <span class="commentjs">// valor: true | false, por defecto false</span>
      autoPlayDirection: 'forward',
      <span class="commentjs">// valor: forward | backward, por defecto forward</span>
      autoPlayPause: 2000
      <span class="commentjs">// valor: número (1000 = 1 seg), por defecto 2000 (2segs)</span>
   })
});

El marcado HTML debe ser de la siguiente forma:

<div id="timeline">
   <ul id="dates">
      <li><a href="#">date1</a></li>
      <li><a href="#">date2</a></li>
   </ul>
   <ul id="issues">
      <li id="date1">
         <p>Lorem ipsum.</p>
      </li>
      <li id="date2">
         <p>Lorem ipsum.</p>
      </li>
   </ul>
<a href="#" id="next">+</a> <span class="commenthtml"><!-- opcional --></span>
<a href="#" id="prev">-</a> <span class="commenthtml"><!-- opcional --></span>
</div>

Ícono diseñado por Sebastián Cortés

Cambios:

0.9.6: verifica si elemento existe antes de inicializar timelinr
0.9.54: Ahora se centran lineas de tiempo con muchas fechas
0.9.53: Problema con salto entre primer y última fecha y desaparición de flechas de navegación solucionado.
0.9.52: Problema con la navegación con flechas y 2 ó menos issues ahora solucionado.
0.9.51: como solicitado, los botones prev/next se esconden si el issue está en la posición inicial/final. Además, jQuery fue actualizado a 1.7.2 (última) y el doctype del documento ahora es HTML5.
0.9.5: bug de IE8 aplastado cuando las fechas eran animadas (vertical); CSS mejorado: filter agregado por el mal soporte de IE8 con los PNG transparentes (#issues img)
0.9.4: Agregados autoPlay, autoPlayPause y autoPlayDirection (deshabilitados por defecto).
0.9.3: Agregado startAt: selecciona en qué punto quieres que comience la línea de tiempo.
0.9.3: Solucionado bug con animación mientras presionas los botones de navegación.
0.9.2: Solucionado bug Firefox con event.preventDefault();
0.9.1: Agregado navegación por teclado, ver ejemplo vertical.
0.9.1: preventDefault(); agregado a las flechas.
0.9.1: Documentación mejorada.

Demo Horizontal{.verejemplo}

Demo Vertical{.verejemplo}

Demo Autoplay{.verejemplo}

Download/Bajar Plugin + Demos{.bajar}