1.字段介绍

一个组件对应一个数据库表,表有字段,那么组件也有字段。通过设置组件的字段,就可以对应到数据库表的字段。

2.通用设置项

2.1.字段标题

在数据列表页面,字段的标题就是表头名称;在添加编辑页面,字段的标题就是表单项的标签名称。

2.2.表列名称

表列名称对应到数据库表里面的字段名称。比如用户表qd_user,里面有个UserName字段,表示登录账号。那么字段标题可以叫“登录账号”,表列名称则是“UserName”。

如下图所示,是用阿里云的DMS打开数据库的表设计。列名,就是表列名称。

另外,在添加编辑表单页面,表单控件的name属性,也是设置的表列名称。

2.3.字段排序

在字段排序管理页面,可以对字段的顺序进行排序,如下图所示。字段的顺序,会影响到2个地方。

  1. 一个是列表页面。会按照字段的顺序进行表格列排序。如果没有设置为列表项,则会忽略。
  2. 另一个是添加编辑详情页面。会按照从左到右的顺序,依次排列表单控件。这里的排序会用到bootstrap响应式布局,采用12等分的宽度比例。根据每个表单控件设置的宽度,按照顺序往下挤。如果没有设置为添加项/编辑项/详情项,则会忽略。

2.4.字段类型

每个字段都有类型,类型决定了字段的表现形式和作用。框架中的字段类型与数据库表的字段类型,并不是一一对应关系,它是对数据库表字段的高级抽象,更偏向于应用层,而不是数据底层。

比如一个字段存储邮箱,在数据库表设计里面,会定义为varchar类型,设置50个字符长度。但在框架中,就抽象为“邮箱”类型的字段,也可以设定录入长度为50。

框架中的字段类型,与数据库表里面的字段类型,并没有强制关联关系。可以把数据库里面的int类型,对应到框架的文本类型;反之亦可,框架会做转换,但不保证不出错,因为有些类型也无法相互转换。

根据业务应用场景,目前框架归类了8种大的字段类型,每种大类型下有具体小类型。

  1. 单行文本框。从普通的单行文本框,到有具体类型的邮箱、网址、手机号等,都是单行文本框。针对网址、手机等具体类型,框架可以做一些针对的输入限制和验证。
  2. 多行文本框。分为普通的textarea多行文本框,和富文本编辑器(目前使用百度的UEditor)。
  3. 数值。针对整数、小数类型。具体类型就有货币、文件大小、距离单位,可以进行有针对性的显示格式化。
  4. 下拉框。对普通的下拉框,做了一些业务上的应用。比如婚姻、学历等。另外增加了动态AJAX加载的下拉框。
  5. 单选复选框。普通的单选复选框,做了美化显示。
  6. 时间日期。适用于显示年份、年月、年月日、时间值的各种场景。
  7. 上传。上传图片和上传文件。在操作上没有区别,只是在显示上,图片会以预览方式显示。
  8. 其他类型。支持地理位置标记,目前使用百度地图。

2.5.字段参数

字段参数用于设置字段数据的展现形式,即会影响到添加编辑表单页的展现,也会影响到列表数据页的展现。每种字段类型的参数都不一样,其作用也不一样,要具体类型具体应用。

选中具体字段的类型,在字段参数输入框下面,会有相应的参数说明。如下图所示。各个字段参数使用,以及样例效果,会在最后面的章节,进行详细说明。

3.列表页面设置项

3.1.列表最小宽度

列表页面表格,每一列的宽度,默认是自动调整。表格列会自动根据页面的宽窄,进行缩放。在某些情况下,如果页面太窄,有的列就会被挤成很窄,里面的数据也会被挤成多行,不太美观。如下图所示,登录时间列,里面的数据,被挤成了3行。

为了控制某些列的宽度,可以给某些列设置一个最小宽度值。这样即使是整个屏幕的页面很窄,设置了最小宽度的那一列,至少也会显示设定的宽度值(最小宽度采用像素值)。如下图所示,当设置了登录时间列最小宽度为180后。同样的页面宽度,登录时间列,保持了180像素的最小宽度,不会再被挤成3行。

3.2.列表最多字符数

