ShowDoc表格项目使用优化与页面适配指南

表格项目数据保存机制

ShowDoc的表格项目在数据保存方面采用了自动保存机制，但用户反馈表明这种机制存在一些体验问题。最新版本已对此进行了优化改进：

1. 新增手动保存按钮：为解决自动保存机制的不确定性，新版ShowDoc专门为表格项目增加了显式的手动保存按钮，让用户可以主动控制保存时机。

2. 保存机制说明：

   • 自动保存基于单元格的"弹起事件"(blur事件)，即当用户完成单元格编辑并将焦点移出时触发
   • 自动保存草稿功能会定期将未正式保存的内容暂存
   • 手动保存按钮提供了明确的保存控制点

3. 使用建议：

   • 重要数据编辑完成后，建议主动点击保存按钮
   • 长时间编辑时，系统会自动保存草稿作为备份
   • 注意检查页面顶部的保存状态提示

电子表格功能定位

ShowDoc的核心定位是技术文档管理工具，而非专业的电子表格应用。关于电子表格功能的几点说明：

1. 功能边界：ShowDoc的电子表格功能主要为满足技术文档中的基础表格需求设计，不适合复杂的电子表格场景。

2. 集成限制：电子表格目前作为独立项目类型存在，无法直接嵌入常规文档页面中。

3. 替代方案建议：对于重度电子表格需求，建议考虑专门的开源电子表格解决方案，再通过链接或截图方式与ShowDoc文档集成。

页面显示适配问题

TOC(目录)显示问题

ShowDoc的目录大纲功能(TOC)对显示宽度有一定要求：

1. 显示限制：在小屏幕设备或浏览器缩放比例较小时，TOC可能无法完整显示或完全不显示。

2. 解决方案：

   • 保持浏览器100%缩放比例
   • 使用足够宽的显示设备
   • 考虑使用移动端专用视图(如有)

移动端适配

关于移动端显示适配问题，开发者提供了以下技术方案：

1. 自定义CSS：通过修改样式表可以调整移动端显示效果。

2. 二次开发指南：

   • Docker部署环境下包含Node.js环境
   • 可进入容器命令行修改源码并重新构建
   • 主要调整响应式布局相关的CSS规则

3. 适配建议：

   • 优先考虑使用ShowDoc默认的移动端适配
   • 必要时再考虑自定义样式修改
   • 修改前备份原始文件

最佳实践建议

1. 表格项目使用：

   • 重要数据编辑后主动保存
   • 利用草稿功能作为备份
   • 复杂表格需求考虑专业工具+ShowDoc组合方案

2. 显示优化：

   • 保持标准浏览器缩放比例
   • 大屏幕设备可获得更好体验
   • 移动端优先使用响应式布局

3. 功能选择：

   • 评估需求是否匹配ShowDoc核心定位
   • 必要时组合使用专业工具
   • 充分利用现有功能的最佳实践

通过理解这些机制和优化建议，用户可以更高效地使用ShowDoc进行技术文档管理，同时避免因功能定位差异导致的体验问题。