[TOC] # [**表單構建器**](http://www.hmoore.net/ruoshuiyx/siyucms/1175202) 構建表單時我們有時候會向斗個表單添加額外的信息比如屬性或者類等 ``` $model = '\app\common\model\\' . $this->modelName; $info = $model::edit($id)->toArray();//獲得由字段名為鍵字段值為值組成的一維數組 // 獲取【添加頁面】可展示的字段信息 $columns = MakeBuilder::getAddColumns($this->tableName, $info); //然后遍歷出每個字段進行操作 /** //通用去掉的字段 protected $ty_field=[ 'status', 'sort', 'create_time', 'update_time' ]; **/ foreach ($columns as $key=>&$v){ //通用去掉的字段 if( in_array($v[1],$this->ty_field)){ unset($columns[$key]); } /*排除某個下拉框*/ if(isset($v[6]) && $v[1] !='open_tenders_result'){ //存在下標6且 //多行文本框textarea、標簽tag、密碼框password、單圖片上傳image、多圖片上傳images、單文件上傳file、多文件上傳files、取色器color 為5 //數字輸入框number、多級聯動linkage 8 //隱藏表單項hidden 3 if($v[0]=='textarea'){ $v[5] = $v[5]==''?'readonly = "readonly"':''; }else{ $v[6] = $v[6]=='' ?' readonly = "readonly" ':''; } } //向表單添加只讀屬性 switch ($v[0]) { //額外屬性在$v[3] case 'hidden': case 'button': # code... break; //額外屬性在$v[5] case 'textarea': case 'tag': case 'password': case 'image': case 'images': case 'file': case 'files': case 'color': $v[5] = $v[5]==''?'readonly = "readonly"':''; break; //額外屬性在$v[6] case 'text': case 'radio': case 'checkbox': case 'date': case 'time': case 'datetime': case 'daterange': case 'select': case 'select2': case 'editor': $v[6] = $v[6]=='' ?' readonly = "readonly" ':''; break; //額外屬性在$v[8] case 'number': case 'linkage': $v8] = $v[8]=='' ?' readonly = "readonly" ':''; break; default: # code... break; } } ``` ## **單行文本** addText($name = '', $title = '', $tips = '', $default = '', $group = [], $extra_attr = '', $extra_class = '', $placeholder = '', $required = false) | 參數 | 含義 | 類型 | 必填 | | --- | --- | --- | --- | | name | 字段名稱（英文） | string | 是 | | title | 字段別名（中文） | string | 是 | | tips | 提示信息 | string | 否 | | default | 默認值 | string | 否 | | group | 標簽組 | array | 否 | | extra\_attr | 額外屬性 | string | 否 | | extra\_class | 額外css類 | string | 否 | | placeholder | 占位符 | string | 否 | | required | 是否必填 | bool | 否 | ``` ->addText( 'signName', '簽名名稱', '<a href="https://help.aliyun.com/document_detail/108072.html" target="_blank">【簽名簡介】</a><a href="https://dysms.console.aliyun.com/dysms.htm#/domestic/text/sign" target="_blank">【查看簽名】</a>' ) ```  ## **tab頁由字段分組決定** 新建模型【單頁測試】單頁模式選項改選為【是】，然后在【字段分組】頁面添加將屬于【單頁測試】模塊的分組1和分組2 然后在【字段管理】頁添加兩個字段name、title，在【所屬分組】項分別將兩個字段放入的分組1和分組2  ## **fetch** FormBuilder::fetch() 分配變量和渲染模板 ``` View::assign($this->_vars); return View::fetch($this->_template); ``` ## **多行文本** addTextarea($name = '', $title = '', $tips = '', $default = '', $extra_attr = '', $extra_class = '', $placeholder = '', $required = false, $rows = 3) | 參數 | 含義 | 類型 | 必填 | 版本 | | --- | --- | --- | --- | --- | | name | 字段名稱（英文） | string | 是 | | | title | 字段別名（中文） | string | 是 | | | tips | 提示信息 | string | 否 | | | default | 默認值 | string | 否 | | | extra\_attr | 額外屬性 | string | 否 | | | extra\_class | 額外css類 | string | 否 | | | placeholder | 占位符 | string | 否 | | | required | 是否必填 | bool | 否 | | | rows | 高度（行數） | string | 否 | V6.1.6 | 多行文本框一般只需要兩個參數（name, title），其他項目均為選填項。 ## addDate 等時間組件都是[daterangepicker](www.daterangepicker.cn)封裝出來的 ~~~ return FormBuilder::getInstance() ->addTextarea('remarks', '備注') ~~~  ``` /** * 獲取句柄 * @return FormBuilder */ public static function getInstance() { if (is_null(self::$instance)) { self::$instance = new self(); } return self::$instance; } /** * 渲染模版 * @param string $template 模板文件名或者內容 * @return string * @throws \Exception */ public function fetch(string $template = '') /** * 設置頁面標題 * @param string $title 頁面標題 * @return $this */ public function setPageTitle(string $title = '') /** * 設置表單頁提示信息 * @param string $tips 提示信息 * @param string $type 提示類型：danger,info,warning,success * @param string $pos 提示位置：top,search,bottom * @return $this */ public function setPageTips(string $tips = '', string $type = 'info', string $pos = 'top') /** * 隱藏<顯示全部>按鈕 * @param string $url 鏈接地址 * @return $this */ public function hideShowAll() /** * 設置表單提交地址 * @param string $form_url 提交地址 * @return $this */ public function setFormUrl(string $form_url = '') /** * 設置表單提交方式 * @param string $value 提交方式 * @return $this */ public function setFormMethod(string $value = '') /** * 模板變量賦值 * @param mixed $name 要顯示的模板變量 * @param string $value 變量的值 * @return $this */ public function assign($name, $value = '') /** * 隱藏按鈕 * @param array|string $btn 要隱藏的按鈕，如：['submit']，其中'submit'->確認按鈕，'back'->返回按鈕 * @return $this */ public function hideBtn($btn = []) /** * 設置按鈕標題 * @param string|array $btn 按鈕名 'submit' -> “提交”，'back' -> “返回” * @param string $title 按鈕標題 * @return $this */ public function setBtnTitle($btn = '', string $title = '') /** * 添加額外按鈕 * @param string $btn 按鈕內容 * @return $this */ public function addBtn(string $btn = '') /** * 設置額外HTML代碼 * @param string $extra_html 額外HTML代碼 * @param string $pos 位置 [top和bottom] * @return $this */ public function setExtraHtml(string $extra_html = '', string $pos = '') /** * 設置額外JS代碼 * @param string $extra_js 額外JS代碼 * @return $this */ public function setExtraJs(string $extra_js = '') /** * 設置額外CSS代碼 * @param string $extra_css 額外CSS代碼 * @return $this */ public function setExtraCss(string $extra_css = '') /** * 設置提交表單時顯示確認框 * @return $this */ public function submitConfirm() /** * 添加單行文本框 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param array $group 標簽組，可以在文本框前后添加按鈕或者文字 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param string $placeholder 占位符 * @param bool $required 是否必填 * @return $this|array */ public function addText($name = '', $title = '', $tips = '', $default = '', $group = [], $extra_attr = '', $extra_class = '', $placeholder = '', $required = false) /** * 添加多行文本框 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param string $placeholder 占位符 * @param bool $required 是否必填 * @param int $rows 高度（以行數計） * @return $this|array */ public function addTextarea($name = '', $title = '', $tips = '', $default = '', $extra_attr = '', $extra_class = '', $placeholder = '', $required = false, $rows = 3) /** * 添加單選 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param array $options 單選數據 * @param string $default 默認值 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param bool $required 是否必選 * @return $this|array */ public function addRadio($name = '', $title = '', $tips = '', $options = [], $default = '', $extra_attr = '', $extra_class = '', $required = false) /** * 添加復選框 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param array $options 復選框數據 * @param string $default 默認值 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param bool $required 是否必選 * @return $this|array */ public function addCheckbox($name = '', $title = '', $tips = '', $options = [], $default = '', $extra_attr = '', $extra_class = '', $required = false) /** * 添加日期 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param string $format 日期格式 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param string $placeholder 占位符 * @param bool $required 是否必填 * @return $this|array */ public function addDate($name = '', $title = '', $tips = '', $default = '', $format = '', $extra_attr = '', $extra_class = '', $placeholder = '', $required = false) /** * 添加時間 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param string $format 時間格式 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param string $placeholder 占位符 * @param bool $required 是否必填 * @return $this|array */ public function addTime($name = '', $title = '', $tips = '', $default = '', $format = '', $extra_attr = '', $extra_class = '', $placeholder = '', $required = false) /** * 添加日期時間 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param string $format 日期格式 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param string $placeholder 占位符 * @param bool $required 是否必填 * @return $this|array */ public function addDatetime($name = '', $title = '', $tips = '', $default = '', $format = '', $extra_attr = '', $extra_class = '', $placeholder = '', $required = false) /** * 添加日期范圍 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param string $format 日期格式 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param bool $required 是否必填 * @return $this|array */ public function addDaterange($name = '', $title = '', $tips = '', $default = '', $format = '', $extra_attr = '', $extra_class = '', $required = false) /** * 添加標簽 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param bool $required 是否必填 * @return $this|array */ public function addTag($name = '', $title = '', $tips = '', $default = '', $extra_attr = '', $extra_class = '', $required = false) /** * 添加數字輸入框 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param string $min 最小值 * @param string $max 最大值 * @param string $step 步進值 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類 * @param bool $required 是否必填 * @return $this|array */ public function addNumber($name = '', $title = '', $tips = '', $default = '', $min = '', $max = '', $step = '', $extra_attr = '', $extra_class = '', $required = false) /** * 添加密碼框 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類 * @param string $placeholder 占位符 * @param bool $required 是否必填 * @return $this|array */ public function addPassword($name = '', $title = '', $tips = '', $default = '', $extra_attr = '', $extra_class = '', $placeholder = '', $required = false) /** * 添加普通下拉菜單 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param array $options 選項 * @param string $default 默認值 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類 * @param string $placeholder 占位符 * @param bool $required 是否必選 * @return $this|array */ public function addSelect($name = '', $title = '', $tips = '', $options = [], $default = '', $extra_attr = '', $extra_class = '', $placeholder = '', $required = false) /** * 添加下拉菜單select2 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param array $options 選項 * @param string $default 默認值 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類 * @param string $placeholder 占位符 * @param bool $required 是否必填 * @param string $ajax_url ajax 地址(傳遞時無需再傳遞選項值) * @return $this|array */ public function addSelect2($name = '', $title = '', $tips = '', $options = [], $default = '', $extra_attr = '', $extra_class = '', $placeholder = '', $required = false, $ajax_url = '') /** * 添加單圖片上傳 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param string $placeholder 占位符 * @param bool $required 是否必填 * @return $this|array */ public function addImage($name = '', $title = '', $tips = '', $default = '', $extra_attr = '', $extra_class = '', $placeholder = '', $required = false) /** * 添加多圖片上傳 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param string $placeholder 占位符 * @param bool $required 是否必填 * @return $this|array */ public function addImages($name = '', $title = '', $tips = '', $default = '', $extra_attr = '', $extra_class = '', $placeholder = '', $required = false) /** * 添加單文件上傳 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param string $placeholder 占位符 * @param bool $required 是否必填 * @return $this|array */ public function addFile($name = '', $title = '', $tips = '', $default = '', $extra_attr = '', $extra_class = '', $placeholder = '', $required = false) /** * 添加多文件上傳 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param string $placeholder 占位符 * @param bool $required 是否必填 * @return $this|array */ public function addFiles($name = '', $title = '', $tips = '', $default = '', $extra_attr = '', $extra_class = '', $placeholder = '', $required = false) /** * 添加編輯器 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param string $height 高度 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param bool $required 是否必填 * @return $this|array */ public function addEditor($name = '', $title = '', $tips = '', $default = '', $height = '', $extra_attr = '', $extra_class = '', $required = false) /** * 添加按鈕 * @param string $name 按鈕名稱(id) * @param string $title 字段別名 * @param array $attr 按鈕屬性 * @param string $elemtype 按鈕類型，默認為button，也可以為a標簽 * @return $this|array */ public function addButton($name = '', $title = '', $attr = [], $elemtype = 'button') /** * 添加隱藏表單項 * @param string $name 字段名稱 * @param string $default 默認值 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @return $this|array */ public function addHidden($name = '', $default = '', $extra_attr = '', $extra_class = '') /** * 添加取色器 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param string $placeholder 占位符 * @param bool $required 是否必填 * @return $this|array */ public function addColor($name = '', $title = '', $tips = '', $default = '', $extra_attr = '', $extra_class = '', $placeholder = '', $required = false) /** * 添加代碼編輯器 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $default 默認值 * @param string $height 高度 * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類名 * @param string $placeholder 占位符 * @param bool $required 是否必填 * @param string $mode 編程語言（htmlmixed/javascript/css） * @param string $theme 主題 * @return $this|array */ public function addCode($name = '', $title = '', $tips = '', $default = '', $height = '', $extra_attr = '', $extra_class = '', $required = false, $mode = 'htmlmixed', $theme = 'monokai') /** * 添加自定義Html * @param string $html html代碼 * @return $this|array */ public function addHtml($html = '') /** * 添加多級聯動 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $tips 提示信息 * @param string $model 模型名稱 * @param string $level 級別 * @param string $default 默認值 * @param array|string $fields 字段名，默認為id,name,pid * @param string $extra_attr 額外屬性 * @param string $extra_class 額外css類 * @param string $placeholder 占位符 * @param bool $required 是否必填 * @param string $ajax_url ajax 地址 * @return $this|array */ public function addLinkage($name = '', $title = '', $tips = '', $model = '', $level = 2, $default = '', $fields = [], $extra_attr = '', $extra_class = '', $placeholder = '', $required = false, $ajax_url = '') /** * 添加表單項 [別名方法] * @param string $type 表單項類型 * @param string $name 表單項名，與各自方法中的參數一致 * @return $this */ public function addFormItem($type = '', $name = '') /** * 一次性添加多個表單項 * @param array $items 表單項 * @return $this|array */ public function addFormItems($items = []) /*** * 設置表單項的值 */ private function setFormValue() /** * 添加分組 * @param array $groups 分組數據 * @return mixed */ public function addGroup($groups = []) ```