[TOC] ## [**表格構建器** ](http://www.hmoore.net/ruoshuiyx/siyucms/1250577) `TableBuilder::fetch()`默認模板是table_builder/layout即`View::fetch("table_builder/layout")`，模板文件存放在D:\programming\phpstudy_pro\WWW\www.siyucmsdemo.com\view\admin\table_builder >[danger]視圖定位流程： 1、確定模板根目錄的位置 >* 如果在控制器渲染默認模板輸出時用的時跨模塊調用即view:fetch(admin@index/index);則先找到app/模塊/view(view_dir_name配置指定)文件夾下的模板文件，不存在則找到項目根目錄(www.siyucmsdemo.com)下的view(view_dir_name配置指定)文件夾下的模板文件，**跨模板調用時在此確定模板根目錄** >* **沒有跨模板調用時在此確定模板根目錄**沒有跨模塊調用時則直接查找view_path指定的文件夾下的模板文件，下面就是確定view_path >view::fetch()中如果view.php配置文件中配置view_path不存在則檢查app/模塊下是否有view文件夾（<span style="color:blue">/app/admin/view</span>），如果有則設置view_path為此文件夾，否則設置view_path為項目根目錄/模塊名(<span style="color:blue">view/admin/</span>)為view_path的值（由此可知只要一處地方存在模板文件夾則view_path的值都能被設置） <span style="color:blue"></span> > > 2、確定模板根目錄后就是確定模板文件的位置 > 默認是<span style="color:blue">/view/admin/駝峰轉下劃線的控制器名/方法名</span>或者<span style="color:blue">/app/admin/view/駝峰轉下劃線的控制器名/方法名</span> 但此cms渲染時有個默認的table\_builder/layout即TableBuilder::fetch()就是View::fetch("table_builder/layout") 如果想要定位到<span style="color:blue">/view/admin/駝峰轉下劃線的控制器名/方法名</span>則TableBuilder::fetch()方法的參數不能為空 得出：此cms模塊下無模板文件且沒有跨模塊調用，則模板目錄在項目根目錄下的模塊文件夾下 注意當確定模板文件夾的位置后 salesmen\_accounts\_expenditure" string(20) "table\_builder\\layout ``` \app\common\builder\TableBuilder::getInstance() ->setUniqueId('id') ->setPageTitle("this is title") ... ``` ## **fetch** TableBuilder::fetch() 分配變量和渲染模板 ``` View::assign($this->_vars); return View::fetch($this->_template); ``` ## addColumn($name = '字段名稱', $title = '字段別名', $type = '單元格類型', $default = '默認值', $param = '額外參數', $class = 'css類名', $sortable = 'false是否排序') 新增一列 單元格類型：hidden,button,textarea,tag,password,image,images,file,files,color,,,text,radio,checkbox,date,time,datetime,daterange,select,select2,editor,,number,linkage ``` ``` **方法：** ``` /** * 獲取句柄(獲取自身實例) * @return FormBuilder */ public static function getInstance() /** * 渲染模版 * @param string $template 模板文件名或者內容 * @param bool $renderContent 是否渲染內容 * @return string * @throws \Exception */ public function fetch(string $template = '') /** * 設置表格主鍵 * @param string $key 主鍵名稱 * @return $this */ public function setUniqueId($key = '') /** * 設置頁面標題 * @param string $title 頁面標題 * @return $this */ public function setPageTitle($title = '') /** * 設置表單頁提示信息 * @param string $tips 提示信息 * @param string $type 提示類型：danger,info,warning,success * @param string $pos 提示位置：top,search,bottom * @return $this */ public function setPageTips($tips = '', $type = 'info', $pos = 'top') /** * 設置額外JS代碼 * @param string $extra_js 額外JS代碼 * @return $this */ public function setExtraJs($extra_js = '') /** * 設置額外CSS代碼 * @param string $extra_css 額外CSS代碼 * @return $this */ public function setExtraCss($extra_css = '') /** * 設置額外HTML代碼 * @param string $extra_html 額外HTML代碼 * @param string $pos 位置 [top和bottom] * @return $this */ public function setExtraHtml($extra_html = '', $pos = '') /** * 添加一列 * @param string $name 字段名稱 * @param string $title 字段別名 * @param string $type 單元格類型 * @param string $default 默認值 * @param string $param 額外參數 * @param string $class css類名 * @param string $sortable 是否排序 * @return $this */ public function addColumn($name = '', $title = '', $type = '', $default = '', $param = '', $class = '', $sortable = 'false') /** * 一次性添加多列 * @param array $columns 數據列 * @return $this */ public function addColumns($columns = []) /** * 設置是否顯示分頁 * @param string $value 是否顯示分頁 true|false * @return $this */ public function setPagination($value = '') /** * 設置列表樹父ID * @param string $value 字段 * @return $this */ public function setParentIdField($value = '') /** * 設置每頁顯示的行數 * @param string $value 數量 * @return $this */ public function setPageSize($value = '') /** * 隱藏第一列多選框(默認顯示,多選列多用于批量刪除等操作) * @return $this */ public function hideCheckbox() /** * 添加一個右側按鈕 * @param string $type 按鈕類型：edit/delete/default * @param array $attribute 按鈕屬性 * @param array $extra 擴展參數(待用) * @return $this */ public function addRightButton($type = '', $attribute = []) /** * 添加多個右側按鈕 * @param array|string $buttons 按鈕類型 * 例如： * $builder->addRightButtons('edit'); * $builder->addRightButtons('edit,delete'); * $builder->addRightButtons(['edit', 'delete']); * $builder->addRightButtons(['edit' => ['title' => '查看'], 'delete']); * @return $this */ public function addRightButtons($buttons = []) /** * 設置表格URL * @param string $url url地址 * @return $this */ public function setDataUrl($url = '') /** * 設置表格默認的新增地址 * @param string $url url地址 * @return $this */ public function setAddUrl($url = '') /** * 設置表格默認的修改地址 * @param string $url url地址 * @return $this */ public function setEditUrl($url = '') /** * 設置表格默認的刪除地址 * @param string $url url地址 * @return $this */ public function setDelUrl($url = '') /** * 設置表格默認的導出地址 * @param string $url url地址 * @return $this */ public function setExportUrl($url = '') /** * 設置表格默認的更改排序地址 * @param string $url url地址 * @return $this */ public function setSortUrl($url = '') /** * 設置搜索參數 * @param array $items * @return $this * 第一個參數：類型 * 第二個參數：字段名稱 * 第三個參數：字段別名 * 第四個參數：匹配方式（默認為'='，也可以是'<>，>，>=，<，<=，LIKE'等等） * 第五個參數：默認值 * 第六個參數：額外參數（不同類型，用途不同） */ public function setSearch($items = []) /** * 添加一個頂部按鈕[目前只能新窗口打開，暫時不考慮彈出層] * @param string $type 按鈕類型：add/edit/del/export/build/default * @param array $attribute 按鈕屬性 * @return $this */ public function addTopButton($type = '', $attribute = []) /** * 一次性添加多個頂部按鈕 * @param array|string $buttons 按鈕組 * 例如： * addTopButtons('add') * addTopButtons('add, edit, del') * addTopButtons(['add', 'del']) * addTopButtons(['add' => ['title' => '增加'], 'del']) * @return $this */ public function addTopButtons($buttons = []) /** * 設置是否在添加/編輯等頁啟用layer彈層加載 * @param string $value 是否啟用layer true|false * @return $this */ public function setLayerOpen($value = true) ``` 例子 ``` return TableBuilder::getInstance() ->setUniqueId($pk) // 設置主鍵 //添加一列 addColumn('字段名稱', '字段別名(用于在表格每列的標題中顯示)' [, '類型' , '默認值', '額外參數', 'css類名']) //類型 text(默認)、status、yesno、link、image、select //添加多列 addColumns(數組內容) ->addColumns($columns) // 添加列表字段數據 ->setSearch($search) // 添加頭部搜索 ->addColumn('right_button', '操作', 'btn') // 啟用右側操作列（添加一列表格，一邊存放操按鈕 字段名必須是right_button） ->addRightButtons(['edit' => ['title' => '編輯'],'delete','default']) //添加多個右側按鈕 目前支持'edit','delete','default'三種類型 //->addRightButtons('edit','delete','default') //除了數組也可以這樣，推薦數組 ->addRightButtons($module->right_button) // 設置右側操作列 ->addTopButtons($module->top_button) // 設置頂部按鈕組 ->addTopButtons([ 'add' => [//除了add還有edit、del、export、default 'title' => '增加', 'icon' => 'fa fa-lightbulb-o', 'class' => 'btn btn-danger', 'href' => 'http://www.siyucms.com',//通常自定義按鈕需要自定義鏈接地址或`onclick`事件 href和onclick一般選其一 'target' => '_blank', 'onclick' => '' ], 'edit', 'del' ]) ->setAddUrl($addUlr) // 設置【新增】按鈕的地址 默認為該控制器中的add方法 ->setEditUrl(url('update', ['id' => '__id__'])) //設置【修改】按鈕的地址，默認為當前控制器的edit方法，傳遞參數為id,值為主鍵的值。 ->setDelUrl(url('delete', ['id' => '__id__'])) //設置【刪除】按鈕的地址，默認為當前控制器的del方法，傳遞參數為id,值為主鍵的值。 ->setPageTitle('<h1>自定義標題<small>小標題</small></h1><ol class="breadcrumb"><li><a href="/admin"><i class="fa fa-dashboard"></i> 首頁</a></li></ol>') ->setPageTips('這是頁面頂部提示信息', "info","top") //setPageTips('提示信息','提示類型【info、success、danger、warning】', '提示位置【top：默認頂部、search：搜索區域,bottom：底部區域】') 三個位置可同時存在 ->setPageTips('這是頁面搜索區域提示信息', "info","search") ->setPageTips('這是頁面底部提示信息', "info","bottom") ->setDataUrl(Request::baseUrl() . '?getList=1')//設置當前頁面表格的地址，默認 當前地址+?getList=1 ->setExtraJs('<script type="text/javascript">alert("Hello");</script> <script src="add.js"></script> <script src="adds.js"></script>')//額外的js 多次調用會被覆蓋，寫入在.wrapper類div容器底部 ->setExtraCss('<style type="text/css">#top{color:red;}</style> <link rel="stylesheet" href="/static/plugins/AdminLTE/css/my.css">') //額外的css 多次調用會被覆蓋 ->setExtraHtml('<p>這是頁面頭部的一段文字</p>', 'content_top') //頭部和頂部可同時存在一次，同一位置多次調用會被覆蓋 ->setExtraHtml('<p>這是頁面底部的一段文字</p>', 'content_bottom') ->fetch(); ``` ## **setSearch設置搜索的字段** | 參數 | 對應字段 | 含義 | 類型 | 必填 | | --- | --- | --- | --- | --- | | 0 | type | 字段類型 | string | 是 | | 1 | name | 字段名稱（英文） | string | 是 | | 2 | title | 字段別名（中文） | string | 是 | | 3 | option | 匹配方式 | string | 否 | | 4 | default | 默認值 | string | 否 | | 5 | param | 額外參數 | array | 否 | | 6 | data\_source | 數據源 | string | 否 | | 7 | relation\_model | 模型關聯 | string | 否 | | 8 | relation\_field | 關聯字段 | string | 否 | | 9 | field\_id | 字段編號 | string | 否 | ~~~ $searchArr = [ [ 0 => "text",//字段類型 1 => "name",//字段名稱（英文） 2 => "廣告名稱",//字段別名（中文） 3 => "LIKE",//匹配方式 4 => "",//默認值 5 => [],//額外參數 6 => 0,//數據源 7 => "",//模型關聯 8 => "",//關聯字段 9 => 110//字段編號 ], [ "radio",//字段類型 "status",//字段名稱（英文） "狀態", "=", "", [ 1 => "顯示", 0 => "隱藏", ], 1, "", "", 108 ], ]; return TableBuilder::getInstance() ->setSearch($searchArr) ->fetch(); ~~~ ## **按鈕** | 屬性 | 含義 | 示例 | | --- | --- | --- | | title | 標題 | 編輯 | | icon | 字體圖標 | fa fa-edit | | class | css類 | btn btn-flat btn-info btn-xs | | href | 鏈接地址 | url('edit', \['id' => '**id**'\]) | ## 自定義按鈕 除了 編輯和刪除以外，還可以添加自定義按鈕，通常自定義按鈕需配合自定義按鈕屬性來使用，如下是添加一個查看按鈕，自定義按鈕需要`href`屬性，會自動進行跳轉 ~~~ $btn_info = [ 'title' => '查看', 'icon' => 'fa fa-fw fa-info', 'href' => url('info', ['id' => '__id__']) ]; ->addRightButton('info', $btn_info) // 添加額外按鈕 ~~~  你可以傳遞**當前行的任意參數**，只要你想并且有 比如同時傳遞`email`，系統會正則匹配并替換`__id__`和`__email__` ~~~ $btn_info = [ 'title' => '查看', 'icon' => 'fa fa-fw fa-info', 'href' => url('info', ['id' => '__id__','email' => '__email__']) ]; ~~~ ## 執行確認 如果希望給按鈕加上確認框，可以添加`confirm`類名，默認刪除按鍵已增加確認提示 ~~~ $btn_info = [ 'title' => '查看', 'icon' => 'fa fa-fw fa-info', 'class' => 'btn btn-flat btn-default btn-xs confirm', 'href' => url('info', ['id' => '__id__']), ]; ->addRightButton('info', $btn_info) // 添加額外按鈕 ~~~  你可以修改彈出確認里的標題、提示信息及確定和取消字樣 ~~~ $btn_info = [ 'title' => '查看', 'icon' => 'fa fa-fw fa-info', 'class' => 'btn btn-flat btn-default btn-xs confirm', 'href' => url('info', ['id' => '__id__']), 'data-title' => '真的要刪除嗎？', 'data-tips' => '刪除了就無法恢復了', 'data-confirm' => '刪除吧', 'data-cancel' => '再想想' ]; ~~~ ## 自定義按鈕 除了 編輯和刪除以外，還可以添加自定義按鈕，通常自定義按鈕需配合自定義按鈕屬性來使用，如下是添加一個查看按鈕，自定義按鈕需要`href`屬性，會自動進行跳轉 ~~~ $btn_info = [ 'title' => '查看', 'icon' => 'fa fa-fw fa-info', 'href' => url('info', ['id' => '__id__']) ]; ->addRightButton('info', $btn_info) // 添加額外按鈕 ~~~  你可以傳遞**當前行的任意參數**，只要你想并且有 比如同時傳遞`email`，系統會正則匹配并替換`__id__`和`__email__` ~~~ $btn_info = [ 'title' => '查看', 'icon' => 'fa fa-fw fa-info', 'href' => url('info', ['id' => '__id__','email' => '__email__']) ]; ~~~ ## 執行確認模態框 如果希望給按鈕加上確認框，可以添加`confirm`類名，默認刪除按鍵已增加確認提示 ~~~ $btn_info = [ 'title' => '查看', 'icon' => 'fa fa-fw fa-info', 'class' => 'btn btn-flat btn-default btn-xs confirm', 'href' => url('info', ['id' => '__id__']), ]; ->addRightButton('info', $btn_info) // 添加額外按鈕 ~~~  你可以修改彈出確認里的標題、提示信息及確定和取消字樣 ~~~ $btn_info = [ 'title' => '查看', 'icon' => 'fa fa-fw fa-info', 'class' => 'btn btn-flat btn-default btn-xs confirm', 'href' => url('info', ['id' => '__id__']), 'data-title' => '真的要刪除嗎？', 'data-tips' => '刪除了就無法恢復了', 'data-confirm' => '刪除吧', 'data-cancel' => '再想想' ]; ~~~