## 列表Builder構建器 ### 說明 列表構建器整合Bootstrap-table實現快速構建一個列表頁面 ### 用法 例： ``` // 獲取所有用戶 $condition =[ 'status'=> ['egt', '0'], // 禁用和正常狀態 ]; /** *$condition查詢條件支持閉包查詢 */ list($data_list,$total) = model('common/User') ->search('username|nickname')//搜索 ->getListByPage($condition,true,'create_time desc',12); $reset_password = [ 'icon'=> 'fa fa-recycle', 'title'=>'重置原始密碼', 'class'=>'btn btn-default ajax-table-btn confirm btn-sm', 'confirm-info'=>'該操作會重置用戶密碼為123456，請謹慎操作', 'href'=>url('resetPassword') ]; return builder('List') ->setMetaTitle('用戶管理') // 設置頁面標題 ->addTopButton('addnew') // 添加新增按鈕 ->addTopButton('delete') // 添加刪除按鈕 ->addTopButton('self',$reset_password) // 添加重置按鈕 ->setSearch('custom','請輸入關鍵字')//自定義搜索框 ->keyListItem('uid', 'UID') ->keyListItem('avatar', '頭像', 'avatar') ->keyListItem('nickname', '昵稱') ->keyListItem('username', '用戶名') ->keyListItem('email', '郵箱') ->keyListItem('mobile', '手機號') ->keyListItem('reg_time', '注冊時間') ->keyListItem('allow_admin', '允許進入后臺','status') ->keyListItem('status', '狀態', 'array',[0=>'禁用',1=>'正常',2=>'待驗證']) ->keyListItem('right_button', '操作', 'btn') ->setListPrimaryKey('uid')//設置主鍵uid（默認id） ->setExtraHtml($extra_html)//自定義html ->setListData($data_list) // 數據列表 ->setListPage($total,12) // 數據列表分頁 ->addRightButton('edit') //添加編輯按鈕 ->addRightButton('delete') // 添加編輯按鈕 ->fetch(); ``` ### 效果圖  ### 講解： 從上面的代碼示例中體現構建器List的使用要點: 1.模型的數據查詢，包含返回數據總量。 ~~~ list($data_list,$total) = model('common/User')->search('username|nickname')->getListByPage($map,true,'create_time desc',12); ~~~ 2.自定義頭部操作按鈕。 ~~~ $reset_password = [ 'icon'=> 'fa fa-recycle', 'title'=>'重置原始密碼', 'class'=>'btn btn-default ajax-table-btn confirm btn-sm', 'confirm-info'=>'該操作會重置用戶密碼為123456，請謹慎操作', 'href'=>url('resetPassword') ]; ->addTopButton('self',$reset_password) // 添加重置按鈕 ~~~ 3.添加列表項 ~~~ ->keyListItem('username', '用戶名') ~~~ 4.設置列表主鍵，批量操作會用到 ~~~ ->setListPrimaryKey('uid') //設置主鍵uid（默認id） ~~~ 5.列表數據賦值 ~~~ ->setListData($data_list) // 數據列表 ~~~ 6.設置列表分頁。 ~~~ ->setListPage($total,12) // 數據列表分頁 ~~~ >[info] 注意：分頁方法的第二個參數是設置每頁的數據行數，要和數據查詢的設置相同 7.添加列項按鈕 ~~~ ->addRightButton('edit') ~~~