有些表单字段(多行文本框、富文本编辑器),会录入比较多的数据内容。比如备注说明、摘要简介等。如果将这些类型字段设置为列表项,那么在列表显示时,就会显示出该字段的所有内容。由于每条记录的内容不一样,这势必会导致有些记录会占用很多行,而有些记录只有一两行。

如下图所示,是工作日志列表,可以看到“日志内容”列,会显示所有内容,有的有5行,有的只有1行。

当设置“列表最多字符数”为30后,该列显示的内容,最多只会显示30个字符。超过30个字符,就会被截断,后面显示“...”。鼠标移上去时,则会提示显示所有内容。如下图所示。

注意:这里的字符数,中文和英文都会算作1个字符,而不是像有些编码把中文当做2个字符。另外,针对多行文本框内容,换行符“\n”在web前端显示时,会替换为“<br>”,这也会被计算为4个字符数。

3.3.列表对齐方式

设置表格列数据的对齐方式,如下图所示,分别为左对齐、居中对齐、右对齐的效果。

3.4.字段列表提示

显示在列表表头上,相当于是对该列的特殊说明。如下图所示,是一个运费的公式提示。当设置字段列表提示后,列表页面的表头列会出现问号符号,鼠标移上去会显示提示内容。

3.5.显示格式

显示格式用于进一步设置字段在列表中的显示。在没有设置显示格式时,字段数据会根据字段参数进行格式化(也并非所有字段类型都受字段参数影响)。设置显示格式后,数据会再次进行格式化。即先通过字段参数格式化,再通过显示格式进行格式化。

字段参数只是对数据值,做某种形式的变换。比如时间日期类型,字段参数用于限定显示的格式是“2019年10月23日13:57:35”,还是“2019-10-23 13:57:40”;比如数值下拉框,会将数值是1、2、3,转换为相应的审核中、审核通过、审核拒绝文字。

显示格式是对转换后的数据,做进一步的包装。采用标签的形式,来进行替换。

比如我们想要实现这样的功能:在产线管理中,每个产线下可设置多个工位。那么在产线列表页面,除了列出产线名称,还需要列出该产线下的工位数量。点击数量,弹出界面,加载该产线下的所有工位,可以进行增删改操作。如下图所示,我们对“线下工位”这个字段进行设置。

1)首先需要添加一个标题为“线下工位”的字段,表列名称设置为“linestepcount”。在数据库表中并不存在这个字段,这是一个别名字段,需要在组件的左连接中配置。

2)在组件的左连接查询中配置,如下图所示。可以看到,工位数量是通过SQL查询出来,查询出数量后通过AS别名为linestepcount。并且还做IFNULL的判断,否则为null时会输出空,而不是0。

3)设置显示格式,如下图所示。可以看到,支持HTML代码,采用${field}标签来替换自己的值,也可以用${field:Id}这种标签,来替换其他字段的值。

4)在web前端页面展示时,单元格的展示内容,是标签替换后的数据,如下图所示。

4.添加编辑表单设置项

设置添加编辑页面表单控件的一些数据。

4.1.placeholder

设置单行和多行文本框,在没有数据时,显示在文本框中的背景提示信息。如下图所示,当输入内容后,背景提示内容被覆盖。

4.2.默认值

设置默认值后,在添加表单页面,默认值会自动填充到表单控件中。默认值只对添加页表单有效,编辑页表单会根据数据的真实值进行填充。

  1. 如果是单行多行文本框,以及数值文本框,默认值自动填充到文本框中。
  2. 如果是单选复选框,设置默认值后,会勾选相应值的按钮。
  3. 如果是下拉框,设置默认值后,会默认选中相应的项。
  4. 如果是日期框,设置为默认值为now()后,会取当前日期时间填充到输入框。
  5. 如果是session类型,设置默认值会忽略。因为session字段的值,是在后台服务器进行取值。
  6. 如果是hidden类型,会生成hidden类型的input控件,并赋上默认值。一般用于赋值默认的状态和类型。
  7. 如果是request类型,设置默认值会忽略。因为会从URL的QueryString中取相应name的参数值,生成hidden类型的input控件,并赋上取到的value值。

4.3.字段录入提示

显示在输入框下面,对该输入框进行提示说明。

