在开发中,说实话,一般的公司可能都不会有写文档的时间,并且个人也不一定都有这习惯。 但是对于你来说,代码就是你的一张脸,当别人读的时候,你总不希望别人说:“天阿!怎么这么丑!!!”如果正好你这时在旁边,那将会是一件多么悲催的事~~ 那么让我们简单的为这张脸美容一下,代表自己嘛,肯定不要太悲催了,哈哈。 让代码自己说明白为什么这样,大家肯定想到了写注释。 写注释也有好多种写法,比如说能直接生成javaDoc的注释风格等 但是即使生成了,这文档又会有多少人去看呢?又有多少人能看懂呢? 所以,还是让我们来简单点吧,只会占用你一点点时间,就让你的代码看起来更加的漂亮。 CSS 对于CSS,也许经常会使用到缩写,但是过一段时间,自己也许都已经已经不记得了~囧! 写一些必要的注释,解释缩写的意义。对于其他人来看,这让他们更快的明白;对于自己过一段时间后再看,可以迅速的回想起当时的思路,易于修改。 jQuery ui theme的风格,这种命名方法,个人感觉是非常不错的方法,即易于记忆,同时也易于理解。 命名空间,虽然CSS里面这个概念很弱,或者说因为权重的问题不存在命名空间这个概念。但是如果把页面上每一块都分割开的话,那么每一块应该是相对独立,在独立的范畴内应该使用同一父级的class做为命名空间。这不仅仅是权重的问题,也增强代码的可读性。 多使用换行,对于不同的区块,应该使用换行让代码上的逻辑也更清晰。 javascript javascript有很多不同的注释写法,我这里绝对不是标准的,大家请仅仅做为参考。 写注释的目的就是为了让代码自己可以解释自己,并且说明自己的用法等。 在注释段里面放些简单的实例,让新人更容易理解已经公司现有的Base类库。 遵循着某总风格。因为javascript的灵活性,使得使用这门语言的人可以用各种写法来达到目的,但是实事让,如果在团队里每个人的代码风格都相差很大,不但看起来不爽,读起来更不爽。 所以我们一定要遵循某种结构。 噢,对了,在组件的前面,或者段落前要写上自己的名字,这点很重要,因为其他人要修改的话,至少要知道这东西是谁做的,可以找谁商议。 以上一些步骤其实都不复杂,但是你的代码会因此清晰点。 输入的指令是要让编译器明白,如果它不明白,OK没商量直接给你抛Error~ 写注释,是为了给人看的,如果只是机器能看懂,那还不如不写了。
会说话的代码
星期日, 三月 20th, 2011微型设计专用工具Dorado试用
星期三, 十二月 1st, 2010腾讯出品的一个标注工具 使用感觉还不错 现在功能挺简单的 只有标注,吸管与显示(隐藏)标注功能。 放大镜 有放大镜功能,可以准确的进行标注 吸管工具可以直接取色 总体来讲还是不错,但是本人觉得不是很实用,因为这些功能反而有些鸡肋。 首先没有像素马查找功能,当然有放大镜也是弥补了这一点; 其次标注的目的是为了让开发人员更容易,但是紧紧只有距离与颜色是根本不够的。 大家可以参考我以前写过的相关标注文章: 前端开发手册之设计篇 前端MVC-PSD设计篇 标注其实是设计师的一项职责,因为里面包括字体与间距都要非常精确才行,而一般会在设计完成后,在源文件(PSD)内进行标注。 因为涉及到切图所以有时同一设计需要分几个文件进行标注。 所以如果脱离了PSD文件,其实是将事情变得更加复杂化!
前端MVC – PSD设计篇
星期二, 八月 24th, 2010一般情况下经常发生设计师的稿件由于计算的不够精准,在实现时发生偏差较大。 由于网页设计与网站开发经常需要与人合作,不论是设计师还是策划还是开发人员他们之间的合作往往非常密切。 我们从设计稿开始入手。 没有绝对的自由 完美的精度1px 网页设计与杂志设计不同在于,网页有更多尺寸上的限制,这点跟报纸排版比较相通。 不能凭感觉就堆放与目测,需要精准到1像素的级别。 而设计师也需要对页面的布局相当的了解,商业网站分割区别一般很多,所以需要尺寸灵活把握,这样才能做出更精准的设计。 千万不要想着让其他人(制作人员)来想这些计算的方法,每个人都多做些事,合作起来才会更愉快。 Grid 而对于大网站来说,网站页面的数量也是非常庞大的,而制作的人相对较多,这样,要保证每位设计师出来的效果都是可以轻松被制作出来,需要一套标准,一套格(Grid)还是需要的。 字体 商业网站,由其是大型商城等网站的设计,由于对流量与加载速度的考虑,会少会图片所以其可用字体其实是非常少的,所以设计师的难度也就无形中的增加了,但是可以根据访问流量与用户所用浏览器系统等,用少量特殊字体,增强视觉效果,但是必须要有备选的方案,保证其他人也能正常的浏览。 更多信息 重要的信息指引是快速制作与开发的根基,所以网页设计也一样,设计师应该把一些基础的标准值都标记出来,比如说边框的颜色、边框的种类、应用的场景等进行标注,这样不仅为开发人员提供了良好的可读性,同时也可以大大提高开发效率。 先有数据,再有设计 现在一般认为先要出设计稿,然后再往里填充数据,其实是这真是大错特错。我们被模板时代给坑害了,更把模板的感念给误解与曲解,认为一切都可以模板化。 而事实是先要进行数据分析,然后再对数据进行可视化,往往连最基本的数据都没有就纸上谈兵,这只会走更多的冤枉路与耗费大家的精力与增加合作之间的摩擦。 只有仔细的对数据进行分析,才会发现,原来还有这么多“特殊”的存在。所以预测数据的精准度,将决定着设计稿(PSD)写实际搞(HTML)的偏差值。 虽然不能做到万无一失,但是知己知彼,百战不殆。 同样可以减少摩擦与挫败感,增强合作的愉悦。 没有简单的事情 当需求人员把东西拿过来,永远不要“小看”这些数据,这里需求人员也要注意。 永远不要说“这个很简单,这样,这样,然后这样就行了”… … 这样的后果就是不断的返工与无休止的争论,即使再小的Banner也有他特殊的地方。 先写这么多,想到再写~~
