这几天在产品的某个模块上上添加新功能,该模块之前是由其他同事维护。也就是说,需要在同事原有代码的基础上进行修改。过程中遇到了一些坑,主要是由一些不合理的代码实践导致的。
这里抛开大的设计话题,仅挑出其中一些自己认为不是很合理的代码细节。原因很简单:当我们在审视别人代码的时候,总会看到这样那样的不合理之处,而等到自己撸起袖子上阵时,其实也很难保证自己不会犯同样的错误。可能是一时偷懒,也可能是赶需求导致的考虑步骤等。
本文代码示例:点击下载
我们来看下面代码,大家应该对这样的代码非常熟悉了,这也是初学者比较容易犯的一个错误:节点的查询依赖于节点当前所处的位置。下面
getElementsByTagName(‘span‘)[0] 这样的写法存在很大的隐患,很简单,主要节点的顺序一发生变化,就出事了。
<h2>不要依赖节点顺序</h2> <div id="1111"> <span></span>, <span>爱好:动漫</span> </div> <script type="text/javascript"> var $ = function(id) { return document.getElementById(id); } $(‘1111‘).getElementsByTagName(‘span‘)[0].innerHTML = ‘昵称:程序猿小卡‘; </script>
比如节点的顺序变成,那就会发生一些意料之外的事情了,第一个span节点之间的“简介:”就被无情地覆盖了。
<h2>不要依赖节点顺序</h2> <div id="222"> <span>简介:</span> <span></span>, <span>爱好:动漫</span> </div>
上面我们已经提到说节点查询的时候不要依赖于节点的顺序,原因是节点的顺序是有可能改变的。那么,如果节点顺序没有“发生变化”,那就能够确保平安无事了吗?答案是未必。
且看下面的代码,也是很常见的代码,获得id为“333”的元素的第一个子节点,并将该子节点的color设置为 #ccc。
<h2>顺序没变,但脚本错误了</h2> <div id="333"><span>昵称:程序猿小卡</span><span>爱好:动漫</span></div>
<script type="text/javascript"> $(‘333‘).childNodes[0].style.color = ‘#ccc‘; </script>
顺序不变也会出事?可能有的同学会有这样的疑惑。好吧,本人稍微有一点排版上的强迫症,看上上面类似的标签排班时,总是忍不住想要去小小调整下,好让标签看上去更清晰些,于是我小小调整了下排版,变成下面这个样子。
<h2>顺序没变,但脚本错误了</h2> <div id="444"> <span>昵称:程序猿小卡</span> <span>爱好:动漫</span> </div> <script type="text/javascript"> $(‘444‘).childNodes[0].style.color = ‘#ccc‘; </script>
子节点顺序并没有发生改变,只是排版变了,按理来说不会有什么影响吧。好,让我们打开chrome看下,控制台下输出这样的信息:
Uncaught TypeError: Cannot set property ‘color‘ of undefined
什么原因呢?眼尖的同学可能已经看出来了,childNodes属性可以获得一个节点的所有子节点,而这些子节点里面包含了文本节点,甚至是标签末尾的换行、空格。不难想到,下面的标签同样会导致同样的bug,而这里的标签跟最初的标签,唯一的区别仅在于:第一个span标签前面多了个空格。
这个bug隐蔽指数相当高,很可能放在那里几年都没有人触发。毕竟,有谁会想到,换个行,加个空格都会导致出bug呢,而且在旧版本IE里面,childNodes是将文本节点排除在外的,也就是说,即使你加了换行、排版,在旧版本IE里测试也是完全ok的,巨坑。
<h2>顺序没变,但脚本错误了</h2> <div id="555"> <span>昵称:程序猿小卡</span><span>爱好:动漫</span> </div> <script type="text/javascript"> $(‘555‘).childNodes[0].style.color = ‘#ccc‘; </script>
项目中依赖的基础库是jQuery,jq提供了非常强大的选择器,很常见的就是可以通过节点类型进行选择,比如下面代码。如果你那么写的话,接手你代码的兄弟估计会恨死你。
<h2>依赖节点类型</h2> <div id="666"> <ul></ul> </div> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript"> $(‘#666 ul‘).html(‘<li>昵称:程序猿小卡</li><li>爱好:漫画</li>‘); </script>
问题很明显,$(‘#666 ul‘)选中了id为666的节点下所有节点类型为UL的子节点、孙节点、曾孙节点。。。我就掉这个坑里了,但是需要在上面加多个下拉列表,于是毫不犹豫地采用UL来模拟,大致如下。运行的结果绝对让你抓狂。
<h2>依赖节点类型</h2> <div id="777"> <ul></ul> <ul> <li>选项一</li> <li>选项二</li> <li>选项三</li> </ul> </div> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript"> $(‘#777 ul‘).html(‘<li>昵称:程序猿小卡</li><li>爱好:漫画</li>‘); </script>
跟上面的例子其实很类似,还是用上面的标签来说明问题。同事的愿望很朴素,就是希望将ul节点下的文本都设置为红色而已。
<style type="text/css"> ul{ color: red; } </style> <h2>依赖节点类型</h2> <div id="666"> <ul></ul> </div>
然后,我往里面查了另一个ul元素来模拟下拉列表,悲剧了,原先声明的样式伤及无辜。。
<h2>依赖节点类型</h2> <div id="777"> <ul></ul> <ul> <li>选项一</li> <li>选项二</li> <li>选项三</li> </ul> </div>
待补充
经验总结:4个应该避免的前端糟糕实践,布布扣,bubuko.com
原文:http://www.cnblogs.com/chyingp/p/experience-bad-practise.html