数码|不想被开发约爬山？你需要先写好交互说明 |开发|黑板报|

编辑导读：交互说明文档，是交互设计师的输出物中必不可少的一项，它关系着设计方案能否最大程度的被实现。本文作者依据工作中项目实践的所思所想，并结合案例等分享了写交互说明时需要注意的一些问题，希望对你有用。

本文插图

交互说明，是交互设计师必不可少的‘写作能力’ ，它能让研发同事更加了解你的方案说明、交互想法。
但写得不好，容易出现流水账式、逻辑不清楚、文案臃肿等情况，给自己带来额外的工作量，还影响着与研发同事的对接效率。
所以今天想总结个人对‘交互说明’这块的知识，让你和研发同事更加愉快地玩耍~
目录：

技术型交互说明
只写最重要的
它只是个‘黑板报’
按模块来展示说明
建立交互说明库
真实的数据展示
复杂说明另外展示
有更改时及时告知
好的心态

01 技术型交互说明
传统的交互说明，是根据自己的意识、主观想法进行描述，但由于每个人的文笔不同、思维方式不一样，容易出现特别杂乱的说明，相关同事看了表示压力山大想拔刀…

本文插图

其实我们可以利用开发熟悉的技术术语、代码逻辑来阐述交互说明，使开发对交互说明有更加直观的理解，比如if else逻辑、switch case逻辑、数据库标识字段。
1. if else一种判断逻辑，根据判断条件正确与错误来执行对应的操作。它可以更直观地表达逻辑关系，更利于开发同事的理解。
比如用户登录的多逻辑说明，可以这么写：

本文插图
2. switch case

一种选择逻辑，根据选择项执行对应的操作。比如根据用户投入钞票的面值，决定可选择的商品类型。

本文插图

‘default’是容易疏忽的选项：匹配不存在时做的事情。
比如上面的例子，若是用户投了1元，或者投了一张纸怎么办？
【数码|不想被开发约爬山？你需要先写好交互说明】这是就需要‘default’的处理了。
3. 用数据库标识字段另外，一些‘动态参数’用数据库里的字段名称来标记也是一个不错的选择。
比如：‘用户’ ，在数据库里的储存字段是 #UserName# ，用它来代替交互说明里的动态参数，可以提升开发的理解效率。
怎么知道每个字段对应数据库的表达?

接口文档：前端和后台之间用来传输信息的文档，那里既有数据库的表达，也有对应的中文描述。
注：以上例子来自-唐韧《产品经理必懂的技术那点事儿》
02 只写最重要的
密密麻麻的文字说明，是早期交互设计师比较常见的‘毛病’ 。
一是列全所有说明，可以减少被diss‘考虑不周到’的可能；二是间接证明自己的专业能力。

本文插图

但是！交互说明毕竟是要给人看的，堆积的文字谁看得下去？？
只会带来额外的阅读压力和极高的理解成本，交互设计师修改起来也麻烦。
一俩个页面还好，多个页面都是这样的说明，开发没约你‘一起去爬山’就不错了。
所以个人建议，只针对有异常状态、特殊交互、分支流程、关键节点等特殊地方进行说明即可。
对于一些常识性、无异常点的地方就不用写了。