提示:该设置项支持HTML、CSS、JS代码。所以可填写控制颜色的说明,也可以编写对该输入框的JS控制代码。

1)如下图所示,输入图中的说明提示。

2)实际在页面上的显示,编写的span样式生效了,解析了HTML代码。如下图所示。

高级的用法,就可以写一些控件的监听事件(点击、值改变、失去焦点等事件监听)。

4.4.输入框宽度

添加编辑表单页面,采用响应式布局,将一行分割为12等份。所以每个表单输入框,可以设置1到12个宽度。为了简化处理,框架只允许字段设置宽度为3、4、6、8、9、12。因为这个宽度是包含表单控件的文字标签和输入框一起,所以太窄了也显示不了。

bootstrap官网,有对响应式布局的栅格系统进行介绍。具体资料,可以百度了解。如下图所示,是官网的一个栅格比例图。

应用在太极平台的表单页面中,各种宽度值下的样例,如下图所示。这是添加用户的表单页面,分别设置了各种宽度值的效果。

可以看到,第2个字段姓名昵称输入框,仍然在第一行显示。这是因为它占用4个宽度,加上第1个字段登录账户的3个宽度,只有7个宽度值,没有超过12,在一行仍然可以显示。而第3个字段密码本身有6个宽度值,6加7位13,超过12,所以密码就只能在第2行显示。后面的其他字段同理,在一行12个宽度值下,都无法显示,只能单独一行。

另外,可以看到,即使是单独一行,每一行的表单控件label标签,并没有对齐。这是因为字段的label标签和输入框,会自动根据设置的宽度值,来分配宽度比例。可能是2:10,也可能是3:9,或者4:8。比如设置字段宽度值为12,那么label和输入框的宽度比会为2:10;设置字段宽度值为6,那么label和输入框的宽度比会为4:8。如果在宽度值为6的情况下,设置宽度比为2:10,就可能出现label宽度太窄,会被挤成多行,比如图中的第1个字段登录账号。(PS:即使是这样自动计算,在某些界面上——特别是弹框,还是会存在问题。以后会升级为单独设置每个字段的label宽度值)

4.5.输入框高度

输入框的高度,只对多行文本框,以及富文本编辑器有效,其他类型的字段都无效。

  1. 多行文本框。设置行数,而不是像素值。采用的是textarea的rows属性。如下图所示,设置高度值为10,就是rows为10。
  2. 富文本编辑器。设置像素值。目前富文本编辑器类型,尚在完善。

4.6.输入最多字符数

针对单行文本框,和多行文本框,控制输入的字符数。该设置项会应用到表单控件的maxLength属性上。如下图所示。

该属性值是HTML表单自带的,设定后,一旦输入字符数达到设定值,在控件中就无法再输入数据。从而达到在前端页面控制数据录入长度。

同时,服务端也会对长度进行验证。如果提交超过设定的字符串数据,服务端也会返回字符数超过限制的提示。如下图所示。

注意:设置的可输入最多字符数,最好与数据库表字段的长度一致。表结构设计字段太短,保存会异常;设计字段太长,存储会浪费。

5.Excel导入导出设置项

5.1.Excel导出列宽

设置导出Excel文件列表数据的列宽度。默认导出的Excel列表,列宽度是固定值。如下图所示,所有列的宽度都一样。对有些数据比较长的列,就会显示不下,被遮挡了。比如登录日期、IP地址,特别是登录时间,都折叠了。

针对有些需要扩宽的列,可以单独设置列的宽度。具体列宽设置为多少,可以有个小技巧。

1)首先,双击需要调整列宽的表头分割线。Excel会自动调整该列的宽度,以满足该列所有数据记录的展示。

2)调整完列宽后,在当前列表头,点击右键,弹出菜单,选择“列宽”。

3)可以看到当前的列宽值。如下图所示,为19.13。这个就是我们设置的列宽值,一般向上取整,可以取20。

4)最后在字段设置中,设置Excel列宽为20即可。其他列的宽度调整,步骤雷同。

5)再导出Excel,会发现设置的列宽度加宽了。但是查看列宽值,可能并不一定是我们设置的20。实际的列宽值可能会多点,这个没关系,不一定非要这么精确,主要是数据宽度能展示。

