入门

注意

1. 添加、编辑、删除按钮只有在指定了对应的action才会显示出来。也可以不写，用自己喜欢的方式来实现。
2. 在actions中的action，比如：deleteAction，方法中有一个data参数，其中只有一个id属性。

deleteAction: {
                    method: function (data) { console.log(data); }
                }

依赖

1. jTable依赖于jQuery和jQueryUI，首先应该下载这两个，然后获取jTable。

引用

1. 引入jtable.css，jtable.js。jQuery和jQueryUI的js和css必须于jTable之前引用。

创建容器

1. 只需要一个容器元素即可。

<div id="PersonTableContainer"></div>

创建实例

1. 把下面代码添加到你的页面中：

<script type="text/javascript">
    $(document).ready(function () {
        $('#PersonTableContainer').jtable({
            title: 'Table of people',
            actions: {
                listAction: '/GettingStarted/PersonList',
                createAction: '/GettingStarted/CreatePerson',
                updateAction: '/GettingStarted/UpdatePerson',
                deleteAction: '/GettingStarted/DeletePerson'
            },
            fields: {
                PersonId: {
                    key: true,
                    list: false
                },
                Name: {
                    title: 'Author Name',
                    width: '40%'
                },
                Age: {
                    title: 'Age',
                    width: '20%'
                },
                RecordDate: {
                    title: 'Record date',
                    width: '30%',
                    type: 'date',
                    create: false,
                    edit: false
                }
            }
        });
    });
</script>

准备就绪。在这里设置了表格的title,action URL是为了执行AJAX操作，表格的fields。
运行页面：

如果点击Add new record，会出现一个创建页面：

观察图片和代码，有些东西就对上了。

创建列表操作

listAction 是jTable用来获取数据的，然后用得到的数据填充表格。
这个值是一个规范的URL：'/GettingStarted/PersonList'。
当调用load方法时jTable执行ajax POST请求来获取数据。

$('#PersonTableContainer').jtable('load');

jTable发送的请求，服务端必须返回一个JSON object。按照下面的格式：

{
 "Result":"OK",
 "Records":[
  {"PersonId":1,"Name":"Benjamin Button","Age":17,"RecordDate":"\/Date(1320259705710)\/"},
  {"PersonId":2,"Name":"Douglas Adams","Age":42,"RecordDate":"\/Date(1320259705710)\/"},
  {"PersonId":3,"Name":"Isaac Asimov","Age":26,"RecordDate":"\/Date(1320259705710)\/"},
  {"PersonId":4,"Name":"Thomas More","Age":65,"RecordDate":"\/Date(1320259705710)\/"}
 ]
}

Result 可以是 “OK” 和 “ERROR”。如果是“OK”，Records 必须是一个数组。如果是“ERROR”，会有一个Message属性，说明错误的原因。

[HttpPost]
public JsonResult PersonList()
{
    try
    {
        List<Person> persons = _repository.PersonRepository.GetAllPeople();
        return Json(new { Result = "OK", Records = persons });
    }
    catch (Exception ex)
    {
        return Json(new { Result = "ERROR", Message = ex.Message });
    }
}

添加一条新记录

必须实现 createAction，否则会报错。它是jTable用来发送POST请求“创建新记录”的。当点击Save的时候会发送一条POST请求到服务器：

Name=Dan+Brown&Age=55

在服务端，你可以将数据保存到数据库。需要注意的是createAction必须返回新添加的那条记录（JSON object）。

{
 "Result":"OK",
 "Record":{"PersonId":5,"Name":"Dan Brown","Age":55,"RecordDate":"\/Date(1320262185197)\/"}
}

当添加成功之后，jTable会添加这条记录到表里。

编辑/更新记录

当点击edit icon时，会自动弹出一个编辑表单：

当点击save时，会发送一个POST请求到updateActionURL：

PersonId=2&Name=Douglas+Adams&Age=43

updateAction必须返回一个JSON object：

{"Result":"OK"}

下面是服务端的参考代码：

[HttpPost]
public JsonResult UpdatePerson(Person person)
{
    try
    {
        _repository.PersonRepository.UpdatePerson(person);
        return Json(new { Result = "OK" });
    }
    catch (Exception ex)
    {
        return Json(new { Result = "ERROR", Message = ex.Message });
    }
}

删除记录

当点击delete icon来删除一条记录的时候，jTable会生成弹出一个确认框（这个是可选的，但默认是true）。

当点击删除的时候，会发送一个POST请求到deleteActionURL：

PersonId=3

同样需要返回一个JSON object：

{"Result":"OK"}

下面是服务端的参考代码:

[HttpPost]
public JsonResult DeletePerson(int personId)
{
    try
    {
        _repository.PersonRepository.DeletePerson(personId);
        return Json(new { Result = "OK" });
    }
    catch (Exception ex)
    {
        return Json(new { Result = "ERROR", Message = ex.Message });
    }
}