开发文档
能力中心
应用市场
WebOffice
开发者后台

新建数据表 ​

JSSDK: v1.1.10+、WebOffice v2.4.1+ 支持

说明 ​

新建数据表到指定位置，Before 和 After 只需要提供一个，另一个填 null 即可

语法 ​

表达式.Add(Before, After,Type,Config)

表达式：Sheets

参数 ​

参数名是否必需类型描述
Before否number/string插入到Before(索引从1开始/数据表名)对应sheet之前
After否number/string插入到After(索引从1开始/数据表名)对应sheet之后
Type是string"xlEtFlexPaperSheet"(说明页面)(暂不支持)、"xlEtDataBaseSheet"（数据表）、"xlDbDashBoardSheet"（仪表盘）
Config否object数据表专属配置，结构：Config:{ fields : Field[] , name ?: string , views ?: View[] }；

参数Config属性详解 ​

属性名是否必需类型描述
fields否Field[]字段数组，Field类型结构：{fieldType: FieldType,args: { fieldName: string, fieldWidth: number, listItems?: { value: string, color: number}[], numberFormat?: string, maxRating?: number } }
name否string数据表名,默认为‘data1’
views否View[]视图配置数组，View结构：{name: string,type: ViewType}，ViewType的取值为：'Grid'（网格视图）、'Kanban'（看板视图）、'Gallery'（相册视图）、'Form'（表单视图）、'Gantt'（甘特视图）、'Query'（查询视图）或'Calendar'（日历视图）；默认创建'Grid'。暂只支持'Grid'和'Form'。

返回值 ​

Sheet

浏览器环境示例 ​

javascript
async function example() {
  await instance.ready();
  const app = instance.Application;
  await app.Sheets.Add(
    null,1,'xlEtDataBaseSheet',
        {
            fields:
                [
                    {fieldType:'SingleLineText',args:{fieldName:'文本',fieldWidth:15}},
                    {fieldType:'MultiLineText',args:{fieldName:'多行文本',fieldWidth:15}},
                    {fieldType:'Date',args:{fieldName:'日期',numberFormat:'yyyy/mm/dd;@',fieldWidth:15}},
                    {fieldType:'SingleSelect',args:{fieldName:'单选项',fieldWidth:15,
                        listItems:[{value: '选项1', color: 4283466178},{value: '选项2',color: 4281378020}]}},
                    {fieldType:'Number',args:{fieldName:'数字',fieldWidth:15}},
                    {fieldType:'Rating',args:{fieldName:'等级',maxRating:6,fieldWidth:15}},
                ],
            name:'数据表',
            views:
                [
                    {name:'表格视图',type:'Grid'},
                    {name:'表单视图',type:'Form'}
                ]
        }
    )
}

脚本编辑器示例 ​

javascript
function main() {
  Application.Sheets.Add(
    1,null,'xlEtDataBaseSheet',
        {
            fields:
                [
                    {fieldType:'SingleLineText',args:{fieldName:'文本',fieldWidth:15}},
                    {fieldType:'MultiLineText',args:{fieldName:'多行文本',fieldWidth:15}},
                    {fieldType:'Date',args:{fieldName:'日期',numberFormat:'yyyy/mm/dd;@',fieldWidth:15}},
                    {fieldType:'SingleSelect',args:{fieldName:'单选项',fieldWidth:15,
                        listItems:[{value: '选项1', color: 4283466178},{value: '选项2',color: 4281378020}]}},
                    {fieldType:'Number',args:{fieldName:'数字',fieldWidth:15}},
                    {fieldType:'Rating',args:{fieldName:'等级',maxRating:6,fieldWidth:15}},
                ],
            name:'数据表',
            views:
                [
                    {name:'表格视图',type:'Grid'},
                    {name:'表单视图',type:'Form'}
                ]
        }
    )
}
main()
回到旧版