以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()完成后会自动调用。

由众触低代码平台生成和驱动