Files
marqdo/examples/web-net-site-zh/forms.mq.md

39 lines
2.2 KiB
Markdown

---
markup: occlusion
title: 文章发布表单的唯一规则来源
import:
表单: ext/data/表单.mq.md
---
服务入口以 article 挂载本资源,发布页只安放该标识的引用。字段、校验与提交因此共用一份定义。它是公开的演示发布表单,原生后台仍保留登录门禁;不要把两者的策略混为一谈。
## 文章
| 返回 | 类型 | 说明 |
|---|---|---|
| 结果 | any | 带标题/正文字段、原始校验规则与返回地址的插入表单 |
调用需要 plugin。标题必填且最多 120 字符,正文可空且最多 8000 字符,保持原示例的服务器规则。表格逐行表达字段与规则,布尔必填值不是字符串。构造不插入业务记录,也不认证用户;请求提交时才使用应用实际数据库与当前 CSRF。
成功提交显式返回首页文章列表;不合格输入保留校验消息供修正。按钮文案留在同一资源,不再手写 form HTML 或另一份客户端校验程序。调用者保留每次更新返回的新资源,再把最终值交给挂载。
字段表中的 name 对应数据库列,label 只决定显示,type 选择输入框或多行文本。required 的可见提示不能代替服务器规则;绕过浏览器校验仍会得到“标题不能为空”的原生重试页。表单的成功返回地址为首页,失败时仍留在表单响应中,并继续保留当前 CSRF 供再次提交。
`字段` =
| @ | name | label | type | required |
|---|---|---|---|---|
| 1 | title | 标题 | text | True |
| 2 | body | 正文 | textarea | False |
`规则` =
| @ | field | rule | message |
|---|---|---|---|
| 1 | title | required | 标题不能为空 |
| 2 | title | max:120 | 标题太长 |
| 3 | body | max:8000 | 正文太长 |
我们 **资源 = [构造实际文章插入资源](表单.构造(表="articles"))**、**资源 = [绑定清楚列出的字段](表单.字段(资源=`资源`, 定义=`字段`))** 和 **资源 = [绑定服务器真正执行的规则](表单.规则(资源=`资源`, 定义=`规则`))**。
准备完成后返回 *[保留提交文案与显式成功返回目标](表单.文案(资源=`资源`, 提交="发布", 取消="取消", 返回地址="/"))*。