6.字段属性

6.1.列表项

字段设置为列表项后,就会在列表页面的表格中显示。具体显示到哪一列,会跟字段顺序有关。显示的数据内容,跟字段类型、字段参数、以及自定义显示格式有关。

6.2.合计项

字段设置为合计项后,会在列表页面的表格最后面新增一行,显示该列所有数据的总和。一般针对数量、总金额类型,可以设置合计项。非数值类型,系统会验证,无法设置合计项。

注意:合计项是汇总的所有数据,而不是当前页的数据。

6.3.别名项

一般设定为别名项的字段,是当前数据库表中不存在的字段。要通过SQL语句的AS进行别名,或者是从左连接的外表中查询获得。如果要获取数据,就需要在组件设置的左连接查询中配置,否则该字段的数据就会为空(因为没有查询)。

设置为别名项的字段,组件在拼接SQL列表语句时,会忽略掉该字段。因此,就必须要在组件的左连接查询配置项中设置,才会查询该字段。

如下图所示,是用户账号管理的字段。在用户表中,所属角色存储的是角色外键Id。当在列表页面上显示时,需要显示角色名称。此时就需要通过左连接查询,获取角色名称,显示到列表中。

别名项字段不会设置为添加项和编辑项,一般只会用户列表项和详情项。

别名字段RoleName在组件的别名左连接查询中,进行设置。如下图所示。

6.4.添加项

设置为添加项后,在添加页面,才会出现该字段。表单控件的name属性,就是字段的表列名称。

针对hidden类型和request类型,表单会创建hidden类型的input控件,在界面上是隐藏的。通过F12调用浏览器调试,可以看到。

针对session类型,则不会创建表单控件,而是在保存时通过后台直接获取。

6.5.编辑项

设置为编辑项后,在编辑页面,才会出现该字段。

针对hidden类型和request类型,设置为编辑项,没有意义。因为其值不会进行改变。

针对session类型,编辑保存时,会重新获取新的session值,进行更新。

6.6.详情项

设置为详情项后,在详情页面,才会出现该字段。

详情项支持自定义显示格式,可以调用其他字段标签。

6.7.只读项

设置为只读项后,在编辑页面,会以静态文本的方式显示字段值,而不是编辑框。所以只读代表不可编辑,一般用于不可修改数据,而又要在编辑页面显示。比如在订单编辑页面,订单编号添加后不可更改,所以可以在编辑页面展示出来。如下图所示。

在添加页面,只读项属性会被忽略掉。因为意义不是太大,既然是只读,那么就不会被修改,所以一个只读的添加项没有意义。如果非要在添加时,固定添加某个字段的值,可以使用hidden类型的文本,或hidden类型的数值,然后设置一个默认值。

注意:只有设置了字段为编辑项后,设置只读项才有意义。单独设置字段为只读项,没有任何作用和意义。

6.8.必填项

在添加编辑页面,设定字段为必填项后。在页面上,会在控件标签右边,显示红色的星号提示。如下图所示。

并且在保存数据时,后端服务器会进行为空判断。当输入为空时,界面会进行提示。如下图所示,对上面的表单进行验证提示。

另外:框架会自动捕获数据库null异常。

如果数据库表字段设置为不允许null,在添加数据时,有可能会传入空的数据过去(比如没有设置字段为添加项,但该字段不能为null)。在插入数据时,数据库就会报异常,因为插入记录时,将空值添加到不允许为null的字段上。

数据库报异常后,框架会捕获到该异常。经过解析,识别为null异常,之后会处理,并进行友好的提示。如下图所示,为框架捕捉的null异常。

这里补充截图……

6.9.禁止重复项

当表中某个字段的数据,不允许重复时,可以设置该字段为禁止重复项。比如针对人员信息,身份证号码不能重复;针对会员登记,手机号不能重复。

设置为禁止重复项后,系统会自动进行重复性验证。无需进行其他额外的开发验证工作。重复性验证的逻辑如下:

  • 在添加数据时,会先去数据库表中查询是否存在相同数据。如果存在,就会提示数据已存在;否则不存在,就继续进行保存操作。
  • 在编辑数据时,会先用新数据值,去查询除了本条记录之外,是否有相同数据。如果存在,提示数据已存在;否则不存在,继续进行保存操作。(PS:为什么要查询除本条记录之外的重复数据?因为如果保存时没有修改数据值,那么查询全表的话,肯定就会出现重复数据,因为自己等于自己)

