
QoR Admin 不支持直接通过 Meta(&admin.Meta{Name: "Etag", Type: "Readonly"}) 启用只读字段,因其底层依赖自定义表单模板;需配合 Type: "string" + Config: &admin.MetaConfig{ReadOnly: true} 并提供兼容渲染逻辑,才能实现字段可见但不可编辑。
qor admin 不支持直接通过 `meta(&admin.meta{name: "etag", type: "readonly"})` 启用只读字段,因其底层依赖自定义表单模板;需配合 `type: "string"` + `config: &admin.metaconfig{readonly: true}` 并提供兼容渲染逻辑,才能实现字段可见但不可编辑。
在 QoR Admin(一个基于 GORM 的 Go 后台管理框架)中,将模型字段设为“只读但可见”是一个常见需求——例如 Etag、Updated、Status 等由系统自动维护的字段,不应允许用户在后台表单中手动修改,但仍需在详情页或编辑页中展示其值。
⚠️ 注意:你遇到的错误
got error when render form template for Etag(Readonly): haven't found form template for meta Etag
根本原因在于 QoR 的 Type: "Readonly" 是一个已废弃/未实现的伪类型。它并非内置元类型,而是期望开发者自行提供 metas/form/Etag.tmpl 模板文件来渲染只读内容。若模板缺失,就会触发 reflect 层调用失败,导致 panic 或 500 错误。
✅ 正确做法(推荐且稳定):
使用标准字段类型(如 "string"、"time"、"bool")配合 ReadOnly: true 配置,无需额外模板:
EpgResource := Admin.AddResource(&models.Epg{}, &admin.Config{
Menu: []string{"Content"},
})
// 显式配置只读字段(推荐方式)
EpgResource.Meta(&admin.Meta{
Name: "Etag",
Type: "string", // 使用合法类型,非 "Readonly"
Config: &admin.MetaConfig{
ReadOnly: true, // ✅ 关键:启用只读模式
// 可选:自定义显示文本(如加前缀说明)
Formatter: func(value interface{}, ctx *qor.Context) interface{} {
if value == nil {
return "(not set)"
}
return "ETag: " + fmt.Sprint(value)
},
},
})
EpgResource.Meta(&admin.Meta{
Name: "Updated",
Type: "time",
Config: &admin.MetaConfig{
ReadOnly: true,
// 可选:格式化时间显示
Formatter: func(value interface{}, ctx *qor.Context) interface{} {
if t, ok := value.(time.Time); ok && !t.IsZero() {
return t.Format("2006-01-02 15:04:05")
}
return "(unknown)"
},
},
})
EpgResource.Meta(&admin.Meta{
Name: "Status",
Type: "bool",
Config: &admin.MetaConfig{
ReadOnly: true,
// 可选:用中文标签替代 true/false
Formatter: func(value interface{}, ctx *qor.Context) interface{} {
if b, ok := value.(bool); ok {
return map[bool]string{true: "启用", false: "禁用"}[b]
}
return "未知"
},
},
})
? 补充说明与最佳实践:
ReadOnly: true的实际效果:
字段在编辑表单中渲染为或(非),同时后端自动忽略该字段的更新请求(即使前端被篡改提交,GORM Save 也不会写入),双重保障数据安全。避免误用
gorm:"-"或gorm:"->":gorm:"-"会让字段完全不参与数据库操作(也不查询),而gorm:"->"(只读)仅影响 GORM 层,QoR 表单仍可能允许编辑——因此必须在 QoR Meta 层显式控制。进阶:条件只读(如仅创建后只读):
若需“新建时可填、编辑时只读”,可结合Context判断路由:Config: &admin.MetaConfig{ ReadOnly: func(ctx *qor.Context) bool { return ctx.Request.URL.Path == "/admin/epgs/edit" // 或检查 ctx.ResourceID 是否存在 }, }调试提示:
若字段仍可编辑,请检查是否遗漏Admin.AddResource后的Meta()调用顺序(必须在资源注册后立即配置),或确认字段名大小写与结构体完全一致(Go 是大小写敏感的)。总结:QoR 中实现“可见只读”的核心不是寻找神秘的
"Readonly"类型,而是选用合法字段类型 +ReadOnly: true+ 可选Formatter增强语义。这一方式轻量、可靠、无需模板维护,也与 GORM 字段级权限(如gorm:"->")形成前后端协同防护,是工业级后台系统的推荐实践。










