开发文档规范

标识说明

放在文档第一页。

对于初次接触你的交互文档的人来说，这样一份说明有助于对方理解你的交互，尤其是一些非通用的标识。

修订记录

放在文档第二页。

写明文档的修订者，方便开发找到对应的交互；列出文档更新的具体日期（最近更新的排最前），给出被修改页面的超链接，同时写明具体修改的内容。

页面标题

写在每一页的顶部。表明当前页所述的功能是属于哪个模块的，这样看的人不容易迷失。

对齐

对齐让文档可读性更好。

单个界面之中元素的对齐、界面和界面之间的对齐，页面上任何东西都是应该能找到对齐点的。



你的注释的对齐了吗？当年我的导师指出我交互稿里的注释没对齐这一点时，恍然大悟：这都是细节啊。右边注释对齐后，可读性更好。

UI：颜色、线条、留白

1. 尽量做到黑白灰不带彩色。

否则颜色和视觉稿不一致，测试会来问到底用哪种。

2. 灰色会让交互稿看上去更精致。

避免使用黑色线条，尽量不要出现黑底白字。



看自己两年前的交互文档，虽然也是整齐的，但总有种说不出的复古

3. 用深浅不同的灰来表现层次和重点。



4. 合理留白，避免界面过挤或过空。



注意颜色、留白这些细节。

讲到这里，有人会问，交互把时间浪费在这种视觉层面的事上有用么？

我倒觉得这是设计常识，或者你有没有意愿提高自己在这方面的能力。若有，则随手一画就是如上图右边的界面，何谈浪费时间。你永远无法预测一种技能在未来会派上什么用场。

当然，如果你会用交互组件库（ 如何打造一个方便高效的交互组件库？ ），也会省很多时间。

热区

标明热区的范围。

比如，为了图省事，没有标明右上角“关闭”的热区范围。然后开发就把热区做成和X一样的大小了。就有用户来反馈这个X点不中。



正确的表现方法：



对于紧密相连的热区，也有一些表现方法，能让开发看得更清楚：

透明度叠加法



颜色区分法



重复罗列法

图片

使用图片时，要注意和背景融合，避免出现“剪贴画”。



若暂没有找到合适的图标，宁可统一用占位符替代，辅以文字注释。



说到占位符，视觉有话说：“每次交互随手拉一个图片占位符，我都要冥想好久。”



配图，到底配什么图好呢…

所以，若对图片内容或风格有想法，不要吝啬用各种形式在交互文档中表现出来。

流程图

主线和分支的走向要始终保持一致。

如下图中红框框出的，“是”和“否”在两次判断中的走向不一致，对看的人来说就不是很好的体验。



正确的流程图表现：



界面流程也同样应该做到主线和分支清晰：



流程之间不要隔太多空白，不然开发会误以为这个页面的交互到此为止。可以在页面边缘拉一条辅助线，线没到头就说明后面还有内容。



单个界面尺寸不要设太大，建议等比例缩放。否则一屏之内显示不了几个界面，浏览效率太低。

注释

注释要简洁、明确。

从表现形式上分两种。一种是注释和UI离得较远，自成一体，用数字标一一对应。



国外有很多交互稿都是这么表现的。优点是看上去非常规范，适合注释密集的界面；缺点是开发的视线需要在界面上游走，找对应关系。

另外一种形式是注释和UI用直接用一条引线相连。



如果注释不是那么多，这种表现更为直观。

侧边索引

侧边索引是交互文档里的重中之重。它让一个上百页的交互文档变得易于浏览和查找。

1. 合理表现层级关系

正确的表现功能从属关系，增强侧边导航可读性。

2. 合理命名每个页面

页面名称也是有学问的，命名要做到逻辑清晰、表意全面。

举个例子，看下面这组页面命名，能一下子看出会员页都有哪些状态么？



如果这样命名，是不是感觉更清楚一些？

3. 合理拆分页面

理论上说，一个功能的所有流程都可以放在一个页面上讲。但是一个页面上如果分支太多，就容易变成“蜘蛛网”。

记得自己刚工作的时候做注册登录的交互。点击手机号注册会分好几种情况，我全都画在了一个页面上。等到交互评审时，当我拿着这张巨型流程图”斗转星移”地讲解时，台下人直接看晕了。

后来，我就学会了拆分页面。

4. 合理共用页面

做积分商城时，一开始，我在所有类型的商品页都加了支付的交互。

然后发现支付流程是个坑，里面的不确定因素太多，一改就是所有相关页面都要改一遍，容易出错。

最后，我就将所有商品页的支付流程都删掉，改成统一链接到另外一个专门讲支付流程的页面。这样遇到改动只要改这一个页面即可。

5. 避免侧边索引过长

做Windows phone的时候，因为一次性要做别的平台迭代了近两年的全部功能，交互文档的侧边索引就像万里长城一样，找一个功能要找好久。

后来做Windows 10的时候，就把交互文档按大的功能模块拆分了，这样每一份文档的页面数量就适中了。