注意:验证重复性,是针对单表的单个字段。如果要实现根据2个字段来确定唯一性,可以使用下面的小技巧。

技巧:利用数据库唯一性索引,以及框架自身的异常捕捉,实现多个字段联合唯一性。

比如针对SaaS系统的后台管理,有这样的应用场景:存在企业表和企业员工表,要分配企业账号和员工账号。企业员工登录时,需要输入企业账号和员工账号,两者同时验证通过后,就可以登录通过。

那么企业账号全局不可重复,员工账号在本企业内不可重复,但是员工账号在全局可能会重复。这样就需要通过企业账号和员工账号配对,来唯一确定一个员工。

1)建立唯一性索引。

  • 企业表中,对企业账号字段建立唯一性索引,使用hash索引方式。
  • 员工表中,对员工账号字段和企业Id字段,2个字段组合建立唯一性索引,使用hash索引方式。

2)充分利用框架自身的异常捕捉。

如果数据库中设置了唯一性索引,而字段又没有设置禁止重复,那么重复数据会执行保存操作。当存储到数据库时,必然会发生数据库异常。

框架自身会捕捉到这个数据库异常信息,并进行解析,发现异常的原因是由于唯一性索引的数据重复。便会结合原因进行友好的提示。

如下图所示,是框架捕捉到重复异常后的提示。如果不解析捕获的异常,就会提示添加数据异常,而不会提示具体的异常原因。

6.10.搜索项

设置为搜索项后,该搜索字段就会出现在列表页面的搜索栏上(前提是要先在组件设置中开启搜索功能),会自动作为搜索条件供选择搜索。

每种类型的字段,在设定为搜索项后,都会做一定的调整变换,以适应作为搜索项的展示方式。所以同一个字段,在添加编辑页面和在搜索栏上时,其展现方式可能是不一样的。具体有如下的不一样:

  • 字段标题会隐藏掉。文本框类型,标题会以placeholder的方式,出现在文本框中。
  • 有些字段类型,会自动忽略掉搜索项属性,即使是设置为搜索项,也不会生效。比如密码字段类型、上传文件字段类型等。
  • 文本类型,会采用SQL语句的like '%?%'进行查询,所以字段索引意义不大。
  • 时间日期类型,会根据格式进行匹配。比如是日期类型,会执行to_days(fieldName)=to_days(?);如果是年月类型,会执行date_format(fieldName,'%Y-%m')=date_format(?,'%Y-%m')。
  • 起止日期段类型,只能作为搜索项。
  • 单选框类型,会转换为下拉框类型。并且默认会选中“所有XX”。
  • 下拉框类型,会增加第一个选项“所有XX”,且默认选中该项。
  • 数值类型、下拉框等其他类型,会采用等号进行等值搜索。

6.11.Excel导出项

设置字段为Excel导出项后,在导出Excel文件时,该字段的数据才会被导出。前提是,要先在组件设置中开启Excel导出功能,工具栏上才会有导出Excel按钮。

导出说明:

  1. Excel导出时,会结合搜索条件。如果开启了搜索功能,且搜索条件中有数据。那么Excel导出的数据,将是满足搜索条件的所有数据。
  2. Excel导出时,不考虑分页。即会导出所有满足条件的数据到Excel中(不是只导出第一页数据)。

6.12.Excel导入项

设置字段为Excel导入项时,上传Excel文件进行导入时,才会读取该列的值,并添加到数据记录中。前提:也要先在组件设置中开启Excel导入功能,工具栏上才会出现Excel导入按钮,以及模板下载菜单。

导入说明:

  1. 数据列是通过Excel表头的列标题进行匹配。只有Excel文件的列标题与字段标题完全匹配,才会认为是同一列数据。
  2. Excel文件的数据列顺序无关,导入时只会根据标题进行匹配。
  3. Excel文件数据记录不要有空行或者空表头列。如果存在空行,会被认为数据集结束。空行后面的数据不再导入。
  4. 如果导入时,不知道单元格中填写什么样的数据格式,可以先导出Excel查看。

