Admin插件使用

需要如下几步：

• 生成数据表对应的配置文件
• 设置访问路由
• 初始化，并在引擎中加载
• 设置访问菜单

假设你的数据库里面有一个数据表users，如：

使用自带的命令行工具可以帮助你快速生成配置文件，如：

• 安装

• 生成

在项目文件夹下执行

adm generate

注意：选择表格的时候，按空格选择，不是按回车

根据提示填写信息，运行完之后，会生成一个文件users.go，这个就是对应数据表的配置文件了，关于如何配置，在后面详细介绍。

设置访问路由

生成完配置文件后，同时也会生成一个路由配置文件tables.go，如：

package main
import "github.com/GoAdminGroup/go-admin/plugins/admin/models"
// The key of Generators is the prefix of table info url.
// The corresponding value is the Form and Table data.
//
// http://{{config.DOMAIN}}:{{PORT}}/{{config.PREFIX}}/info/{{key}}
//
// example:
//
// "user" => http://localhost:9033/admin/info/user
//
var Generators = map[string]models.TableGenerator{
    "user":    GetUserTable,
}

其中，"user"就是对应的访问路由前缀，GetUserTable就是表格数据生成方法。对应的访问路由地址就是：

设置访问菜单

运行起来后，访问登录网址，进入到菜单管理页面，设置好数据表的管理菜单就可以在侧边栏中进入了。

业务数据表生成方法文件介绍

package datamodel
import (
    "fmt"
    "github.com/GoAdminGroup/go-admin/modules/db"
    form2 "github.com/GoAdminGroup/go-admin/plugins/admin/modules/form"
    "github.com/GoAdminGroup/go-admin/plugins/admin/modules/table"
    "github.com/GoAdminGroup/go-admin/template/types"
    "github.com/GoAdminGroup/go-admin/template/types/form"
)
func GetUserTable() (userTable table.Table) {
    // 设置模型配置
    userTable = table.NewDefaultTable(table.Config{
        Driver:     db.DriverMysql,
        CanAdd:     true,  // 是否可以新增
        Editable:   true,  // 是否可以编辑
        Deletable:  true,  // 是否可以删除
        Exportable: true,  // 是否可以导出为excel
        Connection: table.DefaultConnectionName,
        PrimaryKey: table.PrimaryKey{
            Type: db.Int,
            Name: table.DefaultPrimaryKeyName,
        },
    })
    info := userTable.GetInfo()
    // AddField方法，第一个参数为标题，第二参数为字段名，第三个参数为字段的数据库类型
    // 设置主键id为可排序
    info.AddField("ID", "id", db.Int).FieldSortable(true)
    info.AddField("Name", "name", db.Varchar)
    // 使用 FieldDisplay 过滤性别显示
    info.AddField("Gender", "gender", db.Tinyint).FieldDisplay(func(model types.FieldModel) interface{} {
        if model.Value == "0" {
            return "men"
        }
        if model.Value == "1" {
            return "women"
        }
        return "unknown"
    })
    info.AddField("Phone", "phone", db.Varchar)
    info.AddField("City", "city", db.Varchar)
    info.AddField("CreatedAt", "created_at", db.Timestamp)
    info.AddField("UpdatedAt", "updated_at", db.Timestamp)
    info.SetTable("users").SetTitle("Users").SetDescription("Users").
        SetAction(template.HTML(`<a href="http://google.com"><i class="fa fa-google"></i></a>`))  // 自定义操作按钮
    formList := userTable.GetForm()
    // 设置主键Id不可以编辑
    formList.AddField("ID", "id", db.Int, form.Default).FieldNotAllowEdit()
    formList.AddField("Ip", "ip", db.Varchar, form.Text)
    formList.AddField("Name", "name", db.Varchar, form.Text)
    // 使用 FieldOptions 设置 radio 类型内容
    formList.AddField("Gender", "gender", db.Tinyint, form.Radio).
        FieldOptions([]map[string]string{
            {
                "field":    "gender",
                "label":    "male",
                "value":    "0",
                "selected": "true",
            }, {
                "field":    "gender",
                "label":    "female",
                "value":    "1",
                "selected": "false",
            },
        })
    formList.AddField("Phone", "phone", db.Varchar, form.Text)
    formList.AddField("City", "city", db.Varchar, form.Text)
    // 自定义一个表单字段，使用 FieldPostFilterFn 可以进行连表操作
    formList.AddField("Custom Field", "role", db.Varchar, form.Text).
        FieldPostFilterFn(func(value types.PostFieldModel) string {
            fmt.Println("user custom field", value)
            return ""
        })
    formList.AddField("UpdatedAt", "updated_at", db.Timestamp, form.Default).FieldNotAllowAdd(true)
    formList.AddField("CreatedAt", "created_at", db.Timestamp, form.Default).FieldNotAllowAdd(true)
    // 使用 SetTabGroups 将表单分为几部分tab显示
    formList.SetTabGroups(types.
        NewTabGroups("id", "ip", "name", "gender", "city").
        AddGroup("phone", "role", "created_at", "updated_at")).
        SetTabHeaders("profile1", "profile2")
    // 设置表单页面标题和描述，以及对应sql表名
    formList.SetTable("users").SetTitle("Users").SetDescription("Users")
    // 使用 SetPostHook 设置表单提交后的触发操作
    formList.SetPostHook(func(values form2.Values) {
        fmt.Println("userTable.GetForm().PostHook", values)
    })
    return
}

