本文介绍控件(组件配置项)的配置规范,包括配置规则和通用字段。

配置规则

单个控件配置 = 通用配置 + 私有配置

例如,以下示例中nametypedefault都是通用配置,prefix是私有配置。

{
  "name": "文本框", 
  "type": "text",
  "default": "",
  "description": "带描述-带标注",
  "prefix": "今日进度:"
}

通用配置

字段名含义类型是否必选备注
name显示名string示例值:"文本框"
type类型string示例值:"text"。当设置为hidden时,DataV将不对组件进⾏渲染。
default配置项默认值string、number、object、array无。
showInPanel配置项是否在⾯板显示string可定义配置项的显隐规则。不配置时,显示配置项;配置时,按照配置规则显示,配置规则请参见showInPanel配置规则
caption配置项标注string不配置时,将不显示标注。
description配置项描述string无。
handler处理函数名string无。
col控件主体部分所占栅格数number采⽤24栅格系统。
valuePath配置项对应值的路径string配置规则请参见valuePath配置规则
show自定义配置项的显示与隐藏object配置示例如下。
{
  "xAxis": {
    "type": "group",
    "name": "x轴",
    "children": {
      "show": { 
        "type": "boolean",
        "name": "显示",
        "default": true
      },
      "color": {
        "type": "color",
        "name": "颜色",
        "default": "#ccc",
        "show": [                
          ["show", "$eq", true] 
        ]
      }
    }
  }
}
  • children.show:表示在x轴右侧显示一个点选框。该配置对兄弟属性无效。
  • color.show:表示配置单个属性是否显示。
  • ["show", "$eq", true]:兄弟属性children.show等于true时,color属性才显示。

私有配置

控件不同,私有配置不同,详情请参见控件配置