6.13.空属性字段

在某些情况下,会创建一些字段,不设置任何属性。这些字段也会有用处,。

7.字段参数

7.1.单行文本框类型

单行文本框的详细类型,如下图所示。

7.1.1.单行文本框

普通的单行文本框,可输入任何内容。可输入的字符数长度,通过字段选项“输入最多字符数”进行设置。

参数作用:设置输入框的前缀和后缀。

格式:前缀###后缀

样例:¥###元

样例效果:补充图片……

7.1.2.邮箱输入框

输入框中只能输入电子邮箱。

参数:无。

7.1.3.网址输入框

7.1.4.密码输入框

在表单输入页码,输入框只能输入密码。

7.1.5.IP地址输入框(IPV4)

7.1.6.IP地址输入框(IPV6)

7.1.7.手机号

输入框中只能输入11位手机号码。长度不符合,或输入非数字,都会验证不通过。目前暂未强制验证手机号码段,只是做了简单验证。强制验证,有可能导致有些新号段号码无法识别。

参数:无。

7.1.8.固定电话

7.1.9.数字文本框

输入框中只能输入数字,无法输入其他字符。比如QQ号。该输入框不同于数值输入,虽然输入的是数字,但是保存到数据库的仍然是文本。

格式:前缀###后缀

7.1.10.身份证号码

输入框中只能输入身份证号码。不同于数字文本框,因为身份证号码最后一位有可能是英文字母X,且长度固定为15位或者18位。保存时,后台会进行强制验证。

参数:无。

7.1.11.邮编

输入框中只能输入6位长度的数字。长度不够,或者输入非数字,都会验证不通过。

参数:无。

7.1.12.订单编号

该类型会自动生成一个编号数据。

7.1.13.文本标签

7.1.14.session文本和数值

7.1.15.hidden文本和数值

7.1.16.request文本和数值

7.2.多行文本框类型

多行文本框的具体类型,如下图所示。

7.2.1.多行文本框

7.2.2.富文本编辑器

富文本编辑器目前采用的是百度的UEditor。分了3个不同的版本:简洁型、标准型、增强型。这3个版本就是工具栏的数量不同,以满足在不同场景下的需要。

7.2.3.代码编辑器

7.3.数值类型

数值类型的详细类型,如下图所示。

数值类型的控制,是在输入框上只能输入数字。包括整数和小数。数据库里面存储的也是int或者decimal小数。

7.3.1.整数

整数分为正常整数(int类型)和大整数(long类型)。在输入表单页面,没有任何区别,都是数值输入框。只是在保存时,后台验证,会有范围的区别。

参数作用:

7.3.2.小数

也是数值输入框,只是可以保留小数位。在表单页面可以输入小数。至于可保留多少位小数,需要在参数中配置。默认保留2位小数。

参数作用:

7.3.3.货币

货币也是采用小数输入框。默认是保留2位小数,采用人民币符号。

7.3.4.文件大小

7.3.5.距离单位

7.4.下拉框类型

下拉框的具体类型,如下图所示。

7.4.1.文本下拉框

7.4.2.数值下拉框

7.4.3.外键下拉框——普通列表

7.4.4.外键下拉框——树形列表

7.4.5.外键下拉框——动态加载

采用AJAX动态加载数据。通过在输入框中输入数据,从服务端实时查询满足条件的数据,展示在下拉框里面。效果如下。

  1. 参数作用:设置下拉框数据从哪个表进行查询、查询条件、排序规则,以及查询和显示哪个字段。
  2. 格式:外键表###主键字段###查询字段###查询条件###排序规则
    1. 主键字段、查询字段。支持将多个字段组合为1个字段。比如:CONCAT(NickName,"(",UserName,")") AS NewNickName
    2. 查询条件。支持session和request标签。
    3. 查询条件。
      1. 如果查询条件不填写,则采用默认的查询条件;
      2. 如果填写了,就必须要填写完整,以“?”来标识输入的字符。比如:State=1 and ProjectName like CONCAT('%',?,'%')
  3. 样例:qd_project###Id###ProjectName###State=1 and ProjectName like CONCAT('%',?,'%')###StartDate DESC

