## addButton('name值', '按鈕屬性' [, '按鈕類型']) 標識符：`button` | 參數 | 含義 | 類型 | | --- | --- | --- | | name | name值 | string | | attr | 按鈕屬性 | array | | ele_type | 按鈕類型 | string | >[info] 1.0.2版本開始支持 ~~~ // 定義按鈕屬性 $btn = [ 'title' => '自定義按鈕', ]; return ZBuilder::make('form') ->addButton('test', $btn) ->fetch(); ~~~  默認情況下，按鈕為`button`類型，也就是一個普通的按鈕，不帶任何事件，本身會有一個id，也就是上面的`name`參數。 比如上面的按鈕，id默認為`test`，我們可以通過js來給它加事件，做我們想做的事情。 ~~~ $('#test').click(function(){ alert('按鈕被點擊了'); }); ~~~ ### a標簽按鈕 如果有需要，我們可以把按鈕改為a標簽按鈕，并添加按鈕連接。 ~~~ // 定義按鈕屬性 $btn = [ 'title' => '自定義按鈕', 'target' => '_blank', 'href' => url('add') // 此屬性僅用于a標簽按鈕，button按鈕不產生作用 ]; return ZBuilder::make('form') ->addButton('test', $btn, 'a') ->fetch(); ~~~ >[info] 需要注意的是，`target`和`href`屬性僅適用于a標簽按鈕。 ### 添加圖標 ~~~ // 定義按鈕屬性 $btn = [ 'title' => '自定義按鈕', 'icon' => 'fa fa-plus-circle', ]; return ZBuilder::make('form') ->addButton('test', $btn) ->fetch(); ~~~  也可以只用圖標，不顯示按鈕標題。 ~~~ // 定義按鈕屬性 $btn = [ 'icon' => 'fa fa-plus-circle', ]; return ZBuilder::make('form') ->addButton('test', $btn) ->fetch(); ~~~  ### 更改按鈕顏色 可以通過添加class屬性，來改變按鈕顏色。 ~~~ // 定義按鈕屬性 $btn = [ 'title' => '自定義按鈕', 'icon' => 'fa fa-plus-circle', 'class' => 'btn-success', ]; return ZBuilder::make('form') ->addButton('test', $btn) ->fetch(); ~~~  ### 禁用按鈕 如果想默認禁用按鈕，可以添加`disabled`。 ~~~ // 定義按鈕屬性 $btn = [ 'title' => '自定義按鈕', 'icon' => 'fa fa-plus-circle', 'class' => 'btn-success', 'disabled' => '', ]; return ZBuilder::make('form') ->addButton('test', $btn) ->fetch(); ~~~  ### 修改按鈕id 默認情況下，按鈕的id值是name參數的值，如果需要修改按鈕的id，可以直接給id另外賦值。 ~~~ // 定義按鈕屬性 $btn = [ 'title' => '自定義按鈕', 'id' => 'newid', ]; return ZBuilder::make('form') ->addButton('test', $btn) ->fetch(); ~~~ ### 添加自定義屬性 除了一些常規的參數，還可以給按鈕添加一些自定義屬性，但僅限于“data-”開頭。 ~~~ // 定義按鈕屬性 $btn = [ 'title' => '自定義按鈕', 'id' => 'newid', 'data-url' => url('add') ]; return ZBuilder::make('form') ->addButton('test', $btn) ->fetch(); ~~~ ### 添加布局寬度 按鈕也支持設定布局，但只能用`addFormItem`或`addFormItems`方法。 ~~~ // 定義按鈕屬性 $btn = [ 'title' => '自定義按鈕', ]; return ZBuilder::make('form') ->addFormItem('button:4', 'test', $btn) ->fetch(); ~~~