**addTopButton** 用來在頁面數據列表上面的工具欄位置添加一個按鈕 **方法原型** function addTopButton($type,$attr){} **參數** | 參數 | 參數類型 |是否必須 | 說明 | | --- | --- | --- | --- | | $type| string | 是 | 按鈕類型，主要有add/resume/forbid/recycle/restore/delete/self幾種取值 | | $attr | array |否 | 按鈕屬性，一個定了標題/鏈接/CSS類名等的屬性描述數組，當type為self時需要 | **預定義按鈕** 為了大家使用更加方便，我們事先預定義了幾種經常用到的按鈕 主要有: > add/resume/forbid/recycle/restore/delete 其中resume/forbid/recycle/restore這4種類型有一個使用前提，那就是對應的數據表必須要有一個status字段 **使用示例：** ~~~ // 使用Builder快速建立列表頁面。 $builder = new \Common\Builder\ListBuilder(); $builder->setMetaTitle('文章列表') ->addTopButton('addnew') // 新增按鈕 ->addTopButton('resume') // 啟用按鈕（status從0到-1） ->addTopButton('forbid') // 禁用按鈕（status從1到0） ->addTopButton('recycle') // 回收按鈕（status從1到-1） ->addTopButton('restore') // 恢復按鈕（status從-1到1） ->addTopButton('delete'); // 刪除按鈕（刪了就找不回了） ~~~ **自定義按鈕** 第一原則使用上面的預定義按鈕，如果有特殊需求不能滿足則使用此自定義按鈕方法。 第一步：自定義按鈕時首先需要給函數的第一個參數傳值為self，只有設置了self才表示即將添加一個自定義按鈕 第二步：定義一個數組類似array('title'=>'按鈕名稱', href='按鈕鏈接', 'class'=>'按鈕CSS類名')，然后把數組傳給此函數的第二個參數 **示例：** ~~~ $attr['title'] = '新增'; $attr['class'] = 'btn btn-primary'; $attr['href'] = U('Admin/Article/add'); // 使用Builder快速建立列表頁面。 $builder = new \Common\Builder\ListBuilder(); $builder->setMetaTitle('文章列表') ->addTopButton('self', $attr); ~~~ > 細心的人可能會發現->addTopButton('self', $attr)其實作用跟->addTopButton('add')是一樣的作用，只不過后者是預定義好的，比前者使用方便。