除了可以用不同的方法來添加表單項外,SPHP還為大家提供兩個通用方法。
## 添加單個表單項
```
addFormItem($name = '', $title = '', $type = 'text', $tips = '', $default = '', $attr = [])
```
> 為了統一參數用法及盡可能的方便使用,`addFormItem`方法中第三個參數為表單類型,默認為`text`類型。
> 通用方法的參數列表與對應類型表單項方法的參數相同,只是在第三個參數位置添加一個表單類型而已。
>
比如創建一個表單,一般情況下可能這么寫
```
return SBuilder::make('form')
->addText('title', '標題')
->addTextarea('summary', '摘要')
->addImage('avatar', '頭像')
->addImage('pic', '封面')
->addStatus('status', '狀態')
->addFile('files', '附件')
->fetch();
```
也可以用`addFormItem()`方法代替,第三個參數是表單項的類型,其他參數與其對應的類型參數一致。
```
return SBuilder::make('form')
->addFormItem( 'title', '標題')
->addFormItem('summary', '摘要', 'textarea')
->addFormItem('content', '內容', 'editor')
->addFormItem('pic', '封面', 'image')
->addFormItem('status', '狀態', 'status')
->addFormItem('files', '附件', 'file')
->fetch();
```
## 添加多個表單項
```
addFormItems($formItems = [])
```
`addFormItems`用來簡化添加表單項的操作, 將表單項列表通過數組傳入, 比如上面的例子,可以寫成:
```
return ZBuilder::make('form')
->addFormItems([
['title', '標題'],
['summary', '摘要', 'textarea'],
['content', '內容', 'editor'],
['pic', '封面', 'image'],
['status', '狀態', 'status'],
['files', '附件', 'file']
])
->fetch();
```
> 注意:addFormItems的參數是一個數組,每個元素是一個表單項數組。
- 序言
- 下載及安裝
- 目錄結構
- 基礎
- 多站點-單入口文件(推薦)
- (舊)多站點-多入口文件方式
- (舊)入口文件
- (舊)站點配置
- 按鈕操作
- 區塊概念
- 構建器(SBuilder)
- 頁面-Page
- 設置頁面標題
- 添加頁面提示信息
- 設置頁面Tab
- 設置頁面背景色
- 設置是否點擊遮罩關閉
- 添加區塊
- 區塊-Block
- 設置區塊名
- 設置區塊布局
- 表單(form)
- 添加表單項通用方法
- 添加表單項
- 單行文本框
- 多行文本框
- 數字輸入框
- 密碼框
- 數組輸入框
- 單選框
- 狀態選擇器
- 復選框
- 下拉框
- 級聯選擇器
- 開關
- 日期選擇器
- 日期時間選擇器
- 日期范圍選擇器
- 日期時間范圍選擇器
- 時間選擇器
- 時間范圍選擇器
- Tree 樹形組件
- 圖標選擇器
- 顏色選擇器
- 單圖片上傳
- 多圖片上傳
- 視頻上傳
- 單文件上傳
- 多文件上傳
- 富文本編輯器-QEditor
- 富文本編輯器-UEditor
- 小程序富文本
- 靜態文本
- 隱藏表單項
- 表格數據輸入框
- 分組
- 地圖選擇器(未實現)
- 地區選擇器(未實現)
- 穿梭框(未實現)
- 圖片裁剪(未實現)
- 郵箱輸入框(未實現)
- 設置表單LabelWidth
- 設置表單提交地址
- 設置默認按鈕標題
- 提交表單確認框
- 隱藏默認按鈕
- 添加額外按鈕
- 設置觸發器
- 設置表單數據
- 表單布局
- 模板
- 表格(table)
- 設置表名
- 添加頂部按鈕
- 添加時間段篩選
- 設置搜索欄
- 添加列
- text
- byte
- status
- tags
- yesno
- datetime
- icon
- image
- images
- external_image[已廢棄]
- external_images[已廢棄]
- link
- html
- select
- text.edit
- group
- 多選框欄
- 數量索引欄
- 操作欄
- 右側操作按鈕
- 設置多選框
- 設置顯示數量索引
- 設置列表數據地址
- 直接設置數據
- 關閉ajax獲取數據功能
- 設置分頁
- 自動新增
- 自動編輯
- 圖表(Charts)
- Html
- Iframe
- 數據面板
- 卡片列表
- 按鈕(Button)
- 按鈕調用示例
- 自定義組件
- 混合頁面
- 概念說明
- 擴展
- 圖標擴展
- 雜項
- 幫助函數
- TODO