> #### 自定義表單標簽
> 適用范圍:全站任意地方均可使用
> 標簽作用:用于用戶提交表單和調取表單記錄
#### **1、使用步驟**
1)到后臺”欄目管理>自定義表單“中添加表單
2)對新增的表單添加字段
3)到前臺模板中新增form表單
>問:為什么自定義表單后臺添加字段沒有類型選擇???
>答:表單中字段類型只不過是頁面表現的形式,類型只需在前端模板中根據實際需要編寫對應HTML表單字段類型即可,數據對于后端存儲來說均為文本,SHANKECMF希望給前端開發者最大的開發自由,想什么類型模板說了算,這才是真正的前后端分離,那么SHANKECMF的表單其實給與了最大的靈活性和通用性。
#### **2、提交表單示例**
```
<form action="{shanke:form fcode=*}" method="post">
姓名(單行文本):
<input type="text" name="name" >
性別(單選類型):
<input type="radio" value="男" name="sex" >男
<input type="radio" value="女" name="sex" >女
愛好(多選類型):
<input type="checkbox" value="籃球" name="like[]" >籃球
<input type="checkbox" value="足球" name="like[]" >足球
省份(下拉類型):
<select name="province">
<option value="北京">北京</option>
<option value="上海">上海</option>
</select>
簡介(多行文本):
<textarea name="description" ></textarea>
<button type="submit">提交</button>
</form>
```
表單提交方式為post,表單中提交的字段名稱需要與后臺自定義表單中添加的字段一致,否則會導致提交失敗。
需要特別提醒的是,如果字段為多選類型,那么表單字段名稱需要用中括號,比如選擇愛好:
` <input type="checkbox" value="籃球" name="like[]" >籃球`
` <input type="checkbox" value="足球" name="like[]" >足球`
標簽說明:
> {shanke:form fcode=\*} 為表單接收地址,fcode對應后臺接收表單的編碼
> 注意:此處與留言板的提交地址不可混淆,內置的留言表單使用專用地址{shanke:msgaction},其余自定義表單則按照此處規則定義提交地址。
#### **3、表單記錄列表**
```
{shanke:formlist fcode=* num=*}
<p>姓名:[form:name]</p>
<p>公司:[form:company]</p>
<p>職位:[form:position]</p>
{/shanke:formlist}
```
調取的留言記錄默認執行分頁,使用內容列表的分頁代碼即可.
調取表單的內容的標簽名稱與自定義的表單字段一致。
控制參數:
> fcode=\* 表單編碼,必填,用于控制調取的表單
> num=\* 數量,非必填,用于控制調取的記錄分頁大小
> page=\* 是否分頁1或0,非必填,用于關閉分頁
#### **4、表單記錄列表可用標簽**
[form:n]序號從0開始
[form:i]序號從1開始
[form:date]提交時間
[form:***]自定義的其它字段