### 方法 下拉聯動控件實例： ```php $selectLink= $formControl->selectLink(); ``` select2配置項： 1. 選擇后,不關閉選項內容 ```php $selectLink->unCloseOnSelect(); ``` 2. 其他配置項設置 ~~~ $selectLink->uiConfig($key, $value); // 示例 1 $selectLink->uiConfig('allowClear', false); // 是否允許清除選中 // 示例 2 $selectLink->uiConfig('width', '120px'); // 控件寬 // 示例 3 $selectLink->uiConfig('selectedInOrder', false); // 多選時,是否按選擇順序排序 // 示例 4 $selectLink->uiConfig('selectedHideOption', false); // 多選時,是否隱藏已選擇過的選項 ~~~ 設置選項： ```php $selectLink->initOptions([ 'yes' => '是', 'no' => '否', ]); ``` 設置分組選項： ```php $selectLink->initOptions([ // 分組名稱 '會員列表' => [ 'A' => '數字1', // 選擇項 'B' => '數字2', 'C' => '數字3', ], '日志列表' => [ 'D' => '日志1', 'E' => '日志2', 'F' => '日志3', ], ]); ``` 設置目標連接: | 參數 | 默認值 | 名稱 | | --- | --- | --- | | field | - | 字段 | | groupField | default | 表單分組 | ```php $selectLink->targetLink($field, $groupField); ``` 設置AJAX路由: > 返回值: ```php // 響應示例1: return $this->asOk('success', [ ['value' => 'D', 'text' => '鄭州市', 'disabled' => true], ['value' => 'E', 'text' => '東莞市'], ['value' => 'F', 'text' => '北京市'], ]); // 響應示例2: return $this->asOk('success', [ '中國' => [ ['value' => 'D', 'text' => '鄭州市', 'disabled' => true], ['value' => 'E', 'text' => '東莞市'], ['value' => 'F', 'text' => '北京市'], ], '美國' => [ ['value' => 'E', 'text' => '東莞市'], ['value' => 'F', 'text' => '北京市'], ], ]); ``` ```php $selectLink->route($route); ``` 連接開始: ```php $selectLink->start(); ``` 連接中: ```php $selectLink->through(); ``` 連接結束: ```php $selectLink->end(); ``` 設置禁用項: ```php $selectLink->disabled([ 'A', 'D', ]); ``` 設置控件標簽： ```php $selectLink->label('下拉選擇'); ``` 設置占位提示： ```php $selectLink->placeholder('請選擇'); ``` 設置默認值： ```php $selectLink->defaultValue('B'); ``` 設置為必填： ```php $selectLink->required(true); ``` 設置注釋文本： ```php $selectLink->comment('這里是一個注釋文本'); ``` 設置柵欄布局 (默認:12`)： ```php $selectLink->layout(6); ``` 設置ui類： ```php $selectLink->uiClass(['f13']); ``` 設置style樣式： ```php $selectLink->style(); ``` 設置html屬性: ```php $selectLink->attribute(); ``` ### 鏈式調用 ~~~ $formBuilder->setFormControl([ 'f' => $this->formControl->selectLink()->label('省')->disabled(['A', 'E'])->initOptions([ '中國' => [ 'A' => '河南省', 'B' => '廣東省', 'C' => '北京市', ], '美國' => [ 'D' => '華盛頓', 'E' => '劍橋', 'F' => '麻省理工', ], ])->targetLink('g')->route('form/link')->start(), 'g' => $this->formControl->selectLink()->label('市')->targetLink('h')->route('form/link')->through(), 'h' => $this->formControl->selectLink()->label('縣(區)')->end(), ]) ~~~ ### 代碼示例 ~~~ /** * @return string * @throws \Throwable */ public function actionIndex() { if ($this->isPost) { return $this->asOk('success', [ 'a' => '1555' ]); } else { $form = FormBuilder::instance([ 'id' => 'formDemo', ]); $form->setTitle('表單構建器') ->setRootLayout([ 'class' => ['col-md-12'] ]) ->setPartial(false) ->setRequiredStyle() ->registerPointcut(H5::alert('我是一個信息提示!')) ->setFormControl([ 'b' => $this->formControl->password()->label('密碼')->placeholder('請填寫密碼')->comment('注:密碼必須包含特殊字符,且大于6位小于22位'), 'i' => $this->formControl->select()->label('觸發器')->options(['a' => '觸發A', 'b' => '觸發B']), 'aa' => $this->formControl->xselect()->label('xselect')->data([ ['name' => 'n1', 'value' => 1], ['name' => 'n2', 'value' => 2], ['name' => 'n3', 'value' => 3], ['name' => 'n4', 'value' => 4], ['name' => 'n5', 'value' => 5], ])->radio()->clickClose(), 'n' => $this->formControl->sw()->label('開關')->checked(), 'trigger1' => $this->formControl->trigger()->when('default', 'i', '!=', 'b')->andWhen('default', 'aa', '==', 3)->triggerItems([ 'j' => $this->formControl->text()->label('觸發器1-1'), 'k' => $this->formControl->text()->label('觸發器1-2'), 'trigger3' => $this->formControl->trigger()->when('default', 'n', '==', '0')->triggerItems([ 'o' => $this->formControl->text()->label('內部觸發器1-1'), 'p' => $this->formControl->text()->label('內部觸發器1-2'), ])->display(), ])->display(), 'trigger2' => $this->formControl->trigger()->when('default', 'i', '==', 'b')->triggerItems([ 'l' => $this->formControl->text()->label('觸發器2-1'), 'm' => $this->formControl->text()->label('觸發器2-2'), ])->display(), 'e' => $this->formControl->select()->label('分組')->multiple()->disabled(['A', 'E'])->options([ '會員列表' => [ 'A' => '數字1', 'B' => '數字2', 'C' => '數字3', ], '日志列表' => [ 'D' => '日志1', 'E' => '日志2', 'F' => '日志3', ], ]), 'f' => $this->formControl->selectLink()->label('省')->disabled(['A', 'E'])->initOptions([ '中國' => [ 'A' => '河南省', 'B' => '廣東省', 'C' => '北京市', ], '美國' => [ 'D' => '華盛頓', 'E' => '劍橋', 'F' => '麻省理工', ], ])->targetLink('g')->route('form/link')->start(), 'g' => $this->formControl->selectLink()->label('市')->targetLink('h')->route('form/link')->through(), 'h' => $this->formControl->selectLink()->label('縣(區)')->end(), ]) ->setSubmitConfirm() ->setExtraBtn([ H5::tag('button', '額外的按鈕', ['class' => ['layui-btn layui-btn-sm layui-btn-gray ym2-form-extra-ui'], 'type' => 'button']), ]) ->setSubmitBtn('確定') ->setResetBtn() ->setExtraJs([ function () { return "console.log('額外的JS')"; }, ]) ->setSubmittedRedirect(function (Modal $modal) { return $modal->route('form/vlink')->title('我是狗')->params(['bbbb' => 1, 'c' => ':a'])->closeBtn()->width(800)->height(800); }) ->registerPointcut(H5::alert('我是一個底部信息提示!', 'info'), FormBuilder::POS_END); return $form->render(); } } ~~~