UE Design | 交互需求文档需要写哪些？-京东云开发者社区

<center>![](//img1.jcloudcs.com/developer.jdcloud.com/25619269-1315-425d-bc7e-c7745dbbf2c120210127093454.gif)</center>

交互设计文档文档是写给UI、研发、测试看，指导UI设计和开发团队研发和测试，针对用户来写，尽量简明扼要不失逻辑。

（交互说明写的不够清楚详细，导致和前端、开发人员的沟通成本增高、返工增多、工作效率下降等。为了解决这些问题，一方面需要加强沟通，另一方面还需要多站在前端、开发的角度考虑交互说明的表达形式，使大家的配合更默契）。

### 交互设计文档一般包括：
1.目录（封面，包括项目名称，各负责人，功能架构等）
2.修改记录（追踪整个产品形成的过程，便于用者查看需求修改）
3.设计风格、要求（主要针对界面设计）
3.功能说明（便于了解产品架构）
4.操作说明（要重点说明，一定要详细写明，不同操作状态下的显示、提示、转场是什么样的，都要详细说明）
5.所用协议及字段来源（这个是附加的，无需交互人员来写，一般由前端人员来补充）

### 关于操作说明：
1.页面为空、错误或其它提示语；
2.标注操作触发区域、操作反馈；
3.刷新机制、状态加载动画；
4.数据的获取、缓存（保留）与清除；
5.字段位数的显示限制及显示不下时的处理方式；
6.页面切换、跳转及返回逻辑；
7.标注部分字段含义；
注：定义下图中各种不同颜色指引线的含义（如红色代表后退，绿色代表前进）
8.弹框显示形式及后续操作反馈
9.控件各状态显示
10.默认状态及状态的保留与清除
11.输入框有/无数据时显示、输入数据的保留/清除、键盘调用；
12.无网或断网、网络不好的处理机制；
13.过渡过程，如：延时移动、淡入淡出等。转场效果，如：滑动、门开关、缩放、翻转等。 
14.功能位置及后台控制等；
15.按钮可点、不可点及按下效果；
16.待续...

### 其它需要注意的：
（摘自http://blog.sina.com.cn/s/blog_453d02200101al34.html）
1，尽量使用真实、符合逻辑的数据内容；
2.不遗漏特殊状态的描述
3.避免过长的说明
4.避免流水账式的说明
A 流程图代替文字说明；B 表格罗列各种状态；C 巧妙组织文字说明；D 制作动态效果
5.关于重复出现的模块
为了节省时间，提高效率，把这个模块独立出来，并起名，然后在其它页面上只留个空位就可以了
6.如原型有修改，不要口头沟通，而要更新交互说明并告知大家（为了敏捷可以口头，但文档和信息同步需要补上）

<center>![](//img1.jcloudcs.com/developer.jdcloud.com/70bb7de0-2ca3-455a-abf2-d7cb42bc465720210127093841.jpg)</center>

<center>![](//img1.jcloudcs.com/developer.jdcloud.com/88cea616-753b-4205-9c94-cff0ae46270e20210127093708.png)</center>