addLinkages("name值", "标题", "提示", "表名", "级别数量" [, "默认值", "字段名"])

标识符：linkages

快速联动比普通联动多了个“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");

数据表不一定是test，任何表都可以，只要在表中包含三个字段id、name、pid，相信这三个字段在一般有层级关系的数据表中都会有。当然，字段名是可以自定义的。

有了数据表后，就可以使用快速联动了。

return ZBuilder::make("form")
    ->addLinkages("city", "选择所在城市", "", "test")
    ->fetch();

效果：

默认是2级联动，也可以是3级，4级，目前最多支持4级联动，再多好像也没什么必要。

设置为3级联动

return ZBuilder::make("form")
    ->addLinkages("area", "选择所在地区", "", "test", 3)
    ->fetch();

效果;

注意：快速联动只能设置一个name值，也就是说，不管是几级联动，都只保存最后一项的数据。

默认值

可以在设置快速联动时给默认值，比如：

return ZBuilder::make("form")
    ->addLinkages("area", "选择所在地区", "", "test", 3, 8)
    ->fetch();

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();

注意：如果使用字符串重新定义字段名，则必须按顺序定义，默认顺序是id,name,pid，不能定义为title,aid

用数组的方式重新定义字段名，前后顺序可以随意。

return ZBuilder::make("form")
    ->addLinkages("area", "选择所在地区", "", "test", 3, "", ["name" => "title", "id" => "aid"])
    ->fetch();