## 添加一列
添加表格的列,不管什么类型的字段,都是用通用方法:
```
addColumn($name = '', $title = '', $type = '', $option = '', $default = '', $attr=[])
```
参数说明:
```
* @param string $name 字段名
* @param string $title 标题
* @param string $type 类型, 为空时默认为text类型
* @param string|array $option 选项
* @param string $default 值为空时的默认值
* @param array $attr 其他属性, 如触发器等 {
* trigger: {key: value}, // 用于控制当前列是否显示, value可以是一个数组, 若传了trigger参数, 只有当前行数据中出现在value中时才显示
* fixed: 是否固定列,
* show_tooltip: 是否在长度超出后显示tooltip
* }
```
支持的类型:
1. [文本(text)](./table/text.md)
2. [状态(status)](./table/status.md)
3. [是否(yesno)](./table/yesno.md)
4. [时间(datetime)](./table/datetime.md)
5. [图片(image)](./table/image.md)
6. [图片列表(images)](./table/images.md)
7. [外部图片(external_image)](./table/external_image.md)
8. [外部图片列表(external_images)](./table/external_images.md)
9. [链接(link)](./table/link.md)
10. []()
11. []()
12. [多选框栏](./table/checkbox.md)
13. [数量索引栏](./table/index.md)
14. [操作栏](./table/option.md)
## 批量添加列
```
addColumns($columns = [])
```
> 其中columns参数中每个元素是一个对应添加单列中的参数的数组。
综合操作举例(此处为了方便,使用[addColumns](./table/addColumns.md)方法举例):
```
return SBuilder::make('table')
->addColumns([
['__checkbox__'], // 多选框栏
['__index__'], // 数量索引,默认标题为 #
['name', '名称'], // 文本
['enable', '是否开启', 'yesno'], // 是否
['status', '状态',], // 状态
['avatar', '头像', 'image'], // 图片
['pics', '图片列表', 'images'], // 图片列表
['wx_avatar', '微信头像', 'external_image'], // 外部图片
['ext_pics', '网络图片', 'external_images'], // 外部图片列表
['create_time', '网络图片', 'datetime'], // 显示时间
['__btn__'], // 操作按钮
])
->fetch();
```
- 触发器
可使用触发器控制行数据是否在当前列显示, 如上main的数据中, 若要id为1,2,3才显示`name`:
```
return SBuilder::make('table')
->addColumn('name', '姓名', '', '', '', [
'trigger' => ['id' => [1,2,3]]
])
->fetch();
```
> 注意: 当trigger中存在多个字段的条件时, 判断关系为或的关系,若需要其他复杂关系处理, 请在获取列表逻辑中直接处理。
- 序言
- 下载及安装
- 目录结构
- 基础
- 多站点-单入口文件(推荐)
- (旧)多站点-多入口文件方式
- (旧)入口文件
- (旧)站点配置
- 按钮操作
- 区块概念
- 构建器(SBuilder)
- 页面-Page
- 设置页面标题
- 添加页面提示信息
- 设置页面Tab
- 设置页面背景色
- 设置是否点击遮罩关闭
- 添加区块
- 区块-Block
- 设置区块名
- 设置区块布局
- 表单(form)
- 添加表单项通用方法
- 添加表单项
- 单行文本框
- 多行文本框
- 数字输入框
- 密码框
- 数组输入框
- 单选框
- 状态选择器
- 复选框
- 下拉框
- 级联选择器
- 开关
- 日期选择器
- 日期时间选择器
- 日期范围选择器
- 日期时间范围选择器
- 时间选择器
- 时间范围选择器
- Tree 树形组件
- 图标选择器
- 颜色选择器
- 单图片上传
- 多图片上传
- 视频上传
- 单文件上传
- 多文件上传
- 富文本编辑器-QEditor
- 富文本编辑器-UEditor
- 小程序富文本
- 静态文本
- 隐藏表单项
- 表格数据输入框
- 分组
- 地图选择器(未实现)
- 地区选择器(未实现)
- 穿梭框(未实现)
- 图片裁剪(未实现)
- 邮箱输入框(未实现)
- 设置表单LabelWidth
- 设置表单提交地址
- 设置默认按钮标题
- 提交表单确认框
- 隐藏默认按钮
- 添加额外按钮
- 设置触发器
- 设置表单数据
- 表单布局
- 模板
- 表格(table)
- 设置表名
- 添加顶部按钮
- 添加时间段筛选
- 设置搜索栏
- 添加列
- text
- byte
- status
- tags
- yesno
- datetime
- icon
- image
- images
- external_image[已废弃]
- external_images[已废弃]
- link
- html
- select
- text.edit
- group
- 多选框栏
- 数量索引栏
- 操作栏
- 右侧操作按钮
- 设置多选框
- 设置显示数量索引
- 设置列表数据地址
- 直接设置数据
- 关闭ajax获取数据功能
- 设置分页
- 自动新增
- 自动编辑
- 图表(Charts)
- Html
- Iframe
- 数据面板
- 卡片列表
- 按钮(Button)
- 按钮调用示例
- 自定义组件
- 混合页面
- 概念说明
- 扩展
- 图标扩展
- 杂项
- 帮助函数
- TODO