13 KiB
常见问题
本章内容搜集了大家反馈的常见问题，如果官方文档和此列表都不能解答您的疑问，推荐到官方论坛反馈
Q luckysheetfile中的data和celldata有什么区别？
A : 表格初始化时使用一维数组格式的 celldata，初始化完成后转化为二维数组格式的data作为存储更新使用，celldata不再使用。
如果需要将data拿出来作为初始化数据，则需要执行 transToCellData(data)转换为celldata数据。
其中{ r, c, v }格式的celldata转换为二维数组使用的是transToData(celldata)
总结如下：
// data => celldata 二维数组数据 转化成 {r, c, v}格式 一维数组
luckysheet.transToCellData(data)
// celldata => data 生成表格所需二维数组
luckysheet.transToData(celldata)
Q 单元格的类型有哪些？
A : 参考单元格格式列表,例举了可用的单元格格式
Q 如何在Vue/React项目中使用Luckysheet？
<span style="font-size:20px;">A :
- Vue案例：luckysheet-vue
- React案例：luckysheet-react
Q 为什么初始化后表格里面的公式不会被触发？
A : 参考 表格数据格式 ,设置单元格数据对应的calcChain即可。
Q 远端加载数据是loadUrl还是updateUrl？
A : loadUrl。配置了loadUrl，Luckysheet会通过ajax请求整个表格数据，而updateUrl会作为协同编辑实时保存的接口地址。 注意：初始化数据需要配置loadUrl参数，而协同编辑则在配置loadUrl、updateUrl和allowUpdate四个参数才能生效。
Q 每个sheet页的index和order有什么区别？
A : 每个sheet页都有一个唯一id，就是index，可以用数字递增，也可以使用随机字符串，而order是所有的sheet的排序情况，从0开始，只能为数字0,1,2...。
Q dist文件夹下为什么不能直接运行项目？
A :需要启动本地服务器
Q excel导入导出怎么做？
A :配合Luckysheet开发的excel导入导出库-Luckyexcel已经实现了excel导入功能，导出功能正在开发当中。现阶段excel导出可以参考这2篇博文：
Q 初始化时合并单元格怎么做？
A :参考以下案例
Q Luckysheet如何把表格里的数据保存到数据库？有没有服务端存储和协作的解决方案？
A :有两个方案：
- 一是表格操作完成后，使用
luckysheet.getAllSheets()方法获取到全部的工作表数据，全部发送到后台存储。 - 二是开启协同编辑功能，实时传输数据给后端。 具体的操作步骤参考这篇文章：Luckysheet如何把表格里的数据保存到数据库
Q 如何监听单元格hover或者点击事件？cellRenderAfter如何实时监听变化？
A ：我们搜集到需要针对单元格事件的二次开发需求，规划了单元格相关的钩子函数，参考单元格钩子函数（显示的TODO的暂未开放）
Q 顶部的工具栏不支持自定义配置？
A ： 顶部工具栏的自定义配置使用初始options.showtoolbarconfig(如果标注TODO表示暂未开发)
Q 项目使用了jQuery吗？
A ：是的。Luckysheet内部启动时间比开源的时间早很多，所以用到了jQuery。打包工具会把jQuery集成到打包目录的./plugins/js/plugin.js文件中。
如果您的项目中（比如React/Vue）也自己全局引用了jQuery，且造成了冲突，可以尝试去掉一个jQuery。
要想在Luckysheet里去除jQuery，需要在源码根目录下的gulpfile.js文件中找到打包jQuery的地方：src/plugins/js/jquery.min.js，删除jQuery相关的信息即可。
Q 如何为单元格对象新增字段？
A 首先参考单元格对象格式，然后参照源码批注的部分src/controllers/postil.js。批注是一个加在单元格对象上的一个配置。
Q 工具栏图标加载不出来？
A 工具栏及其他部分图标采用了iconfont图标，加载不出来是因为缺少了iconfont.css的引入，之前旧版官方文档未写清楚这一点对大家造成误导，很抱歉。
详细的Luckysheet使用教程参考已经更新的官方文档
Q Luckyexcel打包后不动？
A 打包的终端命令行不显示结束，但是如果dist文件夹内已经有了结果文件luckyexcel.js，则表明是正常的。
Luckyexcel是excel导入导出库，项目采用了gulp作为打包工具，旧版打包工具有点问题在命令行显示这块有些问题，问题已经修复。请还出现此问题的小伙伴做如下更新操作：
- pull最新代码
npm inpm run build
更多详细信息关注：Luckyexcel
Q 单元格不可编辑如何控制？表格保护怎么操作？
A 单元格不可编辑属于工作表保护的功能范畴，需要配置在每个sheet页中config.authority，最新的设置参数请参考工作表保护。
为了大家便于理解工作表保护的功能使用，下方的视频演示了如何让当前整个工作表不可编辑，但是允许某一列单元格可编辑的功能：
跟着演示操作一下本地的工作表，然后打开浏览器控制台，使用luckysheet.getLuckysheetfile()[0].config.authority就可以获取到第一个工作表的工作表保护参数。
Q 数据验证怎么配置？
A 最新文档已经提供了数据验证的配置信息，参考数据验证配置。官方也提供了API方法 setDataVerification，用于动态设置数据验证功能。
Q Luckysheet通过引入CDN有案例吗？
A Luckysheet支持CDN方式引入，参考：本地HTML采用cdn加载方式引入Luckysheet的案例
Q 请问一下图片怎么限制在单元格里面自适应高度？
A 首先需要对图片设置移动并调整单元格大小，然后有以下几种情况：
- 如果图片位置完全在单元格内部时，当拉长单元格的宽度或高度的时候，图片不会随着单元格的变大而伸缩变大
- 如果图片位置完全在单元格内部时，当拉短单元格的宽度或高度，贴到图片的边时，图片会随着单元格的变小而伸缩变小
- 当这个图片超过单元格的边框时，图片可以跟随单元格大小变化
根据图片的第二个特性，可以操作得到图片位置信息，原理就是将图片的位置设置成和单元格边框重叠（源码中，需要重叠超过2px），以下演示视频展示了怎么将图片限制在单元格里面自适应宽高。
Q 如何获取工作表默认的行高列宽？
A 有两种方式可以获取
- 一是使用
luckysheet.getLuckysheetfile()获取到所有工作表配置后，在各个工作表的配置中直接取得默认行高defaultRowHeight和默认列宽defaultColWidth。 - 二是开放了API可以获取到工作表默认的行高getDefaultRowHeight和列宽getDefaultColWidth
Q 如何隐藏工作表下方的添加行按钮和回到顶部按钮？
A 已开放配置
- 允许添加行 enableAddRow
- 允许回到顶部 enableAddBackTop
Q 如何隐藏工作表的行标题和列标题？
A 已开放配置
- 行标题区域的宽度 rowHeaderWidth
- 列标题区域的高度 columnHeaderHeight
Q 调用什么方法能设置config.merge？
A 三个方法
- 界面操作
- 用API：setRangeMerge
- 手动组装merge参数
Q 为什么官方公布的新功能没有效果？
A 第一步，检查下您是否使用了CDN的方式引入，
Luckysheet教程里采用的CDN链接是 jsdelivr 提供的服务，代码是从 npmjs.com 自动同步过去的，不是从 Github 同步过去的。因为我们新提交的代码，还需要经过一段时间的测试，所以不会立即发布到npm使用，导致了npm的代码稍滞后于Github。
如果需要尝试最新代码，我们强烈建议您从 Luckysheet Github 主仓库拉取代码。后续我们版本稳定了，会考虑实时发布npm包。
第二步，如果是引用github仓库打包后的代码，测试判断是否有bug，您可以查找问题并尝试修复，再提交PR，如果修复不了，请提交issues。
Q npm run dev报错：Error: Cannot find module 'rollup'？
A 可能是npm包安装问题，尝试以下步骤：
npm cache clean --forcenpm i rimraf -grimraf node_modules- 删除package-lock.json文件
npm inpm run dev
提示：大多数的其他npm安装问题，也可以尝试此步骤来解决。
**Q**怎样在vue工程里对Luckysheet进行二次开发`？
A luckysheet-vue 案例是提供一个应用集成的方案。
如果本地直接开发的话：
- 把Luckysheet的工程和自己的Vue工程都启动起来，比如Luckysheet的工程在
http://localhost:3001 - 在Vue工程里面通过
http://localhost:3001引入Luckysheet使用
这样的话，Luckysheet实时修改后，Vue工程里是可以看到更改的