# 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`字段 使用示例： ```php // 使用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類名')，然后把數組傳給此函數的第二個參數 示例： ```php $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')是一樣的作用，只不過后者是預定義好的，比前者使用方便。