>[info]RGCMS的表单功能为内置表单模型,稍懂HTML的你可以构建任意表单接受数据,使用简单、安全
## **前台表单的使用**
>[danger] 表单的前台HTML使用POST提交方式,表单系统内置十几种常用判断规则,您无需进行前台判断即可使用
```
<form action="{$url_form}" method="post">
<input type="text" name="表单定义字段" value="" />
其他如单选、多选、下拉等请自行扩展
重点:必须在form体内添加以下2行代码
<input type="hidden" name="formid" value="表单ID">
{:token('__form__')}
最后提交按钮
<button type="submit">提交</button>
<button type="reset">重置</button>
</form>
```
如果开启验证码验证,则表单中需添加验证码字段
```
// 验证码字段
<input type="text" name="verify">
// 验证码图片
<img class="codeimg" src="{:captcha_src()}" alt="captcha" onclick="this.src='{:captcha_src()}'" style="width:100%;" />
```
表单ID查看:站点-表单管理
![](https://img.kancloud.cn/7a/67/7a67a8f97be7d69ddad4e1c3ec6d1839_563x492.jpg)
## **表单数据的调用**
标签:`{rg:form 参数名称="参数值"}{/rg:form}`
**参数列表**
|参数(?为可选参数)|默认值|使用示例|解释|
|---|---|---|---|
|formid|**必选参数**|formid="20"|指定调用的表单ID|
|?empty|无相关内容!|empty="暂无留言!"|无结果时提示的文本|
|?where||where="id > 10"|根据条件进行筛选|
|?order|create_time desc|order="create_time asc"|排序规则|
|?key|i|key="y"|循环体内的计数变量,如{$i}从1开始计数|
|?limit|不限|limit="10"|调用数量|
|?site|当前站点ID|site="1"|站点ID|
>[success]童鞋们举栗子了:
```
调用一个表单ID为20的表单数据
<ul>
{rg:form formid="20"}
留言者IP:{$form.user_ip}
回复内容:{$form.reply}
留言时间:{$form.create_time}
留言字段信息:{$form.*} * 为表单自定义字段
{/rg:form}
</ul>
```
>[danger] 如果是登陆用户,还可以调用
```
留言者用户名:{$form.user.username|default="匿名"}
留言者昵称:{$form.user.nickname}
留言者性别:{$form.user.sex}
留言者头像:{$form.user.face}
```