## 工作表表头(必须)
> 图片演示:
![](https://img.kancloud.cn/92/91/92916d69d5c6c084a4197d450105ae44_1920x1030.png)
![](https://img.kancloud.cn/66/e1/66e1f3b1bbad4f885fe8ac04bff0c5c8_1916x1032.png)
![](https://img.kancloud.cn/fe/23/fe23f11d916f4892b30317b1e0c64e9f_1920x833.png)
![](https://img.kancloud.cn/21/f2/21f2dc7b24e1155c84c9e36ae53f7750_1920x833.png)
> 说明:
设置工作表表头。
方法:`cols($cols)`
* 参数 **cols** (必须)
* 类型一:callable 闭包,例:
```php
// sheet设置时$sheet为sheet值,其余情况为null
cols(function($sheet){
$cols=[
'name'=>[
"title"=>'中文名',
"default"=>"小王",
"verify"=>"require|chs",
"desc"=>"必填,只能输入汉字",
],...
];
return $cols;
});
```
* 类型二:array,例:
```php
cols([
'name'=>[
"title"=>'中文名',
"default"=>"小王",
"verify"=>"require|chs",
"desc"=>"必填,只能输入汉字",
],...
]);
> 表头单项配置:
| key | 类型 | 是否必须 | 说明 |
| --- | --- | --- | --- |
| title | string | 是 | 表头标题 |
| default | string | 否 | 表头对应数据列默认值,默认为空字符串 |
| verify| string | 否 | 表头数据验证,`|`间隔的验证规则,通用验证规则详见:[通用验证规则](https://www.kancloud.cn/worklz/yunj_admin_tp51/2526405) |
| desc | string | 否 | 描述 |
> 示例:
设置工作表`一年级`、`二年级`、`三年级`、`四年级`的表头字段为:`姓名`、`性别`、`年龄`、`爱好`、`简介`。方法如下:
```php
$builder=YI('demo')
->sheets(["一年级","二年级","三年级","四年级"])
->cols(function($sheet){
$cols=[
'name'=>[
"title"=>'姓名',
"default"=>"小王",
"verify"=>"require|chs",
"desc"=>"必填,只能输入汉字",
],
'sex'=>[
"title"=>'性别',
'default'=>'男',
'verify'=>'require|in:男,女',
"desc"=>"必填,男/女",
],
'age'=>[
"title"=>'年龄',
'default'=>'18',
'verify'=>'require|positiveInteger',
"desc"=>"必填,正整数",
],
'hobby'=>[
"title"=>'爱好',
'default'=>'阅读',
'verify'=>'require|in:写作,阅读',
"desc"=>"必填,写作/阅读",
],
'intro'=>[
"title"=>'简介',
'default'=>'个人简介',
'verify'=>'require',
"desc"=>"必填,如:姓名、曾用名、出生日期、籍贯、出生地、民族、现有文化程度、家庭现住址、现在工作单位和担任的社会职务、有何专业技术职称等基本情况。",
],
];
return $cols;
})
```
- 序言
- 基础
- 安装
- 目录结构
- 配置
- 版本
- 控制器
- 使用说明
- 视图模板
- 使用说明
- 区块重写
- seo
- headStyle
- headScript
- content
- script
- 验证器
- TP验证器
- 使用说明
- 自动处理
- 数据处理
- 前端验证器
- 概述
- 调用示例
- 通用验证规则
- 表单构建器
- 基础示例
- 初始化
- 链式操作
- tab
- url
- field
- fieldValidate
- button
- load
- submit
- 渲染输出
- 字段配置
- 使用说明
- 隐藏域(hidden)
- 文本框(text)
- 文本域(textarea)
- 密码框(password)
- 富文本(editor)
- 文档编辑(markdown)
- 下拉选框(select)
- 单选框(radio)
- 复选框(checkbox)
- 开关(switch)
- 日期(date)
- 时间日期(datetime)
- 年份(year)
- 月份(month)
- 时间(time)
- 单图(img)
- 多图(imgs)
- 单文件(file)
- 多文件(files)
- 取色器(color)
- 地区联动(area)
- 下拉搜索(dropdownSearch)
- 树(tree)
- 自定义字段
- 单一字段调用
- 概述
- 示例
- 表格构建器
- 基础示例
- 初始化
- 链式操作
- state
- url
- page
- limit
- limits
- filter
- filterValidate
- toolbar
- defaultToolbar
- import
- cols
- count
- items
- event
- 渲染输出
- 表头配置
- 使用说明
- 枚举(enum)
- 时间日期(datetime)
- 单图(img)
- 多图(imgs)
- 单文件(file)
- 多文件(files)
- 拖拽排序(dragSort)
- 颜色呈现(color)
- 地区呈现(area)
- 操作栏(action)
- 自定义表头
- JS事件
- 异步事件监听
- 导入构建器
- 基础示例
- 初始化
- 链式操作
- sheet
- cols
- colsValidate
- limit
- tips
- row
- rows
- 渲染输出
- 主题开发
- 实现步骤
- 系统主题
- 注意
- PHP公共方法库
- 配置
- yunj_config
- 构建器
- YF
- YT
- YI
- 重定向
- url_tips
- redirect_tips
- throw_redirect
- 响应输出
- response_msg
- response_json
- success_json
- error_json
- throw_json
- throw_success_json
- throw_error_json
- 数组
- array_eq
- array_in
- array_supp
- array_depth
- array_insert
- array_key_prefix
- 验证
- is_mobile
- is_positive_int
- is_positive_integer
- is_json
- is_datetime
- is_md5_result
- 时间日期
- msectime
- 字符串
- rand_char
- filter_sql
- start_with
- exception_to_str
- 数据加解密
- aes_encrypt
- aes_decrypt
- rsa_encrypt
- rsa_decrypt
- rsa_sign
- rsa_sign_verify
- JS公共方法库
- 调用说明
- 数据类型
- varType
- 判断
- isMobile
- isObj
- isEmptyObj
- isArray
- isEmptyArray
- isString
- isEmptyString
- isBool
- isNumber
- isFloat
- isFunction
- isUndefined
- isJson
- isCsv
- isXls
- isXlsx
- 字符串
- fileExt
- fileNameExt
- currTimestamp
- currDatetime
- timestampFormat
- 对象
- objSupp
- 图片
- previewImg
- url
- url
- urlParam
- urlPushParam
- 页面
- openNewPage
- openTab
- openPopup
- rawPageWin
- redirectTab
- redirectLogin
- isPopupPage
- isTabPage
- currPageId
- close
- closeCurr
- closeAll
- 网络
- request
- 数据加解密
- aesEncrypt
- aesDecrypt
- rsaEncrypt
- rsaDecrypt
- rsaSign
- rsaSignVerify
- 附录
- 升级指导
- 更新日志