# 通用属性

很多字段上的属性配置是所有字段通用的,这里将这些通用属性罗列出来加以说明,不同控件独有的属性将会在控件列表中分不同控件进行说明。

# 字段通用属性

所有控件所支持的通用属性如下

属性名称 描述 备注
FieldName 字段名称 字段名称需要以field开头,驼峰格式
GroupName 组名称 重复节表的组名称需要以group开头,驼峰格式
FieldType 数据类型 必须选择控件支持的数据类型
Description 字段描述 用于在ide里查看所有字段描述,相当于文档,便于流程的维护
CodeTable 对应的代码表
PlaceHolder 文本框提示或确认提示 EditTextareaRichTextRemarkDateTimeSuggesterSuggester2Select显示文本输入提示
ButtonLinkButtonCheck为点击后弹出确认对话框中的文字
FileThing用于显示提示文字
InitialValue 初值 字段的初值
InitialR+ 初值是否只读 true
InitialCond 赋初值条件 Blank 当字段为空值时候赋初值 Always 总是赋初值
Parent 字段的联动父亲 选择另一个字段作为当前字段的父亲
ValidateNotNull 验证非空 true
ValidatePrompt 验证不通过出的提示
ValidateRegEx 验证正则
ShowNotNullMark 自动非空提示 选项包括不提示(缺省)、标签前、标签后、控件前、控件后
EventType 支持的事件类型 目前就只有一个fieldChange事件,如果需要该字段支持fieldChange,需要在这个属性中设置

# PlaceHolder


PlaceHolder可提供控件预期输入内容的提示内容,在Edit、RichText、Remark等可输入控件中都是这个用途,placeholder是一个html5的属性,ie8,ie9不支持,其余浏览器都支持。

PlaceHolder还在 ButtonLinkButtonCheck这三个控件中有特殊的用途,可以作为button的click触发前或者checkbox的click触发前的提示信息,如果这三种控件在placeholder属性里填写了内容,那么点击时会弹出一个确认对话框,此时如果选择“是”,那么才认为点击有效,如果选择了否,那么就认为没有点击过。

# 初值

InitialValue,InitialR+,InitialCond三个属性用于设置字段初值。InitialValue初值可以使用内置变量,使用内置变量时请用${}将变量包起来,例如${_VAR_ACTION_REALNAME}。InitialR+属性确定了这个初值在前端是否可以修改,如果为true,那么前端这个字段是只读的。InitialCond有两种选择,Blank或Always,前者表示当该字段为空值时候就用InitialValue中的内容作为初值,如果不为空值,那么久不做替换;后者表示无论该字段原先值是什么内容,都用InitialValue中的内容替换作为初值。

# 验证

ValidateNotNull,ValidatePrompt,ValidateRegEx三个属性用于设置字段的验证。ValidateNotNull设置成true,那么在提交时候前端会验证非空。另外前端可以用正则表达式的方式验证输入是否符合要求,正则表达式填在ValidateRegEx中,在验证不通过时候,前端会出填在ValidatePrompt里的提示信息。存盘时候不会验证非空,只验证正则,提交时候则两种都验证。
int,double类型的edit以及日期控件都内置了正则表达式验证,也就是说这2个控件不必再填写ValidateRegEx和ValidatePrompt了。

# 自动非空提示

在ValidateNotNull属性配置为true的前提下,ShowNotNullMark属性可控制表单上是否显示自动非空提示(红色星号),缺省为不提示(Not Display),如想提示建议选择标签前(Before Label)或者标签后(After Label),流程前端会自动找一个离控件最近的文本作为其标签,如果是重复表中会在控件所在列的表头文字前后显示星号。

按照规范,桌面版的表单中字段标签靠右,非空提示星号要出现标签前,移动端表单中字段标签靠左,非空提示星号要出现在标签后。ShowNotNullMark属性可以配置为自动(Auto),这样就能满足规范要求。

在比较特殊情况下您也许想设置控件前(Before Control)或控件后(After Control)显示非空提示,这时请确保控件宽度不能占满当前控件所在的格子,否则提示的星号会和控件分两行显示,如想配置控件前后显示提示,请自行调整表单控件到合适的宽度以确保星号能和控件同行显示。

自动非空提示选项列表

选项 描述
Not Display 不提示(缺省)
Auto 自动(桌面版标签前,移动版标签后)
Before Label 标签前
After Label 标签后
Before Control 控件前
After Control 控件后

ShowNotNullMark自动非空提示是一个字段级的静态配置,如果想实现更为复杂提示逻辑可以使用动态非空提示notNullMark

# UserFilters

用户限定条件(仅对User数据类型有效) 格式[dept1][:post1],[dept2][:post2],用部门和岗位来限定用户,其中部门和岗位都可以为*,部门为代表所有部门,岗位为代表所有岗,如果不限定岗位,表示所有正式岗(formal==true)。用UserFilter限制User数据类型的Suggester,只能填写固定值,这里是不支持变量的。如果想根据所选用户的部门动态的限定选人控件的部门,可以使用Parent设置,比如将fieldUser1字段的Parent设置为fieldOrganize1,那么fieldUser1选人控件下拉出来的用户的部门就都由fieldOrganize1来指定了。User数据类型的控件的Parent设置和UserFilter设置是等价的,只不过UserFilter只支持固定值限定,而Parent可以支持动态值限定。关于UserFilters更详细的说明请参考此处

# 重复节表属性

  • MinOccur 最小行数 如果这个属性设置不为0,且有新增权限,那么在初始化时候新增最小行数条初始数据
  • MaxOccur 最大行数 如果有最大行数限制,那么在按新增按钮时候会做控制
  • FullWidth 可以设置重复节表的行是否占满其父元素的全宽度,用于需要格线闭合的情况