通过调用models.NewDefaultTable(models.DefaultTableConfig)方法传入数据表模型配置进行初始化，数据表模型配置为：

type Config struct {
    Driver     string       // 数据库驱动
    Connection string       // 数据库连接名，在全局配置中定义
    CanAdd     bool         // 是否可以新增数据
    Editable   bool         // 是否可以编辑
    Deletable  bool         // 是否可以删除
    Exportable bool         // 是否可以导出
    PrimaryKey PrimaryKey   // 数据表的主键
}
type PrimaryKey struct {
    Type db.DatabaseType  // 主键字段类型
    Name string           // 主键字段名
}

业务数据表生成方法是一个函数，返回了models.Table这个类型对象。以下是models.Table的定义：

type Table interface {
    GetInfo() *types.InfoPanel
    GetForm() *types.FormPanel
    GetCanAdd() bool
    GetDeletable() bool
    GetExportable() bool
    GetPrimaryKey() PrimaryKey
    GetDataFromDatabase(path string, params parameter.Parameters, isAll bool) (PanelInfo, error)
    GetDataFromDatabaseWithIds(path string, params parameter.Parameters, ids []string) (PanelInfo, error)
    GetDataFromDatabaseWithId(id string) ([]types.FormField, [][]types.FormField, []string, string, string, error)
    UpdateDataFromDatabase(dataList form.Values) error
    InsertDataFromDatabase(dataList form.Values) error
    DeleteDataFromDatabase(id string) error

主要包括了GetInfo()和GetForm()，这两个函数返回的类型对应的ui就是显示数据的表格和编辑新建数据的表单，截图展示如下：

• 此为数据表格

• 此为数据表单

Form表单

type FormPanel struct {
    FieldList    FormFields      // 字段列表
    Table        string          // 表格
    Title        string          // 标题
    Description  string          // 描述
    TabGroups    TabGroups      // tab分组，使用示例：[这里](https://github.com/GoAdminGroup/go-admin/blob/master/examples/datamodel/user.go#L76)
    TabHeaders   TabHeaders     // tab分组标题，使用示例：[这里](https://github.com/GoAdminGroup/go-admin/blob/master/examples/datamodel/user.go#L78)
    HeaderHtml    template.HTML   // 头部自定义内容
    FooterHtml    template.HTML   // 底部自定义内容    
    Validator     FormValidator   // 表单验证函数
    PostHook      FormPostHookFn  // 表单提交后触发函数
    UpdateFn FormPostFn // 表单更新函数，设置了此函数，则接管了该表单的更新操作，PostHook不再生效
    InsertFn FormPostFn // 表单插入函数，设置了此函数，则接管了该表单的插入操作，PostHook不再生效
}
// 表单验证函数，可以对传过来的表单的值进行验证
type FormValidator func(values form.Values) error
// 表单触发函数，表单数据插入数据库后触发的函数
type FormPostHookFn func(values form.Values)
type FormField struct {
    Field        string                // 字段名
    TypeName     string                // 字段类型名
    Head         string                // 标题
    FormType     form.Type             // 表单类型
    Default                 string                // 默认
    Value                  string                // 表单默认值
    Options                []map[string]string   // 表单选项
    DefaultOptionDelimiter string                 // 默认分隔符
    Editable     bool  // 是否可编辑
    NotAllowAdd  bool  // 是否不允许新增
    Must         bool  // 是否为必填项
    Hide         bool  // 是否隐藏
    HelpMsg   template.HTML  // 帮助信息
    OptionExt template.JS    // 单选/多选的额外设置，详见：https://select2.org/configuration/options-api
    Display              FieldFilterFn           // 显示过滤函数
    DisplayProcessChains DisplayProcessFnChains  // 显示处理函数
    PostFilterFn PostFieldFilterFn               // 表单过滤函数：用于对提交字段值的处理，处理后插入数据库
}

目前支持的表单类型有：

• 默认
• 普通文本
• 单选
• 密码
• 富文本
• 文件
• 双选择框
• 多选
• icon下拉选择框
• 时间选择框
• radio选择框
• email输入框
• url输入框
• ip输入框
• 颜色选择框
• 货币输入框
• 数字输入框

详见：

这样子去引用：

import "github.com/GoAdminGroup/go-admin/template/types/form"
...
FormType: form.File,
...

对于选择类型：单选、多选、选择框，需要指定 Options 值。格式为：

...
Options: []map[string]string{
    {
        "field": "男生",
        "value": "0",
    },{
        "field": "女生",
        "value": "1",
    },

其中，field为显示内容，value为选择对应的值。