在 Repeater 中绑定转化 JSON 格式的字段

有时我们希望 Repeater 中显示的信息是根据字段的内容来确定的, 而不是直接显示字段本身的值, 今天将为大家说明如何通过字段表达式来处理绑定的字段.

由于精力有限, 不能在多个博客中保证文章的同步, 可在如下地址查看最新内容, 请谅解:

http://code.google.com/p/zsharedcode/wiki/AjaxReturnJSON

如果, 有不明白的问题, 请先阅读 30 分钟掌握无刷新 Repeater.

请到 Download 下载资源 的 JQueryElement 示例下载一节下载示例代码

本文中所包含的内容如下:

  * 准备
  * 使用范围
  * 简单绑定
  * 转换绑定
  * 格式化日期字段
  * 使用 jQuery 代替$
  * 根据字段设置样式

示例图片:

准备

请参照 http://code.google.com/p/zsharedcode/wiki/JQueryElementRepeaterDoc 中的准备.

使用范围

可以在 ItemTemplate/UpdatedItemTemplate/InsertedItemTemplate/RemovedItemTemplate/EditItemTemplate 模板中绑定字段.

可以将字段绑定在标签的属性中或者作为标签的内容.

简单绑定

可以使用 #{<字段名>} 来绑定字段, 比如:

<ItemTemplate>

    <td>
        #{bookname}
    </td>

    <td>
        <strong>评价:</strong> <span class="rank rank#{rank}"></span>
    </td>

</ItemTemplate>

上面的例子中, 将字段 bookname 绑定为标签的内容, 将 rank 字段绑定在标签的属性 class 中.

转换绑定

使用 #{<字段名>[,<字段表达式>]} 来转换字段中的值, 然后输出, 比如:

<ItemTemplate>

        <td>
            <strong>折扣:</strong>
            #{discount,Math.floor(# * 100) / 10} 折
            #{discount,convertDiscount(#)}
        </td>

</ItemTemplate>

在字段表达式中, 使用 # 号来表示被绑定的字段. 上面代码中的 discount 字段分别通过一个 javascript 表达式和一个函数来转换了字段的值并输出, javascript 函数如下:

<script type="text/javascript">
    function convertDiscount(discount) {
        return discount >=0.7?'<strong>清仓啦</strong>' : '减价啦';
    }
</script>

格式化日期字段

对于采用默认参数返回的 JSON, 日期格式的字段的返回值可能类似于 "\/Date(xxxxxxxxxx)\/" 的字符串, 可以通过 jQuery.panzer.formatDate 函数来格式化日期, 或者使用 jQuery.panzer.convertToDate 将 "\/Date(xxxxxxxxxx)\/" 格式的字符串转化为日期类型, 例如:

<ItemTemplate>

    <td>
        <strong>出版日期:</strong>
        <span class="publishdate">
        #{publishdate,jQuery.panzer.formatDate(#,'yyyy年M月d号')}
        </span>
    </td>

</ItemTemplate>

函数 jQuery.panzer.formatDate 的第一个参数为 Date 类型的 javascript 变量或者格式为 "\/Date(xxxxxxxxxx)\/" 的字符串. 第二个参数为用于格式化的字符串, 这类似于 .NET 中的 DateTime 类型的 ToString 方法, 例如:

<script type="text/javascript">
    var date =new Date(2011, 0, 1, 20, 1, 3);
    // 2011 年 1 月 1 号, 20 时 1 分 3 秒

    $.panzer.formatDate(date,'y年'); // 1年
    $.panzer.formatDate(date,'yy年'); // 11年
    $.panzer.formatDate(date,'yyyy'); // 2011

    $.panzer.formatDate(date,'M月'); // 1月
    $.panzer.formatDate(date,'MM月'); // 01月
    $.panzer.formatDate(date,'yyyy-MM');
    // 2011-01

    $.panzer.formatDate(date,'d号'); // 1号
    $.panzer.formatDate(date,'dd号'); // 01号
    $.panzer.formatDate(date,'yyyy-MM-dd');
    // 2011-01-01

    $.panzer.formatDate(date,'H时'); // 20时
    $.panzer.formatDate(date,'HH时'); // 20时
    $.panzer.formatDate(date,'yyyy-MM-dd HH');
    // 2011-01-01 20

    $.panzer.formatDate(date,'h时'); // 8时
    $.panzer.formatDate(date,'hh时'); // 08时
    $.panzer.formatDate(date,'yyyy-MM-dd hh');
    // 2011-01-01 08

    $.panzer.formatDate(date,'m分'); // 1分
    $.panzer.formatDate(date,'mm分'); // 01分
    $.panzer.formatDate(date,'yyyy-MM-dd hh:mm');
    // 2011-01-01 08:01

    $.panzer.formatDate(date,'s秒'); // 3秒
    $.panzer.formatDate(date,'ss秒'); // 03秒
    $.panzer.formatDate(date,'yyyy-MM-dd hh:mm:ss');
    // 2011-01-01 08:01:03
</script>

使用 jQuery 代替 $

在字段表达式中应该使用 jQuery 来代替 $, 以防止由于压缩脚本而产生的问题.

根据字段设置样式

如果需要根据字段的值来显示不同的样式, 可以将字段绑定在 class 属性中, 比如:

<ItemTemplate>

    <td>
        <strong>评价:</strong>
        #{rank}
        <span class="rank rank#{rank}"></span>
    </td>

</ItemTemplate>

在页面开始处定义了一些 rank 的样式:

<style type="text/css">
    .rank
    {
        background-color: #cc0000;
        height: 15px;
        display: inline-block;
    }
    .rank1
    {
        width: 10px;
    }
    .rank2
    {
        width: 30px;
    }
    .rank3
    {
        width: 50px;
    }
    .rank4
    {
        width: 70px;
    }
    .rank5
    {
        width: 90px;
    }
</style>

示例中 rank 字段中可能会是 1 到 5, 因此样式也定义了 rank1 到 rank5.

JQueryElement 是开源共享的代码, 可以在 http://code.google.com/p/zsharedcode/wiki/Download 页面下载 dll 或者是源代码.

示例代码下载: http://zsharedcode.googlecode.com/files/JQueryElementDemo.rar.

实际过程演示: http://www.tudou.com/programs/view/rwruM87J20s/, 建议全屏观看.