联动下拉框

地区下拉框

地区下拉框分为3种:只选择省份、选择省份和城市、选择省份城市和地区,对应的就是选择到几级区域。

常用固定下拉框

常规的下拉框数据,都是固定的数据。

1)婚姻下拉框

2)学历下拉框

3)民族下拉框

4)血型下拉框

7.5.单选复选类型

单选复选框的具体类型,如下图所示。

7.5.1.文本单选框

7.5.2.数值单选框

7.5.3.文本复选框

7.5.4.数值复选框

7.5.6.开关状态

7.6.时间日期类型

时间日期类型的详细字段,如下图所示。

7.6.1.日期框

参数作用:设置日期框在列表页面的显示方式。如显示:2019年11月15日,或2019-11-15,或3天前,42天后等。

参数格式:指定日期的显示格式,采用Java的SimpleDateFormat格式。如:yyyy-MM-dd。

另外,支持特殊格式:shortTimeSpanDays、shortTimeSpan。计算时间间隔天数,如3天前、4天后。

shortTimeSpan会将时间间隔转换为最大单位。不足1个月,就会显示多少天;不足1年,就会显示多少月。

shortTimeSpanDays则只会显示间隔多少天。

添加编辑表单页面展示效果如下。

1)参数样例:yyyy-MM-dd。设置普通的显示格式,如yyyy年MM月dd日等,根据实际需求设置。

列表显示效果:

2)参数样例:shortTimeSpan。显示日期值与当天的间隔天数。超过30天,会转换为月;超过12个月,会转换为年。

列表显示效果。

3)参数样例:shortTimeSpanDays。显示日期值与当天的时间间隔天数。直接只显示间隔天数,不进行转换。

列表显示效果:

7.6.2.时间框

参数作用:设置时间输入框在列表页面的显示格式。

参数格式:指定日期的显示格式,采用Java的SimpleDateFormat格式。如:yyyy-MM-dd。

添加编辑表单页面。

7.6.3.日期时间框

7.6.4.年份框

7.6.5.年月框

数据列表页面,默认列表格式采用yyyy-MM的方式格式化。如下图所示。

也可以设置字段参数,配置列表页面的显示。如下图所示,当参数设置为yyyy年MM月后,列表页面的日期会按设定的格式进行显示。

列表页面会按照新的格式进行显示。

添加编辑页面。

7.6.6.时间戳

时间戳不可用于添加编辑页面,只能用于列表展示。其作用是将数据库中的时间戳(整数或大整数类型),转为时间类型显示在列表中。

7.6.7.日期范围

目前专用于搜索栏上,用于选择日期范围。如下图所示,选择开始日期和结束日期。

也可以通过快捷下拉框,选择常用的日期范围。如下图所示。

日期范围另外一种展示样式,是由2个日期选择框组成。样例效果如下图所示。

时间间隔

用于在列表上显示到目前为止的时间间隔,仅用于列表显示。

7.7.上传类型

上传类型目前提供2种:图片上传和文件上传。

7.7.1.图片上传

7.7.2.文件上传

7.9.其他类型

其他类型目前还在完善中,暂无实现功能。

7.9.1.地理位置

目前暂未实现功能,接下来会加入百度地图,完善功能。

