基本使用

使用命令行将sql表生成一个数据表单类型，如：

  1. CREATE TABLE `users` (
  2.   `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  3.   `name` varchar(50) COLLATE utf8mb4_unicode_ci DEFAULT NULL,
  4.   `gender` tinyint(4) DEFAULT NULL,
  5.   `city` varchar(50) COLLATE utf8mb4_unicode_ci DEFAULT NULL,
  6.   `ip` varchar(20) COLLATE utf8mb4_unicode_ci DEFAULT NULL,
  7.   `phone` varchar(10) COLLATE utf8mb4_unicode_ci DEFAULT NULL,
  8.   `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  9.   `updated_at` timestamp NULL DEFAULT NULL,
  10.   PRIMARY KEY (`id`)
  11. ) ENGINE=InnoDB AUTO_INCREMENT=0 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

生成了：

  1. package datamodel
  3. import (
  4.     ...
  5. )
  7. func GetUserTable() (userTable table.Table) {
  9.     // config the table model.
  10.     userTable = table.NewDefaultTable(...)
  12.   ...
  14.     formList := userTable.GetForm()
  16.     // set id editable is false.
  17.     formList.AddField("ID", "id", db.Int, form.Default).FieldNotAllowEdit()
  18.     formList.AddField("Ip", "ip", db.Varchar, form.Text)
  19.     formList.AddField("Name", "name", db.Varchar, form.Text)
  21.   ...
  23.     return
  24. }

类型

  • 默认，只显示 Default
  • 普通文本 Text
  • 单选 SelectSingle
  • 密码 Password
  • 富文本 RichText
  • 文件 File
  • 双选择框 SelectBox
  • 多选 Select
  • icon下拉选择框 IconPicker
  • 时间选择框 Datetime
  • radio选择框 Radio
  • email输入框 Email
  • url输入框 Url
  • ip输入框 Ip
  • 颜色选择框 Color
  • 货币输入框 Currency
  • 数字输入框 Number

例子：

  2. import (
  3.     ...
  4.     "github.com/GoAdminGroup/go-admin/template/types/form"  
  5.     ...
  6. )
  8. func GetxxxTable() table.Table {
  9.     formList.AddField("ID", "id", db.Int, form.Default)
  10. }

操作

添加字段

  2. // 添加一个字段，字段标题为 ID，字段名为 id，字段类型为 int，表单类型为 Default
  3. formList.AddField("ID", "id", db.Int, form.Default)
  5. // 添加第二个字段，字段标题为 Ip，字段名为 ip，字段类型为 varchar，表单类型为 Text
  6. formList.AddField("Ip", "ip", db.Varchar, form.Text)
  8. // 添加第三个字段，一个sql表不存在的字段
  9. formList.AddField("Custom", "custom", db.Varchar, form.Text)

设置默认值

  1. formList.AddField("header", "header", db.Varchar, form.Text).FieldDefault("header")

设置为必须输入

  1. formList.AddField("header", "header", db.Varchar, form.Text).FieldMust()

设置帮助信息

  1. formList.AddField("header", "header", db.Varchar, form.Text).FieldHelpMsg("长度应该大于5")

不允许编辑

  2. formList.AddField("id", "id", db.Int, form.Default).FieldNotAllowEdit()

不允许新增

  2. formList.AddField("id", "id", db.Int, form.Default).FieldNotAllowAdd()

提交前对字段进行过滤处理

  1. formList.AddField("链接", "url", db.Varchar, form.Text).
  2.         FieldPostFilterFn(func(value types.PostFieldModel) string {
  3.             return "http://xxxx.com/" + value.Get("url")
  4.         })

显示过滤处理

  2. // 限制长度
  3. formList.AddField("链接", "url", db.Varchar, form.Text).FieldLimit(limit int)
  5. // 去除空格
  6. formList.AddField("链接", "url", db.Varchar, form.Text).FieldTrimSpace()
  8. // 截取
  9. formList.AddField("链接", "url", db.Varchar, form.Text).FieldSubstr(start int, end int)
  11. // 标题
  12. formList.AddField("链接", "url", db.Varchar, form.Text).FieldToTitle()
  14. // 大写
  15. formList.AddField("链接", "url", db.Varchar, form.Text).FieldToUpper()
  17. // 小写
  18. formList.AddField("链接", "url", db.Varchar, form.Text).FieldToLower()
  20. // xss过滤
  21. formList.AddField("链接", "url", db.Varchar, form.Text).FieldXssFilter()

插入/新增逻辑重写

如果你的表单插入操作与新增操作比较复杂，框架不能满足，那么你可以完全重写并取代框架的插入操作。

  2. // 取代新增函数
  3. formList.SetInsertFn(func(values form2.Values) error {
  4.       // values 为传入的表单参数
  5.   })
  7. // 取代更新函数
  8. formList.SetUpdateFn(func(values form2.Values) error {
  9.       // values 为传入的表单参数
  10.     })