# 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')是一样的作用，只不过后者是预定义好的，比前者使用方便。