起航学习网

- 让每个人都能学到最前沿新知识、新技能!
起航学习网
当前位置: 起航学习网 > 职业教育 > 贵阳达内:前端编码应该要怎么写?切记要规范+规范+规范!

贵阳达内:前端编码应该要怎么写?切记要规范+规范+规范!

时间:2018-11-23 14:42:12来源:贵阳达内 作者:贵阳达内 已有: 名学员访问该课程

  快捷搜索:贵阳达内前端编码

前言:当一个团队开始指定并实行编码规范的话,错误就会变得更加显而易见。这是因为一些程序员平常养成的编码不规范的小习惯导致的。如果一段特定的代码不符合规范的话,它有可能只是代码风格错误,而也有可能会是 bug。贵阳达内:早期指定规范就使得代码审核得以更好的开展,并且可以更精确的地定

当一个团队开始指定并实行编码规范的话,错误就会变得更加显而易见。这是因为一些程序员平常养成的编码不规范的小习惯导致的。如果一段特定的代码不符合规范的话,它有可能只是代码风格错误,而也有可能会是 bug。贵阳达内:早期指定规范就使得代码审核得以更好的开展,并且可以更精确的地定位到错误。只要开发者们能够保证源代码源文件都严格遵循规范,那接下去所使用的混淆、压缩和编译工具则可投其所好不尽相同。
贵阳达内:前端编码应该要怎么写?切记要规范+规范+规范!_qh.itpxw.cn
1、文件/资源命名
在 web 项目中,所有的文件名应该都遵循同一命名约定。以可读性而言,减号(-)是用来分隔文件名的不二之选。同时它也是常见的 URL 分隔符(i.e. //example.com/blog/my-blog-entry or //s.example.com/images/big-black-background.jpg)
 
所以理所当然的,减号应该也是用来分隔资源名称的好选择。请确保文件命名总是以字母开头而不是数字。而以特殊字符开头命名的文件,一般都有特殊的含义与用处。资源的字母名称必须全为小写,这是因为在某些对大小写字母敏感的操作系统中,当文件通过工具压缩混淆后,或者人为修改过后,大小写不同而导致引用文件不同的错误,很难被发现。
    还有一些情况下,需要对文件增加前后缀或特定的扩展名(比如 .min.js, .min.css),抑或一串前缀(比如 3fa89b.main.min.css)。这种情况下,建议使用点分隔符来区分这些在文件名中带有清晰意义的元数据。
 
不推荐
MyScript.js
myCamelCaseName.css
i_love_underscores.html           
1001-scripts.js
my-file-min.css
 
推荐
my-script.js
my-camel-case-name.css
i-love-underscores.html
thousand-and-one-scripts.js
my-file.min.css
 
2、协议
不要指定引入资源所带的具体协议。当引入图片或其他媒体文件,还有样式和脚本时,URLs 所指向的具体路径,不要指定协议部分(http:, https:),除非这两者协议都不可用。不指定协议使得 URL 从绝对的获取路径转变为相对的,在请求资源协议无法确定时非常好用,而且还能为文件大小节省几个字节。
 
不推荐
<scriptsrc="http://cdn.com/foundation.min.js"></script>
推荐
<scriptsrc="//cdn.com/foundation.min.js"></script>
不推荐
.example {
  background: url(http://static.example.com/images/bg.jpg);
 
}
推荐
.example {
  background: url(//static.example.com/images/bg.jpg);
}
3、文本缩进
一次缩进两个空格。
<ul>
<li>Fantastic</li>
<li>Great</li>
<li>
<ahref="#">Test</a>
</li>
</ul>
@media screen and(min-width:1100px){
  body {
    font-size:100%;
}
}
(function(){
var x =10;
function y(a, b){
return{
      result:(a + b)* x
}
}
}());
 
4、注释
    注释是你自己与你的小伙伴们了解代码写法和目的的唯一途径。特别是在写一些看似琐碎的无关紧要的代码时,由于记忆点不深刻,注释就变得尤为重要了。编写自解释代码只是一个传说,没有任何代码是可以完全自解释的。而代码注释,则是永远也不嫌多。当你写注释时一定要注意:不要写你的代码都干了些什么,而要写你的代码为什么要这么写,背后的考量是什么。当然也可以加入所思考问题或是解决方案的链接地址。
贵阳达内:前端编码应该要怎么写?切记要规范+规范+规范!_qh.itpxw.cn
不推荐
var offset =0;
if(includeLabels){
// Add offset of 20
  offset =20;
}
推荐
var offset =0;
if(includeLabels){
// If the labels are included we need to have a minimum offset of 20 pixels
// We need to set it explicitly because of the following bug: http://somebrowservendor.com/issue-tracker/ISSUE-1
  offset =20;
}
    一些注释工具可以帮助你写出更好的注释。JSDoc 或 YUIDoc 就是用来写 JavaScript 注释用的。你甚至可以使用工具来为这些注释生成文档,这也是激励开发者们写注释的一个好方法,因为一旦有了这样方便的生成文档的工具,他们通常会开始花更多时间在注释细节上。
 
5、代码检查
对于比较宽松自由的编程语言来说,严格遵循编码规范和格式化风格指南就显得极为重要。遵循规范固然很好,但是有自动化流程来确保其执行情况,岂不更佳。Trust is good, control is better.对于 JavaScript,建议使用 JSLint 或 JSHint。
 
贵阳达内:以小见大,养成良好的习惯,在工作中你能事半功倍!
 

文章出自:http://qh.itpxw.cn/qgtk/201844765.html

文章标题:贵阳达内:前端编码应该要怎么写?切记要规范+规范+规范!



免责声明:本站文章均由入驻起航学习网的会员所发或者网络转载,所述观点仅代表作者本人,不代表起航学习网立场。如有侵权或者其他问题,请联系举报,必删。侵权投诉

(责任编辑:深圳学历教育网)
顶一下
(0)
0%
踩一下
(0)
0%
------分隔线----------------------------
培训学校
海口达内 访问该机构站点 报名留言 加为好友 用户等级:开放浏览 用户级别:0 机构名称:达内科技教育集团 联 系 人:吴老师 联系电话: 联系手机: 在线客服:起航学习网客服 在 线 QQ:起航学习网客服 电子邮件: 网站域名:http://hk.tedu.cn/ 注册时间:2018-07-27 15:07 最后登录:2021-01-14 09:01