jQuery Timelinr 左右滚动时间轴插件
1. 简介
jQuery Timelinr 是一个基于 jQuery 的插件,用于在网页上创建左右滚动的时间轴。它可以方便地展示时间相关的内容,比如历史事件、项目进度等等。本文将介绍如何使用 jQuery Timelinr 插件,并提供代码示例。
2. 使用方法
2.1 引入依赖
首先,我们需要在 HTML 文件中引入 jQuery 和 jQuery Timelinr 的依赖文件。可以通过以下方式引入:
<script src="
<script src="jquery.timelinr-0.9.7.js"></script>
2.2 创建 HTML 结构
在 HTML 文件中,我们需要创建一个容器元素来放置时间轴。可以使用一个无序列表(<ul>
)来表示时间轴的各个时间点。
<ul id="timeline">
<li data-date="2000">
<h2>Title 1</h2>
<p>Content 1</p>
</li>
<li data-date="2005">
<h2>Title 2</h2>
<p>Content 2</p>
</li>
<!-- more timeline items... -->
</ul>
每个时间点的 HTML 结构可以根据需要进行自定义,上面的示例中使用了标题和内容来表示每个时间点。data-date
属性用于指定时间点的日期,它将影响时间轴中的排序。
2.3 初始化插件
在 JavaScript 文件中,我们需要使用 jQuery Timelinr 的初始化方法来创建时间轴。可以通过以下方式初始化插件:
$(function(){
$('#timeline').timelinr({
/* options */
});
});
2.4 配置选项
在初始化插件时,可以通过传递一个配置对象来自定义时间轴的外观和行为。以下是一些常用的配置选项及其说明:
选项 | 类型 | 默认值 | 说明 |
---|---|---|---|
orientation | string | horizontal | 时间轴的方向,可选值为 "horizontal" 或 "vertical" |
containerDiv | string | .timeline | 容器元素的 CSS 选择器 |
datesDiv | string | .dates | 时间点元素的 CSS 选择器 |
datesSelectedDiv | string | .selected | 选中时间点元素的 CSS 类名 |
prevButton | string | .prev | 上一个按钮元素的 CSS 类名 |
nextButton | string | .next | 下一个按钮元素的 CSS 类名 |
arrowKeys | boolean | false | 是否启用键盘方向键控制 |
可以根据需要进行配置,实现不同的时间轴样式和交互行为。
3. 示例
以下是一个完整的示例,演示了如何使用 jQuery Timelinr 创建一个水平方向的时间轴。
3.1 HTML
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>jQuery Timelinr Example</title>
<link rel="stylesheet" href="jquery.timelinr-0.9.7.css">
<style>
/* CSS 样式可以根据需要自定义 */
#timeline {
width: 800px;
margin: 0 auto;
}
#timeline li {
display: inline-block;
width: 200px;
height: 200px;
background-color: #ccc;
margin-right: 10px;
text-align: center;
}
</style>
</head>
<body>
<ul id="timeline">
<li data-date="2000">
<h2>Title 1</h2>
<p>Content 1</p>
</li>
<li data-date="2005">
<h2>Title 2</h2>
<p>Content 2</p>
</li>
<li data-date="2010">
<h2>Title 3</h2>
<p>Content 3</p>
</li>
<li data-date="2015">
<h2>Title 4</h2>
<p>Content 4</p>
</li>
</ul>
<script src="