如何在 QoR Admin 中正确设置模型字段为只读(Readonly)?

风明吖_7807

风明吖_7807

2026-11-09

211人浏览

原创

如何在 QoR Admin 中正确设置模型字段为只读(Readonly)?

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:"->")形成前后端协同防护,是工业级后台系统的推荐实践。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

40

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

20

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

20

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

40

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

40

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

40

16

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

2026.11.04

40

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

40

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

0

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习