## addComplexTable('name值', '标题', '表格数据'[, '是否有表头'])
标识符:`complexTable`
在表单中显示普通表格,用于展示数据,不可编辑。
```
$table_data = [
['姓名', '性别', '年龄'],
['张三', '男', '45'],
['李四', '男', '40'],
];
return ZBuilder::make('form')
->setPageTitle('新增') // 设置页面标题
->addFormItems([ // 批量添加表单项
['complexTable', 'list_user', '客户列表', $table_data]
])
->fetch();
```
效果:
![](https://img.kancloud.cn/d3/47/d34706c8b2a5633f6e393315fb9e74df_1027x188.png)
### 设置第一行为表头
```
$table_data = [
['姓名', '性别', '年龄'],
['张三', '男', '45'],
['李四', '男', '40'],
];
return ZBuilder::make('form')
->setPageTitle('新增') // 设置页面标题
->addFormItems([ // 批量添加表单项
['complexTable', 'list_user', '客户列表', $table_data, true]
])
->fetch();
```
效果:
![](https://img.kancloud.cn/1d/ae/1daedc217e5f0b0a15b7893cbb881b18_1017x182.png)
### 单独设置表头
```
$table_head = [
['姓名', '性别', '年龄']
];
$table_data = [
['张三', '男', '45'],
['李四', '男', '40'],
];
return ZBuilder::make('form')
->setPageTitle('新增') // 设置页面标题
->addFormItems([ // 批量添加表单项
['complexTable', 'list_user', '客户列表', $table_data, $table_head]
])
->fetch();
```
效果:
![](https://img.kancloud.cn/07/04/0704d169ddf63ecef74ab42967e00a28_1016x184.png)
### 单元格合并
在需要合并的单元格,设置横向和纵向合并数量,格式:单元格值[横向数:纵向数]
```
$table_data = [
['姓名[2]', '年龄'], // 姓名横向合并2个单元格,纵向默认1个
['张三', '男', '45'],
['李四', '男', '40'],
];
return ZBuilder::make('form')
->setPageTitle('新增') // 设置页面标题
->addFormItems([ // 批量添加表单项
['complexTable', 'list_user', '客户列表', $table_data, true]
])
->fetch();
```
效果:
![](https://img.kancloud.cn/16/2f/162f9c07ad1850a902db75e8189013e7_1020x187.png)
单独设置的表头也支持单元格合并
```
$table_head = [
['姓名[2]', '年龄'], // 姓名横向合并2个单元格,纵向默认1个
];
$table_data = [
['张三', '男', '45'],
['李四', '男', '40'],
];
return ZBuilder::make('form')
->setPageTitle('新增') // 设置页面标题
->addFormItems([ // 批量添加表单项
['complexTable', 'list_user', '客户列表', $table_data, $table_head]
])
->fetch();
```
纵向合并
```
$table_head = [
['姓名[2]', '年龄'], // 姓名横向合并2个单元格,纵向默认1个
];
$table_data = [
['张三', '男[1:2]', '45'],
['李四', '40'],
];
return ZBuilder::make('form')
->setPageTitle('新增') // 设置页面标题
->addFormItems([ // 批量添加表单项
['complexTable', 'list_user', '客户列表', $table_data, $table_head]
])
->fetch();
```
效果:
![](https://img.kancloud.cn/c2/40/c240773258aed5ef5ba27eb1568da2b5_1024x188.png)
比较复杂的表格
```
$table_data = [
['姓名[:2]', '张三[:2]', '性别', '男', '专业技术职务', '测试', '第一学历', '测试'],
['出生年月', '2019-01-01', '行政职务', '测试', '最后学历', '测试'],
['第一学历和最后学历<br>业时间、学校、专业[2]', '测试[6]'],
['主要从事工作与<br>研究方向[2]', '测试[6]'],
['行业企业兼职[2]', '测试[6]'],
['工作简历[2]', '测试[6]'],
['最具代表性的<br>教学科研成果[2]', '测试[6]'],
['目前承担的主要<br>教学工作(5项以内)[2]', '测试[6]'],
];
return ZBuilder::make('form')
->setPageTitle('新增') // 设置页面标题
->addFormItems([ // 批量添加表单项
['complexTable', 'list_user', '客户列表', $table_data, true]
])
->fetch();
```
![](https://img.kancloud.cn/3a/c3/3ac30dbe4d0032bb192a6ecd8790f3e9_1021x481.png)
>[danger] 注意,在设置单元格合并参数的时候,一定要弄清楚各个单元格占用的格数。
正常的表格是这样的
```
$table_data = [
['张三', '男', '45'],
['李四', '男', '40'],
];
```
如果想把性别“男”合并起来,那么在设置第一行张三的“男[1:2]”后,后一行的"男"就需要去掉,如:
```
$table_data = [
['张三', '男[1:2]', '45'],
['李四', '40'],
];
```
否则会合并不正确。
另外,下面两种设置方式是一样的:
```
$table_data = [
['张三', '男[1:2]', '45'],
];
$table_data = [
['张三', '男[:2]', '45'],
];
```
也就是说,如果是数字1,可以不写,下面两种也是一样的:
```
$table_data = [
['张三', '男[2]', '45'],
];
$table_data = [
['张三', '男[2:1]', '45'],
];
```
其他复杂的单元格合并方式要靠自己去摸索了。
### 单元格内显示表格
```
$table_inside = [
['序号', '成果名称', '等级及签发单位、时间', '本人署名位次'],
['1', 'a1', '2019-01-01', '1'],
['2', 'a2', '2019-01-01', '2'],
['3', 'a2', '2019-01-01', '3'],
'6:1' // 最后一个为字符串,用来设置所在单元格的合并,如果不需要合并则无需填写。
];
$table_data = [
['姓名[:2]', '张三[:2]', '性别', '男', '专业技术职务', '测试', '第一学历', '测试'],
['出生年月', '2019-01-01', '行政职务', '测试', '最后学历', '测试'],
['第一学历和最后学历<br>业时间、学校、专业[2]', '测试[6]'],
['主要从事工作与<br>研究方向[2]', '测试[6]'],
['行业企业兼职[2]', '测试[6]'],
['工作简历[2]', '测试[6]'],
['最具代表性的<br>教学科研成果[2]', $table_inside],
['目前承担的主要<br>教学工作(5项以内)[2]', '测试[6]'],
];
return ZBuilder::make('form')
->setPageTitle('新增') // 设置页面标题
->addFormItems([ // 批量添加表单项
['complexTable', 'list_user', '客户列表', $table_data, true]
])
->fetch();
```
效果:
![](https://img.kancloud.cn/32/61/32614158caf90a03e4934ec97392edc2_1021x607.png)
- 序言
- 环境搭建
- 下载及安装
- 目录结构
- 快速构建器(ZBuilder)
- 表单(form)
- 设置页面标题
- 设置页提示信息
- 设置表单提交地址
- 隐藏按钮
- 添加按钮
- 设置按钮标题
- 添加表单项
- 复选
- 单选
- 日期
- 时间
- 开关
- 标签
- 数组
- 分组
- 范围
- 按钮
- 数字框
- 密码框
- 取色器
- 下拉菜单
- 普通联动
- 快速联动
- 拖拽排序
- 静态文本
- 格式文本
- 日期时间
- 日期范围
- 图片裁剪
- 百度地图
- 单文件上传
- 多文件上传
- 单图片上传
- 多图片上传
- 隐藏表单项
- 图标选择器
- 单行文本框
- 多行文本框
- 百度编辑器
- CKEditor编辑器
- wang编辑器
- markdown编辑器
- summernote编辑器
- 图片展示(1.1.0+)
- 单文件展示(1.1.0+)
- 多文件展示(1.1.0+)
- 下拉菜单Ajax(1.3.3+)
- 复杂表格(1.4.3+)
- 数据表格(1.4.3+)
- 分组下拉菜单(1.4.3+)
- 表格选取(1.4.3+)
- 穿梭框(1.4.3+)
- 添加表单项通用方法
- 直接设置表单项
- 表单布局
- 设置Tab按钮列表
- 设置表单数据
- 引入js文件
- 引入css文件
- 设置额外JS代码
- 设置额外CSS样式
- 设置额外HTML代码
- 是否ajax方式提交
- 设置模版路径
- 设置触发器
- 设置表单提交确认框
- 自定义表单项(1.0.6+)
- 设置表单提交方式(1.0.6+)
- 模板变量赋值(1.0.7+)
- 设置页面空表单项提示(1.0.7+)
- 自定义扩展表单图标(1.2.0+)
- 设置表单令牌(1.3.1+)
- 新窗口打开返回的url(1.4.4+)
- 表格(table)
- 设置页面标题
- 设置页面提示信息
- 添加一列
- 字段类型
- switch
- status
- yesno
- text.edit
- textarea.edit
- password
- url
- tel
- number
- icon
- byte
- date
- time
- datetime
- date.edit
- time.edit
- datetime.edit
- picture
- pictures
- select
- callback
- link
- text
- img_url
- files(1.1.1+)
- popover(1.4.4+)
- 添加多列
- 添加数量索引
- 添加快捷编辑的验证器
- 设置表格数据
- 隐藏第一列多选框
- 添加表头排序
- 添加表头筛选
- 添加表头筛选条件
- 添加时间段筛选
- 添加一个右侧按钮
- 添加多个右侧按钮
- 添加一个顶部按钮
- 添加多个顶部按钮
- 自动添加按钮
- 自动编辑按钮
- 替换右侧按钮
- 设置搜索参数
- 设置数据库表名
- 设置插件名称
- 设置表格主键
- 设置Tab按钮列表
- 设置分页
- 去除分页
- 引入js文件
- 引入css文件
- 设置额外JS代码
- 设置额外CSS样式
- 设置额外HTML代码
- 设置额外HTML代码-模板文件(1.4.0+)
- 设置模版路径
- 添加行class名
- 添加顶部下拉筛选
- 设置页面空数据提示(1.0.7+)
- 模板变量赋值(1.0.7+)
- 设置使用原始数据字段(1.0.8+)
- 设置搜索区域(1.1.0+)
- 设置表格高度(1.3.0+)
- 固定左列(1.3.0+)
- 固定右列(1.3.0+)
- 设置列宽(1.3.0+)
- 设置隐藏列(1.3.0+)
- 侧栏(aside)
- 添加区块
- 设置Tab按钮列表
- 追加Tab按钮列表
- 设置当前tab
- 设置单个tab内容
- 设置多个tab内容
- 追加tab内容
- 覆盖侧栏
- 模块开发
- 创建模块信息文件
- 安装模块
- 模块配置
- 控制器
- 创建菜单节点
- 第一个控制器
- 模块参数配置页面
- 方法参考
- 数据授权(1.3.2+)
- 插件开发
- 插件入口文件
- 插件基本信息
- 管理界面的字段信息
- 新增或编辑的字段信息
- 插件钩子
- 触发器
- 原数据库表前缀
- 插件配置信息
- 安装和卸载Sql文件
- 控制器
- 模型
- 验证器
- 视图
- 方法参考
- 实践教程
- 变量参考
- 函数参考
- 安全相关
- 常见问题
- 其他杂项
- 更新日志
- 升级指导
- 贡献名单
- 关于文档