TKCORE框架学习之入门篇（十三）--显示格式介绍

显示格式介绍

Display，中文即显示，用于控制字段的显示格式。框架已经内置了一些常用的Dispaly，你只需要配置DataXml中相应字段的tk:Display属性，就可以控制字段显示格式。

在哪配置

在DataXml配置、以生日字段为例，如下：

<?xml version="1.0" encoding="UTF-8"?>
<tk:Toolkit version="5.0" xsi:schemaLocation="http://www.qdocuments.net ..\..\schema\v5\DataXml.xsd" xmlns:tk="http://www.qdocuments.net" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <tk:Table TableName="tableName">
    <tk:TableDesc>
      <tk:Content>XXX表</tk:Content>
    </tk:TableDesc>
    <tk:Field DataType="string" IsEmpty="false">
      <tk:FieldName>birthday</tk:FieldName>
      <tk:NickName>birthday</tk:NickName>
      <tk:DisplayName>
        <tk:Content>生日</tk:Content>
      </tk:DisplayName>
      <tk:Layout Layout="PerUnit" UnitNum="1"/>
      <tk:Control Control="Date" Order="30" DefaultShow="All"/>
      <!-- 我在这里 -->
      <tk:ListDetail>
        <tk:ListDisplay>
          <tk:AutoDisplay/>
        </tk:ListDisplay>
        <tk:DetailDisplay>
          <tk:AutoDisplay/>
        </tk:DetailDisplay>
      </tk:ListDetail>
      <tk:Edit>
        <tk:Display>
          <tk:DateDisplay />
        </tk:Display>
      </tk:Edit>
    </tk:Field>
  </tk:Table>
</tk:Toolkit>

• <tk:ListDetail>针对列表页和详情页的配置
  • <tk:ListDisplay>针对列表页的该字段显示格式配置
  • <tk:DetailDisplay>针对详情页面的该字段显示格式配置
• <tk:Edit>针对新增页和修改页的配置
  • <tk:Display>针对新建/修改页面的该字段显示格式配置

常用显示格式的效果

内置显示格式

常用的内置显示格式如下：

显示格式	描述
StaticDisplay	显示静态文本，无视字段的数值
NormalDisplay	直接显示字段的内容
DoubleDisplay	按照指定的格式显示浮点数字
DateTimeDisplay	按照指定格式显示日期时间
DateDisplay	按照指定格式显示日期
TimeDisplay	按照指定格式显示时间
AbbrDisplay	因为内容太多，将大部分内容用…代替的显示
CheckedDisplay	布尔显示，显示打勾，打叉
MaskDisplay	由于字段内容敏感，因此隐藏部分字段内容，如手机号隐藏中间4位
MailToDisplay	数据是邮箱地址，可以用这个配置，将显示发邮件的超链
HttpDisplay	数据是http地址，可以用这个配置，将显示地址的超链
UploadDisplay	配置了Upload控件的显示，会从具体的UploadProcessor获取显示的详细信息
DoubleColorDisplay	当浮点高于或低于某个基准值时，以指定的颜色来显示
UploadImgDisplay	将Upload的地址显示为图片的Display
RelativeDateDisplay	根据当前日期和显示日期比较，酌情显示今天，明天，昨天，上溯一周内显示星期几，其他按照yy-MM-dd显示
DecoderDisplay	配置了EasySearch或CodeTable节点的控件的解码显示
MultipleDecoderDisplay	MultipleEasySearch或者CheckBoxList控件的显示
AutoDisplay	自动根据配置调用相应的Display进行显示，和不配置相当。（该配置是为了兼容原先没有Display时设置，将在后续的版本中取消该配置）

我们已经为这些规则定义了Schema文件，所以开发时IDE也会有温馨的提示。

更多内置显示格式，请点击复杂的 Display 介绍

也许你关心怎么自定义自己的显示格式，我们将会在今后的篇章中介绍如何自定义显示格式。

关于TKCore的更多信息请点击： http://www.tkcore.net
关注微信公众号获取TKCore最新资讯：