经验总结:5个应该避免的前端糟糕实践

这几天在产品的某个模块上上添加新功能,该模块之前是由其他同事维护。也就是说,需要在同事原有代码的基础上进行修改。过程中遇到了一些坑,主要是由一些不合理的代码实践导致的。

这里抛开大的设计话题,仅挑出其中一些自己认为不是很合理的代码细节。原因很简单:当我们在审视别人代码的时候,总会看到这样那样的不合理之处,而等到自己撸起袖子上阵时,其实也很难保证自己不会犯同样的错误。可能是一时偷懒,也可能是赶需求导致的考虑步骤等。

本文代码示例点击下载

糟糕实践一:依赖节点之间的顺序

我们来看下面代码,大家应该对这样的代码非常熟悉了,这也是初学者比较容易犯的一个错误:节点的查询依赖于节点当前所处的位置。下面 

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>

解决方案

千万不要用 element.getElementsByTagName(tagName)[index] 这样的方式可以来获取节点,除非你有非这样做不可的理由。

取而代之可以用类似 element.getElementById(id) 来获取,或者采用下文提到的 element.querySelector(selector) 这样的方式~

 

糟糕实践二:依赖标签的排版

 上面我们已经提到说节点查询的时候不要依赖于节点的顺序,原因是节点的顺序是有可能改变的。那么,如果节点顺序没有“发生变化”,那就能够确保平安无事了吗?答案是未必。

且看下面的代码,也是很常见的代码,获得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>

 解决方案

尽可能地避免通过元素选择器来声明样式(reset css的除外),如果非用不可,那么尽可能地将杀伤范围限制得足够小,如在某个特定的id、class内部用元素选择器,就像下面这样这样。

注意:尽管这样做看上去安全了些,但还是有不小的隐患,千万小心

.restrict_style ul{ color: red; } // 通过外层容器,限制选择器的

 

糟糕实践五:节点查询依赖于样式类名

在一个页面中,id是唯一的,给太多的节点加上id,很容易造成节点id的冲突。常用的推荐解决方案是,给最外层的容器节点加上id,而对于子节点,则加上相应的class,以此达到方便查询、避免冲突的目的。下面这样的代码相信大家不陌生,包括不少开源组件都是这么个思路。

<h2>节点查询依赖于类名</h2>
<div id="888">
    <span class="nick">昵称:程序猿小卡</span>
    <span class="hobby">爱好:动漫</span>
</div>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript">
    $('#888 .nick').css('color', 'green');
    $('#888 .hobby').css('color', 'orange');
</script>

上面的代码看上去没什么问题,那究竟为什么说它糟糕呢?因为:1、不利于样式重构 2、修改容易导致bug

假设某个晴朗的早晨,产品同学找到你说,这里这里的样式需要改版,你稍微一评估,自信满满地说:没问题,很简单。于是你就开工了,既然是改版,肯定是大动刀了。过了一会,你的眼球突然被<span class="nick"></span>这个标签吸引了:好好的炎黄子孙class名干嘛起得这样洋里洋气的,太装了吧(很不恰当的例子哈,只是为了说明因某些原因需要修改类名)。于是果断将“nick”改成了“nicheng”,多通俗易懂啊。

于是,悲剧了,在本文的例子里,把“nick”改成“nicheng”,只是会导致样式稍微有点不正常,但严重的时候脚本错误都有可能

<h2>节点查询依赖于类名</h2>
<div id="999">
    <span class="nicheng">昵称:程序猿小卡</span>
    <span class="aihao">爱好:动漫</span>
</div>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript">
    $('#999 .nick').css('color', 'green');  // 节点取不到了
    $('#999 .hobby').css('color', 'orange');

    $('#999 .nick')[0].innerHTML = '程序猿小卡'; /// 出错了,因为$('#999 .nick')[0]为undefined
</script>

解决思路

大家都推崇的开发方式(外层id,内层class),是不是就不要用了呢?当然不是,只不过可以稍微调整下:

1、外层容器用id

2、子节点用class,但class前需要加上“js-”等特殊前缀,标识该样式为js代码里需要用到的。对这样的class不要随便动它,如果需要修改,请先搜索下整个工程目录,确保你的修改不会导致bug。

简单修改下上面的例子,好了,nick、hobby,随你修改了~

<h2>节点查询不依赖于样式类名</h2>
<div id="1010">
    <span class="js-nick nick">昵称:程序猿小卡</span>
    <span class="js-hobby aihao">爱好:动漫</span>
</div>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript">
    $('#999 .js-nick').css('color', 'green');  // 节点取不到了
    $('#999 .js-hobby').css('color', 'orange');

    $('#999 .js-nick')[0].innerHTML = '程序猿小卡'; /// 出错了,因为$('#999 .nick')[0]为undefined
</script>

 

更多糟糕实践

待补充

 

posted @ 2014-03-15 01:44  程序猿小卡  阅读(2947)  评论(19编辑  收藏  举报