2.2.太极平台框架—组件的字段介绍与使用相关推荐

  1. 2.1.太极平台框架—表单介绍与使用

    1.表单介绍 一个表单对应数据库中的一个表,但一个表可以对应多个表单. 点击表单管理,可以看到所有的表单.可以按照菜单进行分类.如下图所示. 1.1.表单基本功能 1.1.1.调用路径 就是访问该表单 ...

  2. 1.2.太极平台框架简介

    1.太极平台框架简介 太极平台框架,是专为制作后台管理系统而开发的一个框架.使用该框架,可以非常快速的搭建系统. 针对于列表.以及增删改查这种通用的功能,太极框架只需要配置列表有哪些字段,以及这些字段 ...

  3. 1.6.太极平台:开发自己的后台系统首页

    1.需求场景 太极平台框架自身是不带首页效果的,因为每个项目的功能需求不一样,所以首页要显示的统计数据和内容也不一样.可以给大家看几个样例效果. 下面的图片会压缩显示,可以点击图片查看原始大图,效果更 ...

  4. 1.3.太极平台:15分钟搭建初始后台系统

    使用太极平台,能快速搭建后台管理系统.无需任何修改,自带拥有用户管理.角色权限管理.登录日志等基本功能.启动运行后,效果如下图所示. 下面详述创建流程.首先是要把IDEA编辑器.Java环境配置好,这 ...

  5. 大数据平台框架、组件以及处理流程详解

    数据产品和数据密不可分作为数据产品经理理解数据从产生.存储到应用的整个流程,以及大数据建设需要采用的技术框架Hadoop是必备的知识清单,以此在搭建数据产品时能够从全局的视角理解从数据到产品化的价值. ...

  6. JAVA SpringBlade 微服务开发平台框架,企业级的SaaS多租户微服务平台,基于Spring Boot 2.7

    SpringBlade微服务开发平台 完整代码下载地址:JAVA SpringBlade 微服务开发平台框架,企业级的SaaS多租户微服务平台 采用前后端分离的模式,前端开源两个框架:Sword (基 ...

  7. MSCode微服务平台框架基于SpringCloud、SpringCloud Alibaba、SpringBoot和Activiti7工作流,快速开发办公OA、CRM、ERP、电商、信息管理等业务系统

    MSCode微服务平台框架 mscodecloud.com 基于Spring Cloud.Spring Boot和Activiti7工作流,提供所有源码和详尽文档,帮助企业快速开发分布式业务系统. 企 ...

  8. 如何设计可视化搭建平台的组件商店?

    相关文章: 如何搭积木式的快速开发H5页面? 演示地址: H5-Dooring页面制作平台 关注并将「趣谈前端」设为星标 每早08:30按时推送技术干货/优秀开源/技术思维 之前一直在做 lowcod ...

  9. Android 进阶技术汇总二: 流行框架组件 方案汇总

    前言:应用框架组件概述: 主要介绍移动应用开发涉及 推送.语音识别.音视频.图片.地图.定位.广告接入.后台统计分析.HTTP通信.分享.支付.数据解析.序列化.消息总线等 WebApp Cordov ...

最新文章

  1. JavaScript实现页面滚动到div区域div以动画方式出现
  2. Android——Activity去除标题栏和状态栏
  3. matlab基于ssd的角点匹配_基于关键点的目标检测
  4. matlab中云模型,云模型简介与个人理解matlab程序.doc
  5. navicat导入CSV/Excel文件
  6. 6常见的HTML和CSS面试问答
  7. 话题:什么是前端工程化?
  8. 实习成长之路:设计模式一:为什么你明明使用面向对象设计语言总写面向过程的程序?
  9. AutoPtr 的局限性
  10. 状态空间方程的等价问题
  11. Linux根目录的建立
  12. 计算机it是什么,IT是什么意思
  13. blackman窗 matlab,【matlab】矩形窗/三角窗/hanning窗/hamming窗/blackman窗的频率响应图...
  14. 影视之我看——写自己的剧本
  15. JS细胞分裂递归案例
  16. 数据挖掘(一)A-Priori
  17. 田金龙老师讲解杨式太极拳的起势
  18. 6G需要1000亿个基站;5G套餐资费年内或降至50至60元;国内首款L4级5G无人驾驶汽车量产...
  19. 如何让一个div跟随鼠标移动
  20. Linux主机下连接远程postgresql数据库、容器版postgresql数据库

热门文章

  1. matlab 固有频率 振型,基于MATLAB语言多自由度振动系统固有频率及主振型计算分析.pdf...
  2. gyp ERR! stack Error: EACCES: permission denied, mkdir
  3. CH579中ADC增益多通道自动换挡
  4. 用anacnda创建虚拟环境用不用指定python版本
  5. hadoop和spark主备HA配置说明
  6. python控制泰克示波器捕捉触发波形
  7. 电商运营裂变新玩法—分销渠道系统模式
  8. 计算机由于exls表格经常卡,excel表格数据多总是卡-EXCEL表格中的不多,但是老是卡,怎么办?...
  9. js 判断是否为 Android IOS IPAD IPHONE 等移动设备访问
  10. Html5学习------canvas绘制径向渐变图形