雁起平沙的网络日志

数量金融与R

用jekyll和jQuery实现异步加载文章列表

| Comments

本文主要讨论如何用基于jQuery的插件waypoint,实现异步加载jekyll模板生成的json文件,生成文章列表。

我在另一个博客的文章列表里使用了异步加载的技术,不过直接看页面的html源代码是看不出来的。编译之前的代码在这里

首先,生成文章列表数据的json模板是:

1
2
3
4
5
6
7
8
9
10
11
12
---
layout: nil
---

[
{% for post in site.posts %}
  {"title":"{{post.title}}", 
  "url":"{{site.url}}{{post.url}}", 
  "date":"{{ post.date | date:'%Y-%m-%d' }}", 
  "tags":[{% for tag in post.tags %}"{{tag}}"{% if forloop.last == false %} ,{% endif %}{% endfor %}]}
  {% if forloop.last == false %},{% endif %}{% endfor %}
]

这在前面的文章里提到过。

头部YAML数据部分:

1
2
3
4
5
6
---
layout: default
title: 全部文章
initItem: 50
perPageItem: 100
---

initItem是初始加载时显示的文章主题数,perPageItem是每次页面下拉到底部时读取json数据并新生成的文章主题数。

初始加载网页时,文章主题列表是静态的html,由jekyll生成:

1
2
3
4
5
6
7
<ul class="posts">
{% for post in site.posts limit:page.initItem %}
  <li class="listing-item">
    <time datetime="{{ post.date | date:"%Y-%m-%d" }}">{{ post.date | date:"%Y-%m-%d" }}</time>
    <a href="{{site.baseurl}}{{ post.url }}" title="{{ post.title }}">{{ post.title }}</a>
  </li>{% endfor %}
</ul>

上面的limit:page.initItem限定了列表的项数不超过initItem。当向下拉页面,waypoint会捕捉到页面下拉到底部的事件,并调用getJSON方法来读取json数据,形成文章列表。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
{% if site.posts.size > page.initItem %}
<script src="/js/jquery-1.7.1.min.js" type="text/javascript" charset="utf-8"></script>
<script src="/js/waypoints.min.js" type="text/javascript"></script>
<script type="text/javascript">
  $(document).ready(function() {
    // 关于waypoint,请看 http://imakewebthings.com/jquery-waypoints/
    var $loading = $("<div class='loading' style='text-align:center'><img src='/images/loading.gif'></div>"),
    $footer = $('footer'),
    opts = {
      offset: '100%'
    };

    var count = {{ page.initItem }}; // 初始文章数
    var count_sup = 0; // 循环上界,初始为0
    $footer.waypoint(function(event, direction) {
      $footer.waypoint('remove');
      $('.posts').append($loading);
      $.getJSON("../post.json", function(data) {
        var content = "";
        count_sup = count + {{ page.perPageItem }}; // 循环上界每次增加page.perPageItem项
        var delta = 0; // 局部计数器
        $.each(data, function(i, item) {
          if (i >= count & i < count_sup) {
            content += "<li class='listing-item'><time datetime='" + item.date + "'>" + item.date + "</time>";
            content += "<a href='" + item.url + "' title='" + item.title + "'>" + item.title + "</a></li>";
            delta++;
          }
        });
        count += delta;
        $('div.loading').remove();
        $(".posts").append(content);
        if (count < data.length) $footer.waypoint(opts);
      });
    }, opts);
  });
</script>
{% endif %}

关于这段代码,要注意以下几点:

  1. 上面的代码一开始有个判断语句,当文章数不大于initItem时,后面的js代码不会进入最终生成的html中。
  2. 充分利用Liquid模板的特性,在js代码中,也引用了Liquid模板数据{{ page.initItem }}{{ page.perPageItem }}
  3. .getJSON()读取数据形成列表之后,语句
1
 if (count < data.length) $footer.waypoint(opts);

是要判断已经加载的文章主题数是否到达总数,如果比总数小,就会在新的底部$footer上注册为waypoint,然后再向下拉页面,到达底部还会触发事件,然后接着读取数据,直到数据已经读取完毕。

Comments