Zcontrol介绍

zcontrol的目的是通过较简单的配置，生成通用的表单组件，如下拉选择、多选、时间选择器等。 对单个组件，可以被如下的数据配置表示(后文称validation), validation包含了数值信息、约束信息和UI信息:

  const validation = {
    uiType: 'select', //UI的类型，
    valueType: 'string', //值的类型
    desc: '选择器示例',//描述(可选，选择后会在zcontrol里出现一个❓提示)
    key: 'a',//键的值
    value: 1,//对应的值
    validate: {//取值的约束条件(定义域)
      options: [1, 2, 3]//选择性值
    },
    style: {}
  }

uiType可选择:

| uiType | 含义 | 对应数据类型 | | -------- | -----: | :----: | | select | 单选选择器 | string | object | float | boolean | integer | | multiSelect | 多选选择器 | string | object | float | boolean | integer | | color | 颜色选择器 | color | | toggle | 是非选择器 | boolean | | slider | 数值滑动条 | float | integer | | input | 输入框 | float | string | integer | | colorArray | 颜色数组 | color[] | | range | 范围选择器 | {min: 1, max: 2} | | rangeTime | 时间范围选择器 | {min: '2018-01-23', max: '2018-03-23'} | | time | 时间选择器 | time | | group | 群组 | group |

valueType 可选择:

| valueType | 含义 | | -------- | -----: | | float | 浮点型 | | integer | 整数 | | boolean | 布尔 | | color[] | integer[] | string[] | 数组 | | time | 时间 | | color | 颜色 | | gradient | 颜色渐变 | | range | 范围 | | rangeTime | 时间范围 |

对于valiation, 我们可以转化为对象:

const zUtils = require('zcontrol/lib/utils');
console.log(zUtils.toObject(validation));
/**
 * {a: 1}
 * /

也可以把valiation转化为UI组件(react):

  const Zcontrol = require('zcontrol');
  const Com = () => <Zcontrol data={validation}/>;

Zcontrol里的查询格式

| sequelize | 含义 | | -------- | -----: | | $eq | 等于 | | $ne | 不等于 | | $gte | 大于等于 | | $gt | 大于 | | $lte | 小于等于 | | $lt | 小于 | | $not | 不是 | | $between | 在...之间 | | $notBetween | 不在...之间 | | $in | 存在 | | $notIn | 不存在 | | $like | 包含 | | $notLike | 不包含 | | $and | 且 | | $or | 或 |

eg、一个筛选器中，首先配置validation,

  筛选器validation
  const validation1 = {
    name: '字段过滤',
    key: 'filterColumn',
    uiType: 'filterColumn',
    valueType: 'filter',
    desc: '字段过滤(category)',
    handleConfirm: function (a, b) { console.log(a, b); },
    expand: false,
    expandable: true,
    value: null,
    validate: {
      type: 'time', //时间类型
      options: ['a', 'b', 'c', 'd'],
    },
  },
 
  {
    name: '字段过滤',
    key: 'filterColumn1',
    uiType: 'filterColumn',
    valueType: 'filter',
    handleConfirm: function (a, b) { console.log(a, b); },
    desc: '字段过滤(category)',
    expand: false,
    addColor: true,
    expandable: true,
    value: null,
    validate: {
      type: 'measure', //数值类型
      options: ['a', 'b', 'c', 'd'],
    },
  },
  {
    name: '字段过滤',
    key: 'filterColumn2',
    uiType: 'filterColumn',
    valueType: 'filter',
    addColor: true,
    handleConfirm: function (a, b) { console.log(a, b); },
    desc: '字段过滤(category)',
    expand: false,
    expandable: true,
    value: null,
    validate: {
      type: 'category', //文本类型
      options: ['a', 'b', 'c', 'd'],
    },
  },
  measure类型举例 选择并且，选中大于，输入数值，选中小于，输入数值，onChange吐出格式：
  'filterColumn: {
    $and: [ // 不是$and 就是 $or
      {$gt: 2},
      {$lt: 8}
    ]
  }
  category类型举例 选择或者，选择存在，输入内容(可用逗号隔开)，选中不存在，输入内容，onchange吐出格式：
  'filterColumn: {
    $or: [ // 不是$and 就是 $or
      {$in: [1,2,3]},
      {$notIn: [1,2]}
    ]
  }
  time类型举例，可以选择最近的一段时间和之间时间，选择最近时间，可选过去，未来，当前，
  例如 选择过去一天，吐出：
  'filterColumn: {
    $and: [ // 不是$and 就是 $or
      {$gte: '2018-03-14 12:10:12'},
      {$lte: '2018-03-15 12:10:12'}
    ]
  }
  按以上吐出格式类推, $and/$or是固定的，数组里面的对象key值是根据用户选择的变化，如大于就是$gt,包含$like...