怎样做一份让工程师泪流满面的标注

在搬着小板凳坐工程师 buddy 旁边送果汁送零食的日子里，我受 Google Material Design 的启发，折腾出一套自认提高双方沟通效率的标注规则，心情挺好还为此做了模板，最下面有源文件的下载地址。

是的我曾经也很寄希望于 Zeplin，参与第一批内测后就写了长长的自带说明配图的邮件给他们，期待 1.0 的发布，那就可以解决我这篇文章里写的所有问题了，以下内容大家就不用看啦。论偷懒工具的重要性啊盆友们……想起昨晚看见 FB 新玩出来的 sketch 插件，用 HTML+CSS 实现的动态布局。

没错，Markman 是传说中的标注神器，看起来也确实方便快捷，但是当一个页面中，要同时标注间距、大小、颜色和字号时，过多的信息一齐扔给工程师，就会让人有些抓狂。比如这样

这里的标注虽然都有清晰的箭头指示，但却并不具有视觉逻辑，或者说呈现出来的视觉逻辑并不符合开发逻辑。工程师在搭建一个页面的时候，会先去架构布局，一块内容一块内容划分好，接着填充进内容，最后来修改视觉的样式。那么我们也应该按照顺序，先告诉人家每个模块的间距啦大小啦，再告诉人家用什么字体和颜色，也就是先有布局标注，再有样式标注。

用2个页面解释布局，再用1个页面解释样式

这就是我的做法，视觉稿完成后，每一个页面拿出来放在左边，再用三个画板来说明它。

1. 横向布局：解释元素左右的外间距、内间距和横向宽度。（这里要考虑到针对不同宽度屏幕的适配，标注是给固定值还是百分比）
2. 纵向布局：解释元素的上下间距和高度。（有时要确保页面里最重要的信息——比如一个 CFA btn——在不同屏幕大小中是否都出现在了首屏，判断标注是向上定位还是向下定位 ）
3. 视觉样式：字体、字号、行高、颜色、透明度、圆角。

标注信息分类之后，我还会给标注本身设置共享样式：块面通常用蓝色的遮罩，区别不同百分比时则用红黄绿的遮罩，数字间距用红底白字，视觉样式则用蓝底白字，这样的好处是：对与设计师，可以快捷修改所有标注样式；对于工程师，快速建立对这套标注视觉语言的认知，明白不同颜色所代表的信息属性，更方便的找到他所需要的信息。

单独拎出可复用的组件，统一标注

设计实现之前，就和工程师们一起统一一套样式规范，除了常见的颜色和字体之外，我还会把通用的 UI 组件拿出来，一半是针对系统原生控件的样式定制（alert/toast/radio btn/switch…），一半则是完全自定义的 UI 组件（产品自己的 UI kit）可以是任何会高频复用的产品功能性的东西，比如这里的 SKU 选择器和按钮。

在项目进程中，我甚至会和工程师们沟通好，然后在每个组件旁写上这个组件是谁正在实现或已经实现，附在项目共享文件或者邮件里，避免重复劳动。

统一标注的好处不仅是我们自己在后续的设计中可以复用和遵守， 对于 web/iOS/Andriod 的工程师而言，也能提高代码效率同时保持不同平台最终效果的统一，后续迭代的时候也不会出现莫名其妙的样式和代码。如果遇到产品的大版本更新，也正好趁此机会和工程师们一起好好梳理一遍现有的样式，清除掉不再使用的样式，指定好新的层级。