以Excel表的形式展示数据库查询到的数据,支持常见的Excel功能,定制列和增删改查操作。
配置
数据路径
即search()的第一个参数,必填。所以要先把数据查询出来,再填这个数据存放路径,插件随即会把所有数据展示到Excel表格中来。
额外空行
除了上面查询到的数据条数外还要在Excel最下面额外多展示几个空行以方便添加新数据。
使用自定义列配置
首次打开此开关会生成默认的列配置以便用户进一步配置。
列配置
表头
默认是字段路径,可以改成对用户更友好的表头,比如删掉x.
等前缀。
字段路径
数据库存储的路径,通常不改。
对齐方式
宽度
删除
可删除不想在Excel中展示的字段,更建议在search()的第三个参数中添加select
查询选项,不把欲隐藏的字段查询出来。
添加列
点+
号添加新的列配置,字段路径必填。
列排序
可以通过左边的序号下拉框快速排序,也可以通过右边的上下箭头移位。
开启【新建/更新/删除】操作
首次开启后会默认填写下面的四个事件表达式,如果是不需要的事件可以清空。
新建事件
在Excel新行中添加的事件将存放在$x
中,默认将整体存放到x
字段中。如果是xdb的话要注意选择合适的key,不推荐使用系统时间作为key。
删除事件
$x
是将被删除的数据。
更新事件
$x
包含被修改后的数据字段和_id,未被修改的字段不在里面,被删除了的字段的值是undefined。另外特意生成了一个更新器updater以方便把修改后的内容保存到数据库。
完成事件
上面事件都完成后执行的事件,其中ok
变量是执行成功的数据条数,ng
变量是执行失败的数据条数;还有C
, U
, D
三个变量里面分别存放着新建,更新,删除三个事件的成功ok
数据和失败ng
数据。
API
插件的容器元素有一些API可供调用。
可以通过插件所在组件数的ID获取容器,比如如果插件是第一个元素,可以通过$("#_0")取到;更推荐给插件一个唯一的类名,用$(".唯一类名")取得;如果页面上只有一个插件实例也可以用$(".zp142")取得。
diff()
即与原数据的差异,返回{ C, U, D }
新建、更新、删除数组。
save()
执行上面提到的四个事件表达式。
reload()
重新加载从数据路径取到的最新的数据,从而覆盖所有Excel的变更。save()完成后会自动调用。