本文将介绍soft.pastecode.cn出品的PasteForm，PasteForm是贴代码使用Dto思想实现的CRUD的一个组件，或者说输出一个思想！
为啥我觉得是最佳的CRUD呢？先结合你的实际项目解答下以下问题：
1.如果有一个系统，有100个表，你的管理端需要多少页面？别和我说100个表很多，需求复杂点的随随便便上100个数据库表的！
2.新的需求下来了，说XX表要新增一个字段，默认为100，新增的时候输入，不支持修改，作为你目前的管理端你需要几个步骤来实现？关键点你如何做版本过渡的问题？
3.做开发的都是到，表和表之间一般是有关系的，虽然不一定会建立外表链，比如BindUserGrade的表中的UserId一般就是表示UserInfo表的Id,这就牵扯到录入，更新，和显示的问题了，其实我们希望看到的是显示UserInfo中的UserName而不是干巴巴的一个UserId对吧！
4.一个表我们在管理端的时候一般会涉及到数据的列表显示，比较常用的就是table表格对吧，对应的有新增，编辑，查看，删除，那作为管理端你如何控制他们的权限？权限往往涉及2大块，a.前端页面的显示否，b.后端接口中的权限判定
... .. .
让我们一起来看下PasteForm的案例项目PasteTemplate是如何处理以上问题的！
案例代码 https://gitee.com/pastecode/paste-template/tree/master/example/PasteTemplate
从上面下载代码后，直接启动，然后，应该是localhost:22222端口 http://localhost:22222/page/index.html
登陆页面
登陆页面没什么好说的，因为不涉及找回密码，注册等，只有图形验证码和登陆
管理端
登陆后，看到如上图
左侧菜单采用动态的模式，菜单由权限读取，系统在首次启动的时候会把默认的菜单写入到数据库，如果当前账号有root-root的权限，则会返回所有的菜单，也就是root-root表示超级权限的意思,拥有系统的所有权限！
由于其他表的信息比较简单，我就从测试表的数据来举例子
页面组成
PasteForm的整个体系其实只有4个页面，
1.上图的index.html页面，作为管理端的菜单页面
2.右侧区域的数据表格table显示和他上方的搜索区域组成的pasteform/index.html页面
3.对应的表的编辑和新增页面，新增和编辑是同一个页面，这里命名为pasteform/view.html，也就是form表单页面
4.有些时候表的数据多大，我们不希望在table中全部显示，比如博文的正文，这就需要有一个页面查看详细的，pasteform/detail.html
index.html
管理端的主页面，大概是左右布局，100%绝对定位，是为了满足右侧子页面的flex布局，主要点是左侧的tree，内容是从API读取的，也就是不同账号登陆后看到的菜单是不一样的，具体的看角色对应的菜单(权限)
pasteform/index.html
如上图，你看到的内容，可以说整个页面都是后端的Dto控制的
1.比如搜索区域有多少个搜索项，搜索项的交互(daterange,date,outer,select,selects,word等)
2.中间区域的表格，包含了新增，编辑，删除，详情的基本4个菜单，然后就是自定义的一些按钮，比如上图的 添加子集!
3.然后是表格区域内的排序，注意看表格header中的ID 排序 层级 其实哪些字段支持排序，在后端的Dto中也就一行代码的事情！
4.表格中的一些交互，比如上图的switch,点击后是可以直接修改的，操作后会和后端API进行交互，如果返回非200则会重置状态
5.按钮区域的提交按钮，有些时候表格的按钮需要条件判断，那也是支持的，比如age>18的显示按钮1，age<12的显示按钮2等！
6.表格的自定义显示，有时候我们希望一个表格显示多个字段，比如换行啥的，也是可以实现的
pasteform/view.html
表单主页面，作为新增或者编辑的页面，支持几乎常见的录入
1.基础录入包括默认值等，比如text,number,switch,select等
2.也支持特殊的格式，比如daterange,richtext,textarea,selects,image,file等
3.高级支持,外表输入，比如选择其他表的一个对象作为这个表单的一个录入
点击父级后面的输入框，是弹出一个页面，选择一个对象，作为这个输入框的值，值一般包含2个，一个是id，一个是显示的
4.高级支持，参数输入,比如权限列表中的添加子集，那么打开的应该是添加页面，这个时候父级是不要输入的，由url参数传递过去
还有更多的功能等你发觉，上面说得一大堆功能，其实都是Dto中配置的
啥叫Dto?
接触过ABPvNext的应该比较数据，其实就是不同的Model,比如UserInfo这个表，一般会创建对应的4个Dto
UserInfoAddDto:作为UserInfo新增的数据模型
UserInfoUpdateDto:作为UserInfo的编辑的数据模型
UserInfoDto:一般作为详细显示的数据模型
UserInfoListDto:一般作为表格，列表的数据展示用
这几个模型可以配置互转，就是使用AutoMapper!
为了实现更加灵活的CRUD，我们只需要在对应的Dto中的字段上添加对应的属性即可，由于需求比较特殊，我定义了一个属性
/// <summary>
/// 前端用数据类型
/// </summary>
[AttributeUsage(AttributeTargets.Property | AttributeTargets.Class, AllowMultiple = true)]
public class ColumnDataTypeAttribute : Attribute
{
/// <summary>
/// image region navigator select selects dateplan datetime等
/// </summary>
public string Name { get; set; } = "";
/// <summary>
///
/// </summary>
public string Args1 { get; set; } = "";
/// <summary>
///
/// </summary>
public string Args2 { get; set; } = "";
/// <summary>
/// 参数3
/// </summary>
public string Args3 { get; set; } = "";
/// <summary>
/// 参数4
/// </summary>
public string Args4 { get; set; } = "";
/// <summary>
///
/// </summary>
public string ErrorMessage { get; set; } = "";
/// <summary>
/// 按照要求文档填写参数
/// </summary>
/// <param name="name"></param>
/// <param name="args1"></param>
/// <param name="args2"></param>
/// <param name="args3"></param>
/// <param name="args4"></param>
/// <param name="ErrorMessage"></param>
public ColumnDataTypeAttribute(string name = "", string args1 = "", string args2 = "", string args3 = "", string args4 = "", string ErrorMessage = "")
{
this.Name = name;
this.Args3 = args3;
this.Args1 = args1;
this.Args2 = args2;
this.Args4 = args4;
this.ErrorMessage = ErrorMessage;
}
/// <summary>
///
/// </summary>
/// <returns></returns>
public override string ToString()
{
return string.Format("{0}-{1}-{2}-{3}-{4}", Name, Args1, Args2, Args3, Args4);
}
}
然后是在需要限定的字段添加这个或者多个这个属性，比如
///<summary>
///测试表 用于测试CURD的表
///</summary>
public class TestTableAddDto
{
///<summary>
///姓名 模拟短文本输入
///</summary>
[MaxLength(32)]
[Required]
[PasteMark("test", "name")]
public string Name { get; set; }
///<summary>
///头像 模拟图片上传
///</summary>
[MaxLength(128)]
[PasteMark("test", "head")]
[ColumnDataType("image", "1", "head", "60*60")]
public string Head { get; set; }
///<summary>
///年龄 模拟输入number
///</summary>
[Range(5, 90, ErrorMessage = "年龄必须限定在5~90之间!")]
public int Age { get; set; }
///<summary>
///文本区域 模拟文本区域的输入
///</summary>
[MaxLength(128)]
public string Desc { get; set; }
///<summary>
///富文本 模拟富文本，前端HTML的是使用wangEditv5
///</summary>
public string Blog { get; set; }
///<summary>
///加入日期 模拟必填时间的输入
///</summary>
public DateTime JoinDate { get; set; }
/// <summary>
/// 文件
/// </summary>
[ColumnDataType("file", "/api/app/Upload/UpImage?type=file")]
public string Fpath { get; set; } = "";
///<summary>
///单选 一般表示状态，内定的，有点像Enum,关于Enum后续会支持
///</summary>
[ColumnDataType("mark", "test", "datetype")]
[ColumnDataType("select", "[{\"name\":\"日类型\",\"value\":0},{\"name\":\"月类型\",\"value\":1},{\"name\":\"年类型\",\"value\":2}]")]
public int DateType { get; set; }
/// <summary>
/// 复选 多个之间用逗号隔开
/// </summary>
[ColumnDataType("selects", "[{\"name\":\"日类型\",\"value\":\"day\"},{\"name\":\"月类型\",\"value\":\"month\"},{\"name\":\"年类型\",\"value\":\"year\"}]", ",")]
public string TypeStrs { get; set; }
/// <summary>
/// 复选数组
/// </summary>
[ColumnDataType("selects", "[{\"name\":\"日类型\",\"value\":\"day\"},{\"name\":\"月类型\",\"value\":\"month\"},{\"name\":\"年类型\",\"value\":\"year\"}]")]
public string[] Types { get; set; }
///<summary>
///角色ID 这里一般用于外表，就是选择其他表的一个数据作为输入内容
///</summary>
[ColumnDataType("outer", "gradeInfo", "", "id", "name")]
public int GradeId { get; set; }
///<summary>
///成绩 模拟前端限定2位小数
///</summary>
public double Score { get; set; }
/// <summary>
/// 字符串多图
/// </summary>
[ColumnDataType("image", "3", "img", "60*60")]
public string Img2 { get; set; }
/// <summary>
/// 数组图片
/// </summary>
[ColumnDataType("image", "3", "img", "60*60")]
public string[] Img3 { get; set; }
/// <summary>
/// 会员周期 会员生效区间
/// </summary>
[ColumnDataType("daterange", "dateStart", "dateEnd")]
public DateTime DateStart { get; set; } = DateTime.Parse("2024-09-01 00:00:00");
/// <summary>
/// 会员周期 会员生效区间
/// </summary>
[ColumnDataType("hidden")]
public DateTime DateEnd { get; set; } = DateTime.Parse("2024-10-01 00:00:00");
}
看上面的是测试表的Dto的属性的写法，由于配置ColumnDataType属性有多个参数，为了防止写错，你也可以自定义，然后继承于ColumnDataType就行了，比如我的
/// <summary>
///
/// </summary>
public class PasteMarkAttribute : ColumnDataTypeAttribute
{
/// <summary>
/// 书签属性
/// </summary>
/// <param name="_model">书签模块,示例product</param>
/// <param name="_value">书签项,示例code</param>
public PasteMarkAttribute(string _model, string _value)
{
base.Name = "mark";
base.Args1 = _model;
base.Args2 = _value;
}
}
/// <summary>
/// 日期区间
/// </summary>
public class PasteDaterangeAttribute : ColumnDataTypeAttribute
{
/// <summary>
/// 日期区间
/// </summary>
/// <param name="_sdate">开始日期字段</param>
/// <param name="_edate">结束日期字段</param>
public PasteDaterangeAttribute(string _sdate="sdate",string _edate="edate")
{
base.Name = "daterange";
base.Args1 = _sdate;
base.Args2 = _edate;
}
}
/// <summary>
///
/// </summary>
public class PasteLeftAttribute : ColumnDataTypeAttribute
{
/// <summary>
///
/// </summary>
public PasteLeftAttribute()
{
base.Name = "class";
base.Args1 = "fleft";
}
}
/// <summary>
///
/// </summary>
public class PasteSwitchAttribute : ColumnDataTypeAttribute
{
/// <summary>
///
/// </summary>
public PasteSwitchAttribute()
{
base.Name = "switch";
}
}
/// <summary>
/// 同hidden 表示在UI中隐藏这个对象
/// </summary>
public class PasteHiddenAttribute : ColumnDataTypeAttribute
{
/// <summary>
///
/// </summary>
public PasteHiddenAttribute()
{
base.Name = "hidden";
}
}
/// <summary>
/// 配置菜单或者是条件菜单
/// </summary>
public class PasteMenuAttribute : ColumnDataTypeAttribute
{
/// <summary>
///
/// </summary>
/// <param name="_name"></param>
/// <param name="_script"></param>
/// <param name="_iconfont"></param>
/// <param name="_box"></param>
public PasteMenuAttribute(string _name, string _script, string _iconfont = "", bool _box = false)
{
base.Name = "menu";
base.Args1 = _name;
base.Args2 = _script;
base.Args3 = _iconfont;
if (_box)
{
base.Args4 = "box";
}
}
}
/// <summary>
/// 配置菜单或者是条件菜单
/// </summary>
public class PasteIfMenuAttribute : ColumnDataTypeAttribute
{
//[ColumnDataType("ifmenu", "item.isReady", "<a href=\"javascript:;\" title=\"如果之前创建失败，修改信息后，可以重置，重置后可以重新创建\" onclick=\"global_store_reset_state({{:=item.id}});\"><i class=\"Hui-iconfont Hui-iconfont-xiangpicha\">重置状态</i></a>", "", "")]
/// <summary>
/// 条件按钮
/// </summary>
/// <param name="_expresion"></param>
/// <param name="_insertHtml"></param>
/// <param name="_box">是否在按钮盒子中</param>
public PasteIfMenuAttribute(string _expresion, string _insertHtml, bool _box = false)
{
base.Name = "ifmenu";
base.Args1 = _expresion;
base.Args2 = _insertHtml;
//base.Args3 = _iconfont;
if (_box)
{
base.Args3 = "box";
}
}
}
/// <summary>
/// 用于表格中，显示另外一个字段的某一个值的表达式
/// </summary>
public class PasteOuterDisplayAttribute : ColumnDataTypeAttribute
{
/// <summary>
/// 表格中用于显示某一个字段
/// </summary>
/// <param name="_expression">示例extendService?.name || ''</param>
public PasteOuterDisplayAttribute(string _expression)
{
base.Name = "outerdisplay";
//base.Args1 = _cloumnName;
base.Args2 = _expression;
}
}
/// <summary>
///
/// </summary>
public class PasteDisableAttribute : ColumnDataTypeAttribute
{
/// <summary>
///
/// </summary>
/// <param name="_unadd">禁用新增</param>
/// <param name="_unedit">禁用编辑</param>
/// <param name="_undel">禁用删除</param>
public PasteDisableAttribute(bool _unadd = false, bool _unedit = false, bool _undel = false)
{
base.Name = "disable";
if (_unadd)
{
base.Args1 = "add";
}
if (_unedit)
{
base.Args2 = "edit";
}
if (_undel)
{
base.Args3 = "del";
}
}
}
/// <summary>
/// 单位属性 为计量添加单位
/// </summary>
public class PasteUnitAttribute : ColumnDataTypeAttribute
{
/// <summary>
/// Unit的属性
/// </summary>
/// <param name="_unit">示例元</param>
public PasteUnitAttribute(string _unit)
{
base.Name = "unit";
base.Args1 = _unit;
}
}
/// <summary>
/// Select的属性
/// </summary>
public class PasteSelectAttribute : ColumnDataTypeAttribute
{
/// <summary>
/// Select的属性
/// </summary>
/// <param name="_selectvalues">示例[{name,value,selected}]</param>
public PasteSelectAttribute(string _selectvalues)
{
base.Name = "select";
base.Args1 = _selectvalues;
}
}
/// <summary>
/// Selects的属性 可以多选的
/// </summary>
public class PasteSelectsAttribute : ColumnDataTypeAttribute
{
/// <summary>
/// Selects的属性
/// </summary>
/// <param name="_selectvalues">示例[{name,value,selected}]</param>
public PasteSelectsAttribute(string _selectvalues)
{
base.Name = "selects";
base.Args1 = _selectvalues;
}
}
/// <summary>
/// Image的属性
/// </summary>
public class PasteImageAttribute : ColumnDataTypeAttribute
{
/// <summary>
/// Image的属性
/// </summary>
/// <param name="_num">可以传多少张</param>
/// <param name="_path">存放的路径</param>
/// <param name="_size">转化的大小,示例60*60,1920*0</param>
public PasteImageAttribute(int _num = 1, string _path = "", string _size = "")
{
base.Name = "image";
base.Args1 = _num.ToString();
base.Args2 = _path;
base.Args3 = _size;
}
}
/// <summary>
///
/// </summary>
public class PasteOuterAttribute : ColumnDataTypeAttribute
{
/// <summary>
/// 链接外表显示和输入用
/// </summary>
/// <param name="className">外表名称，示例serviceInfo</param>
/// <param name="extendName">显示的时候的表达式，示例extendService.name || ''</param>
/// <param name="_keyColumn">回传的列的名称，示例id</param>
/// <param name="_showColumn">显示的列表的名称，示例name</param>
public PasteOuterAttribute(string className, string extendName = "", string _keyColumn = "id", string _showColumn = "name")
{
base.Name = "outer";
base.Args1 = className;
base.Args2 = extendName;
base.Args3 = _keyColumn;
base.Args4 = _showColumn;
}
}
案例有了，那么每个name是干嘛用的？
ColumnDataTypeAttribute
ColumnDataType的配置说明
image
相对于后面的 head 来说，这里是大图模式,在ListDto中表示使用图片的模式渲染
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 数字 | 1 | 图片数量 |
| args2 | 字符 | cate | 存放在什么位置，上传图片的时候会附带到参数type中 |
| args3 | 字符 | 60*60 | 图片是否需要压缩，压缩的宽高，不压缩的设置为0,比如60*0 |
| args4 | 字符 | small | small,normal,big表示图片的大小三个规格，默认normal，如果要返回格式，则由dataFrom决定 |
head 弃用，使用image
使用方式同 image 这里表示的是小图标模式
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 数字 | 1 | 图片数量 |
| args2 | 字符 | cate | 存放在什么位置，上传图片的时候会附带到参数type中 |
| args3 | 字符 | 60*60 | 图片是否需要压缩，压缩的宽高，不压缩的设置为0,比如60*0 |
| args4 | 字符 | arr或str | 默认值str对应字段的类型，是array类型还是string类型，如果是string类型多个之间用,隔开 |
file
其实可以使用image的接口，他们2个的返回格式都是一样的，wangEditor的返回格式，主要是UI上不一样，毕竟文件没法预览
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | /api/app/Upload/UpImage | 表示上传的路径，默认是/api/app/Upload/UpFile,你也可以自己修改他 |
region
小程序中的地区选择，可以配置精确度，到区还是到县
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | region | 表示地址选择的层级，可选region和sub-district |
| args2 | 字符 | str | 可用值str或者arr 表示返回的数据类型,str的时候用,隔开 |
outer
表示一个值需要从外表获取，编辑的时候如何显示? 比如fatherId,extendRole
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | cateInfo | 外表的名称，对应模板的path,或者路径，路径一定附带了/字符示例./abc.html |
| args2 | 字符 | extendCates | 表示显示的数据，需要和下面2个配合，是一个当前的扩展，目标数组要配置hidden |
| args3 | 字符 | id | 获取返回对象的属性，一般为id |
| args4 | 字符 | name | id的友好名称显示,这里指的是外表，比如cateId，需要打开catelist页面，选择后，返回cate,则name作为友好显示,id作为实际值 |
outers
outer的复数版本，表示可以从外部列表中选择多个，比如在创建账号的时候给他绑定多个角色，就用这个！
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | cateInfo | 外表的名称，对应模板的path,或者路径，路径一定附带了/字符示例./abc.html |
| args2 | 字符 | extendCates | 表示显示的数据，需要和下面2个配合，是一个数组，目标数组要配置hidden |
| args3 | 字符 | id | 获取返回对象的属性，一般为id |
| args4 | 字符 | name | id的友好名称显示,这里指的是外表，比如cateId，需要打开catelist页面，选择后，返回cate,则name作为友好显示,id作为实际值 |
outerdisplay
ListDto中用于外表的显示，比如有字段cateInfoId,对应的ExtendCateInfo要标记为outerdisplay,args2配置为extendCateInfo?.name || '',否则会显示为[object object]
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | cateInfoId | 表示这个字段的值，一般不显示 |
| args2 | 字符 | extendCateInfo?.name || '' | 表示显示的名称，友好名称，需要后端支持,在前端会处理成.display |
navigator
表示这个值需要使用页面从另外一个列表中获取，这里表示小程序端的,建议使用outer outerdisplay
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | cate.name || '' | 表示显示cate.name或者空这个一般用于ListDto中 |
| args2 | 字符 | cateInfo | 外表的名称，对应模板的path，可以为空 |
| args3 | 字符 | /pages/cate/index/?model=select | 如果对应的表不用模板，则直接表示路径 |
datetime
默认的yyyy-MM-dd HH:mm:ss的格式
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | yyyy-MM-dd HH:mm:ss | 表示时间使用的格式 |
hidden
表示隐藏这个字段，一般是主键ID，或者外表链接过来的会这配置，比如需要给cate添加子项，则添加由cate那边过来
这个也适用于ListDto
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | bind | 如果不填表示隐藏，如果填写了表示页面的query中model=xxx的时候不隐藏,表示非xxx的时候隐藏，xxx的时候不隐藏 |
password
密码框模式
query
如果从query中获取到了数据，则对应的字段隐藏,注意不要配置hidden,因为查询的时候是从表单读取数据的，hidden的话是不写入到form中的，那样查询就没法获取query来的值了
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | cateid | 表示使用url中的哪个参数读取值 |
readyonly
表示这个字段是只读的，一般是编辑的时候生效
richtext
如果是字符串，没有设置maxlength，默认就会变更成richtext，也可以手动强制配置
textarea
如果是字符串，设置maxlength，且设置的值大于128，默认就会变更成textarea，也可以手动强制配置
text
对于一些长度过长的，会被判定为textarea，或者richtext的可以使用这个强制换行成text
fentoyuan
这个是指后台单位为分，又需要前端进行元输入的，注意小数位数为2位小数，也就是分的格式为int
select
表示单选，比如权限类型，一般是指固定类型的，一般不修改的那种情况，也可以表示状态等
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | [{"name":"大","value":"1"},{"name":"小","value":"2"}] | 表示单选的可选值，name是显示 value是值 |
| args2 | 字符 | 表示值得类型，这里是单个，跟随主类型走 |
selects
表示多选，这个表示的是页面上的多选，需要列表显示，然后是可以多选！关键在于最后读取数据的时候，需要判断是什么格式的！
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | [{"name":"大","value":"1"},{"name":"小","value":"2"}] | 表示单选的可选值，name是显示 value是值 |
| args2 | 字符 | , | 如果值类型不是数组，则返回字符串，用这个字符拼接,也就是分割字符 |
sort
表示排序，表示字段的顺序,一般表格比较会使用这个
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 数字 | 0 | 小的排在前面，默认为0 |
link
这个用于表格显示，一般表示用于显示外表的数据,这个将弃用，使用outerdisplay替换
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | extendCate.name | 显示的外表链接，示例extendCate?.name || ''表示显示cate.name或者空这个一般用于ListDto中 |
width
表示这个字段在表格得宽度，可以为*或者对应得数字,是表格得列的宽度的权重,这个适用于ListDto
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | 60 | 表示这个列的宽度，可以为数字也可以是*比如3*这样 |
orderby
表示基于哪个字段进行排序,这个一般是ListDto表示表格中，可以基于哪个字段进行排序查询
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | id | 表示使用id正序排序 |
| args2 | 字符 | id desc | 表示使用倒叙排序 |
datalist
前端表示使用datalist作为选择数据源，前端需要把datalist的id赋值给datalistid，默认为字段name,这个规则适用于表单和QueryDto
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | [{"name":"正常","value":"1","selected":true}] | JSON的字符串，也可以为空 |
| args2 | 字符 | data_pro | 表示调用哪个datalist数据，表示datalist的id,和args1互斥 |
| args3 | 字符 | read_pro_datalist() | 表示需要使用eval执行哪个函数，一般和args2配合使用，和args1互斥 |
daterange
主字段需要设置为daterange,其他字段需要设置hidden,在最后组合数据的时候，会基于参数生成对应的,应该要设置为可null格式
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | sdate | 表示开始时间，最后会传送yyyy-MM-dd 00:00:00的格式数据 |
| args2 | 字符 | edate | 表示结束时间，如果你选择2024-08-31,最后上送的会是2024-08-31 00:00:00 |
| args3 | 字符 | yyyy-MM-dd 00:00:00 | 表示时间的格式化，默认使用yyyy-MM-dd 00:00:00 |
disable
特殊限定，限定于class的，表示禁用这个模型的哪些功能，这个一般用于ListDto，因为这些功能都在列表页面
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | add | 表示忽略新增，也就是不显示新增按钮 |
| args2 | 字符 | edit | 表示忽略编辑，表示列表中没有编辑的这个选项,有些数据只能看，不需要新增和编辑 |
| args3 | 字符 | del | 表示这个表没有删除，页面UI中不需要删除按钮 |
menu
用于列表后面的菜单 比如<a href="javascript:;" onclick="args2"><i class="Hui-iconfont args3">\args1
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | 编辑 | 按钮的名称 |
| args2 | 字符 | open_view(<%:=item.id%>); | onclick事件的代码 |
| args3 | 字符 | Hui-iconfont-menu | 样式名称 |
| args4 | 字符 | box | 默认不写，如果写box表示要方入到menubox中 |
ifmenu
基于条件模式的菜单，使用于Listdto中
示例: [ColumnDataType("ifmenu", "item.age==8", "<a href="javascript:;" onclick="open_window(222,./index.html?path=userInfo&goid={{:=item.id}})">条件2", "box")]
数据对象就是item表示当前这行数据
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | isReady == true | if的表达式中()内的内容 |
| args2 | 字符 | <a hreaf="javascript:;" onclick="open({{:=id}})"> | 这里填写条件后的菜单代码，注意引用需要使用{ |
| args3 | 字符 | box | 默认不写，如果写box表示要方入到menubox中 |
htmltemplate
已抛弃，使用下方的html替代,如果要显示自定义的表格，则使用这个，表示直接显示信息模板注意里面的带参使用{{:=item.name}}这样的形式
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | {{:=item.name}}{{:=item.desc}} | 需要在td中显示的html代码，支持模板的写法 |
html
如果要显示自定义的表格，则使用这个，表示直接显示信息模板注意里面的带参使用{{:=item.name}}这样的形式
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | {{:=item.name}}{{:=item.desc}} | 需要在td中显示的html代码，支持模板的写法 |
linkquery
表示把某些参数穿透给子页面，比如服务->文件，则可以在服务A页的时候查看文件列表B页，在文件列表中可以直接新增文件C页,这个时候我们希望对应的服务ID直接由参数传入
也就是在打开C的时候，希望把B的参数传递给C,注意这个linkquery是放在ListDto中的Class上的，也就是和disable一样
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | 需要传递的参数 | 多个之间用,隔开，比如serviceid,ftype |
object
适用于表单页面，表示从另外一个表单新增数据，比如用户的收货地址，在表单的时候，打开一个新的表单，进行信息填写后，返回一个obj，这个时候是没有写入数据库的,所以在返回的时候需要显示
和outer有点像，不过回传的是一个object类型！如果是编辑的时候？需不需要上传到API表示编辑了?打开表单的时候会传递model=object这个参数过去，表示叫子表单不要做API入库操作
注意这个子模型也是需要建立对应的API的，不过不需要建立新增和编辑的接口，因为被上一级涵盖了！
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | roleInfo | 一般使用path也可以使用页面的路径 |
| args2 | 字符 | id | 新增的时候无用，主要是编辑的时候，基于这个id和path去数据库查询新的数据 |
| args3 | 字符 | name | 表示显示的是这个object的哪个字段，一般在编辑的时候可见 |
objects
object的复数版本，表示一个集合，比如一个会员有多个爱好，新增的时候，打开子表单，填写多个爱好的object信息体返回,在显示的时候，如果一个字段不足以显示???是否支持多个字段联动显示?
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | roleInfo | 一般使用path也可以使用页面的路径 |
| args2 | 字符 | id | 新增的时候无效，编辑的时候表示从数据库查询信息，也作为删除的key使用 |
| args3 | 字符 | name | 表示显示的是这个object的哪个字段，一般在编辑的时候可见 |
mark
字段详细说明，或者是文档，这里是做一个描点，需要使用公共函数自己实现具体的要求，一般的是项目下面的模块的某一个字段的说明，一个项目往往这个是一样的，然后就是哪个模块的哪个字段，所以有2个字段
会在title后面生成一个span class="tapmark" onclick="global_tap_mark(_modek,_code)";
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | product | 一般作为模块使用，比如商品的这个模块 |
| args2 | 字符 | code | 模块下的一个字段的说明，比如code这个字段的用法，案例说明等 |
template
作为有些表的特殊布局，就是自定义布局表格部分的内容，包括表头和表身2个部分,注意需要实现选择的功能，除非这个表用不到选择这个功能
文件存放于pasteform/template.html，就只有一个template.html页面，里面的都是模板代码
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | template_user_head | 表格的表头部分的script的id |
| args2 | 字符 | template_user_body | 表格的表身部分的模板的script的id |
style
针对一些特殊的设定，比如textarea，有些地方我们要设置高一些
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | height:500px; | 就是style里面的内容 |
class
针对一些自定义的class，可以通过这个来配置
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | btngo | 表示这个对象要添加的class |
button
用于表单中，的按钮，用意是让用户点击后触发函数,global_form_button_click(this,className,name);
注意按钮的value为当前字段的value，比如当前页面的path=nginxRoute
/// <summary>
/// Http模板 表示使用Http模式的模板的内容
/// </summary>
[ColumnDataType("button")]
public string Temp1 { get; set; } = "点击导入";
则上面会生成的页面内容为
Http模板：点击导入
点击导入点击后，会调用global_form_button_click(this,'nginxRoute','temp1');
注意由于返回的首单次会小写，所以是temp1而不是Temp1
unit
用于显示单位，比如MB，KG，个等，一般在Int Long Double等Number地方后显示,也可以作为表格中显示?
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| args1 | 字符 | MB | 表示这个对象的单位 |
待处理
1.列表中可编辑的对象 比如switch?
handler_switch_change(elc){
// className columnName id state
}
2.外表选择的时候，是否支持多选模式?
多选模式的时候，如何加载已经选中的，已经选中的如何删除?难不成要搞一个选定区域?
3.Int32[] Int64[] String[]
这种数据的显示和最后更新
4.表单数据的提交前的数据格式的校验！
5.daterange如何设定
单个变成多个！
6.有些数据不需要新增，和编辑 ，虽然可以使用API控制，但是在前端有这么个按钮存在，也是很突兀的，所以得处理
7.管理员拥有多个角色，这个多个角色的显示和编辑问题！
selects 可以设定返回多个
list设定显示的方式 关键在于如何每次编辑的时候不是覆盖！还是写一个单个删除的接口?
8.enum类型的显示问题？其实就是enmu变种到attribute的select!!!
9.从角色绑定权限来说，角色列表，点击权限(给这个角色绑定权限),打开的权限列表是所有的，需要绑定的勾选，不要的取消勾选
model=bind 则有一些字段这个模式下才显示
hidden.args1表示某一个模式，如果为空表示都隐藏
待确认问题
1.必填，如果是int的类型的，是不是只能非0，还是不生效?
2.对于menu的支持，参数因该是{{}}控制的，而不是<%%>
3.enum类型的返回，是返回值，还是对应的名称?是否支持enum转select？
4.有时候表单只是为了新增一个数据，不入库那种！outform model=outform 返回组合的 ...待定
5.比如查看某一个列表--子项列表--子项添加
linkquery cateid,abcid
6.单位转化，比如后台是分，前端需要输入元 那么就是在输入的时候是元，显示是元 提交的时候是分！！！
fentoyuan 分转元 默认2位小数点
7.关于是否需要显示详情页面的问题，因为有时候表格数据是显示不全的，比如richtext，这个时候可能需要一个detail.html页面
如果要呈现，则需要对应的模型Dto的属性,生成器默认是去除的，则需要自己在Domain中添加/template/dto.html作为生成模型替换生成器默认的模型！
页面的呈现上和表单类型，把输入框等渲染成直接显示的即可！
然后再由ListDto中，添加菜单detail的支持！
8.在列表页面中，如果一个对象被标记为query,如果从参数中获取到了值，则这个查询项进行隐藏操作
9.如果列表页面的当前状态为model，则上方的搜索区域默认隐藏
10.关于引入字段说明的事情，比如一个表单100个字段，各个字段表示什么意思，一般的做法是点击对应的？然后弹出或者是跳转到某一个站点，显示这个介绍
mark由此而来
11.是否加入自模型，就是表格数据展示的样式，是否引入自定义的模板？？？
默认是使用内置的二次模板，如果是引用外部的化，则需要整个，也就是表头和表身都需要！
需要外部写一个html的template页面，然后使用Jquery的load加载进去！
在ListDto中，使用template进行标注，标注args1为表头样式的模板 args2为表身部分的内容
12.添加对自定义样式的支持 style class
13.添加对menubox的支持，针对很多按钮的情况
14.表单中需要特意操作的，添加函数支持 把表单的数据传递过去 由自定义函数决定执行结果!global_form_action(elc,className,name,location.search);
项目路由中的 载入模板 模板测试等！
15.搞一个占位的？有时候的排版等，需要空开一个位置
16.可以搞一个属性继承于基础属性，这样在输入的时候会好些，比如PasteMarkAttribute:ColumnDataTypeAttribute;
17.窗口的弹出大小问题，有些情况需要大的 有些情况小的 有些情况要动态的！
18.查询的select和表格的select冲突的问题！！！
19.表格的不同模式下，不同字段的显示问题！
篇幅有限，下章讲接收后端的API如何编写,然后是如何使用代码生成器实现这个CRUD
有问题的，欢迎评论区提问，我会一一回答