Files
marqdo/examples/web-site-zh/forms.mq.md
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

2.1 KiB
Executable File

markup, title, import
markup title import
occlusion 共享文章表单与服务器校验
表单 document
ext/data/表单.mq.md lib/document.mq.md

写文章与后台引用同一个 article 表单,服务入口只挂载一次。字段、规则、展示和数据库提交因此使用同一资源。原示例的公共发布仍为公开入口,自定义后台路径另有真实角色门禁。

article

返回 类型 说明
result any 包含标题、短链、摘要、正文与原始校验上限的插入表单

构造与挂载需要 plugin,并在站点根授予 fs.read 读取相邻的字面字段和规则。标题和短链必填,上限分别是 120 与 80 字符;摘要与正文可空,上限分别是 500 与 8000 字符。浏览器必填提示不能取代这些服务器规则,绕过浏览器校验仍得到实际拒绝消息。构造不会写行或认证用户。

输入类型继续为 text 与 textarea,保留原字段行为。拒绝提交后保留字段错误与当前 CSRF,成功返回首页的实时卡片列表。每次更新都保留新资源,否则挂载旧值会丢掉字段或规则。字段表里的 name 是数据库列名,label 只是用户文案;摘要和完整正文分别展示,不相互替代。

这个表单并不因为出现在后台就变成私有接口。真正私有的业务应保护它自己的系统提交地址,示例明确保留公共创建能力,避免只保护展示页却错误宣称数据写入已受限。

我们 字段 = [读取实际字面字段契约](document.read_table(path="forms.tables.md", title="fields")) 和 规则 = [读取实际字面校验规则](document.read_table(path="forms.tables.md", title="rules"))。

我们 资源 = 创建实际文章插入资源、资源 = [绑定可读字段记录](表单.字段(资源=资源, 定义=字段)) 和 资源 = [绑定实际服务器规则](表单.规则(资源=资源, 定义=规则))。 最后返回 [保留提交文案与成功返回目标](表单.文案(资源=资源, 提交="发布", 取消="取消", 返回地址="/"))。