## addLinkages('name值', '標題', '提示', '表名', '級別數量' [, '默認值', '字段名']) 標識符：`linkages` | 參數 | 含義 | 類型 | | --- | --- | --- | | name | name值 | string | | title | 標題 | string | | tips | 提示 | string | | table | 表名 | string | | level | 級別數量 | string | | default | 默認值 | string | | fields | 字段名 | array/string | 快速聯動比普通聯動多了個“s”，但它可以讓聯動操作更方便快速，它只需要配合數據庫而不用自己編寫返回方法。 ### 依然來個小栗子 首先，我們需要創建一張表，用來讀取聯動數據。 ~~~ CREATE TABLE `dp_test` ( `id` int(11) unsigned NOT NULL AUTO_INCREMENT, `name` varchar(32) NOT NULL, `pid` int(11) NOT NULL, PRIMARY KEY (`id`) ) ENGINE=MyISAM AUTO_INCREMENT=1 DEFAULT CHARSET=utf8; INSERT INTO `dp_test` VALUES ('1', '廣東', '0'); INSERT INTO `dp_test` VALUES ('2', '江西', '0'); INSERT INTO `dp_test` VALUES ('3', '廣州', '1'); INSERT INTO `dp_test` VALUES ('4', '深圳', '1'); INSERT INTO `dp_test` VALUES ('5', '河源', '1'); INSERT INTO `dp_test` VALUES ('6', '贛州', '2'); INSERT INTO `dp_test` VALUES ('7', '白云區', '3'); INSERT INTO `dp_test` VALUES ('8', '越秀區', '3'); INSERT INTO `dp_test` VALUES ('9', '南山區', '4'); INSERT INTO `dp_test` VALUES ('10', '江夏村', '7'); ~~~ >[info] 數據表不一定是test，任何表都可以，只要在表中包含三個字段`id`、`name`、`pid`，相信這三個字段在一般有層級關系的數據表中都會有。當然，字段名是可以自定義的。 有了數據表后，就可以使用快速聯動了。 ~~~ return ZBuilder::make('form') ->addLinkages('city', '選擇所在城市', '', 'test') ->fetch(); ~~~ 效果：  >[info] 默認是2級聯動，也可以是3級，4級，目前最多支持4級聯動，再多好像也沒什么必要。 設置為3級聯動 ~~~ return ZBuilder::make('form') ->addLinkages('area', '選擇所在地區', '', 'test', 3) ->fetch(); ~~~ 效果;  >[danger] 注意：快速聯動只能設置一個name值，也就是說，不管是幾級聯動，都只保存最后一項的數據。 ### 默認值 可以在設置快速聯動時給默認值，比如： ~~~ return ZBuilder::make('form') ->addLinkages('area', '選擇所在地區', '', 'test', 3, 8) ->fetch(); ~~~ >[info] 8是指數據表中“越秀區”的id，它是第三級的數據，如果設置的快速聯動是3級，而默認值是2級的id或4級的數據，則會報錯。 ### 字段名 默認情況下，快速聯動會去尋找表中的三個字段`id`、`name`、`pid`。其中，`id`是指表中的主鍵字段，`name`是下拉菜單顯示的名稱，`pid`是父級id。 如果您的數據表中不是這三個字段名，那么可以修改字段名，比如實際上數據表的主鍵是aid，標題是title，那么就可以這么定義。 ~~~ return ZBuilder::make('form') ->addLinkages('area', '選擇所在地區', '', 'test', 3, '', 'aid,title') ->fetch(); ~~~ >[danger] 注意：如果使用字符串重新定義字段名，則必須按順序定義，默認順序是id,name,pid，不能定義為title,aid 用數組的方式重新定義字段名，前后順序可以隨意。 ~~~ return ZBuilder::make('form') ->addLinkages('area', '選擇所在地區', '', 'test', 3, '', ['name' => 'title', 'id' => 'aid']) ->fetch(); ~~~