QQZiFramework笔记：entityTable与erp.public.js使用方法之常归篇

entityTable控件效果如下：

erp.public.js 是前端的一个表格jquery控制，实现单实体的增删改查操作，后端由DBContext提供支持

前提条件（MVC项目）：

1、页面需要引入jquery,bootstrap和erp.public.js

2、控制器需要继承QQZiController

public class BaseController:QQZiController<QQZIUser>
{

}

[LoginCheckFilter(IsCheck = false)]
public class HomeController : BaseController
{

}

我们定义了一个BaseController让所有的控制器都继承它，这里的QQZIUser是用来存储用户状态的类，该类继承QQZiFramework.Membership.BaseUser

--------------------------------------------------------------entityTable使用方法----------------------------------------------------

转到我们的View（MVC的页面）

添加以下Html

  <div class="page-header">

        <p>
            <a id="addnew" href="#">添加</a>
        <p>
    </div>
    
        <div class="table-responsive">
            <table class="table table-striped table-hover table-responsive" id="listTable">
                <thead>
                    <tr>
                        <th colname="#">#</th>
                        <th colname="Name">姓名</th>
                        <th colname="Account">账号</th>
                        <th colname="WeiXin">微信</th>
                        
                        <th colname="#action">操作</th>
                    </tr>
                </thead>
                <tbody></tbody>
            </table>
        </div>
        <div id="pagger"></div>    

我们在页面上定义了一个添加按钮，一个显示表格，和一个div用来存储分页导航

接下来在JS中添加调用

<script>
    
    var entityTable_ops = {
        table: "User"
        , primary: "UserId"
        , pageSize: 10
        , triggerQuery: true
        , pagger: "#pagger"
        , permission: "DemoPermission"
        , editCols: [
            {
                group: "基础属性", fields: [
                    { display: '姓名', colName: "Name", requre: true },
                    { display: '账号', colName: "Account", requre: true },
                    { display: '密码', colName: "Password", requre: true },
                    { display: '提现密码', colName: "ZiEBaoPassword", requre: true },
                    { display: '微信', colName: "WeiXin", requre: true },
                    { display: 'QQ', colName: "QQ", requre: true },
                    { display: '身份证', colName: "IDCard", requre: true },
                    { display: '手机', colName: "Mobile", requre: true }
                    
                    

                ]
            }]
    };
    var entityTable = $("#listTable").entityTable(entityTable_ops);



    $("#addnew").click(function () {
        entityTable.ShowCreateDialog();
    })





</script>

逐一解释一下entityTable_ops中的各个参数

table 实体对象，非表名，这里是维护User表
primary 主键属性（实体属性，非数据表字段）,默认为id
pageSize: 分页大小
triggerQuery 载入后自动查询
pagger: 分页控件显示的地方，不指定则会在table的父窗口中append，默认为#pagger
permission 配置项，Content/permission.json文件中对应的项
editCols:编辑的项，group为一个panel可组显示,display为显示label,colName为实体属性名，fields还有其它参数：
    type：类型值有text,textarea,dropdown,checkbox,date,pic，默认为text
          如果是dropdown类型还需要配置数据源，数据源有三种方式：
            data:直接添加data参数，值为json数组，每项要有value和text
            url:通过ajax访问url，将返回值做为数据源，每项要有value和text
            table:通过内部方法直接查询table，需要配置参数displayField和valueField，分别对应text和value
    requre:必需要输入
    larger:显示为整行
    showLabel:是否显示label，默认显示

事例中新增的按钮执行了一个操作entityTable.ShowCreateDialog()，会弹出新增的对话框

-----------------------------------------------entityTable其它方法-----------------------------------------------

entityTable.Load(json)  //重新加载列表，json为查询条件{Name="name"}



entityTable.GetEditPrimaryValue() //编辑模式下，获取当前行的主键值



entityTable.RefreshItem(primaryVal) //按主键值刷新行数据，并且会调用onRowCreated，一般在手动ajax修改了结果需要显示在行上（默认的编辑会自动刷新）