## 方法原型： ``` addCascader($name = '', $title = '', $options = [], $tips = '', $default = '', $attr = []) ``` ## 參數說明： ``` * @param string $name 字段名及是否必填 格式: name:require 或 name * @param string $title 標題及占位符 格式: title|placeholder，無豎線分隔則為標題 * @param array $options 默認格式為: [{id,name,disabled,children},] , id與name為必須項，可通過attr中的props指定各個字段的鍵名 * @param string $tips 提示文字 * @param string $default 默認值 * @param array $attr 組件屬性 { * show_all_levels: 是否展示所有層級，默認為true * select_all_levels: 是否可選擇所有層級，默認為false * props: options的屬性名定義 { * value: options中value的鍵名，默認為id, * label: options中label的鍵名，默認為name， * disabled: options中disabled的鍵名，默認為disabled, * children： options中children的鍵名，默認為children, * } * } ``` #### props參數說明 `addCascader`中第三個方法需要是一個樹形結構，默認每個元素中包含 `id`, `name`, `disabled` 與 `children`參數，其中`id`與`name`為必須的參數，如果傳入的結構不符合默認結構，需要在`props`中指定各個鍵名。 ## 調用方式 - ``` return SBuilder::make('form') ->addCascader('pid', '所屬權限|頂級權限', [ ['id' => 1, 'name' => '權限', 'pid' => 0, 'children' => [ ['id' => 2, 'name' => '列表', 'pid' => 1], ['id' => 3, 'name' => '禁用的選項', 'pid' => 1, 'disabled' => true] ]], '', '', [ 'select_all_levels' => true, ] ]) ->fetch(); ``` > 頁面效果：