## 工作表表頭(必須)
> 圖片演示:




> 說明:
設置工作表表頭。
方法:`cols($callable)`
* 參數 **callable** (必須),例:
```php
cols(function($sheet){
$cols=[
'name'=>[
"title"=>'中文名',
"default"=>"小王",
"verify"=>"require|chs",
"desc"=>"必填,只能輸入漢字",
],...
];
return $cols;
});
```
> 表頭單項配置:
| key | 類型 | 是否必須 | 說明 |
| --- | --- | --- | --- |
| title | string | 是 | 表頭標題 |
| default | string | 否 | 表頭對應數據列默認值,默認為空字符串 |
| verify| string | 否 | 表頭數據驗證,`|`間隔的驗證規則,通用驗證規則詳見:[通用驗證規則](http://www.hmoore.net/worklz/yunj_admin_universal/2278424) |
| 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
- head_style
- head_script
- 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)
- 下拉搜索(dropdown_search)
- 樹(tree)
- 自定義字段
- 單一字段調用
- 概述
- 示例
- 表格構建器
- 基礎示例
- 初始化
- 鏈式操作
- state
- url
- page
- limit
- limits
- filter
- filterValidate
- toolbar
- defaultToolbar
- import
- cols
- count
- items
- event
- 渲染輸出
- 表頭配置
- 使用說明
- 操作欄(action)
- 時間日期(datetime)
- 單圖(img)
- 多圖(imgs)
- 單文件(file)
- 多文件(files)
- 拖拽排序(drag_sort)
- 顏色呈現(color)
- 地區呈現(area)
- 枚舉(enum)
- 自定義表頭
- JS事件
- 異步事件監聽
- 導入構建器
- 基礎示例
- 初始化
- 鏈式操作
- sheets
- 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_integer
- is_json
- is_datetime
- is_md5_result
- 時間日期
- msectime
- 字符串
- rand_char
- filter_sql
- start_with
- exception_to_str
- JS公共方法庫
- 調用說明
- 數據類型
- varType
- 判斷
- isMobile
- isObj
- isEmptyObj
- isArray
- isEmptyArray
- isString
- isEmptyString
- isBool
- isNumber
- isFloat
- 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
- 附錄
- 升級指導
- 更新日志