云链前端规范.pdfVIP

目 录 目录和文件命名规则 HTML规范 css、scss规范 JavaScript规范 本文档使用 看云 构建 - 2 - 目录和文件命名规则 目录和文件命名规则 由个人习惯和其他原因引起的目录和文件命名不统一 ，导致不同成员在维护同一项目时 ，效率低下 ，迭代、维护 成本极高 ，其他成员接手代码很难快速了解项目结构。因此需要统一文件的命名规则 ，保证不同的成员在维护的 同一套代码时可以快速的梳理和了解项目。 文件夹及文件名命名 1. 文件名和目录名命名均采用有意义的英文方式命名 2. 不使用拼音或无意义的字母 3. 文件名不得含有空格 项目命名 1. 全部采用小写的方式 目录命名 1. 全部采用小写的方式 2. 多个单词之间使用-分隔 3. 有复数结构时 ，要采用复数命名法 （例如 ：images ，scripts ） JS文件命名 参照项目命名 例如 ：common-action.js CSS、SCSS、LESS文件命名 参照项目命名 例如 ：common-action.scss HTML文件命名 参照项目命名 例如 ：common-action.html 本文档使用 看云 构建 - 3 - HTML规范 HTML规范 DOCTYPE HTML文件必须加上 DOCTYPE 声明 ，启用标准模式 ，使页面在每个浏览器中尽可能一致的展现 ，按照惯例 ， doctype大写 !DOCTYPE html 字符编码 通过声明一个明确的字符编码 ，让浏览器轻松、快速的确定适合网页内容的渲染方式 ，必须使用UTF-8 head meta charset UTF-8 /head 语义化 使用符合语义的标签书写 HTML 文档, 选择恰当的元素表达所需的含义。 结构性元素 p 表示段落。 只能包含内联元素, 不能包含块级元素 li 本身无特殊含义, 可用于布局。 几乎可以包含任何元素 br 表示换行符 hr 表示水平分割线 h1-h6 表示标题。 其中 h1 用于表示当前页面最重要的内容的标题 blockquote 表示引用, 可以包含多个段落。请勿纯粹为了缩进而使用blockquote, 大部分浏览器默认将 blockquote 渲染为带有左右缩进 pre 表示一段格式化好的文本 头部元素 title 每个页面必须有且仅有一个 title 元素 base 可用场景 ：首页、频道等大部分链接都为新窗口打开的页面 link 用于引入 css 资源时 ，可省去 media(默认为all) 和 type(默认为text/css) 属性 styletype 默认为 text/css ，可以省去 scripttype 属性可以省去 ，不赞成使用lang属性 本文档使用 看云 构建 - 4 - HTML规范 noscript 在用户代理不支持 JavaScript 的情况下提供说明 文本元素 a 存在 href 属性时表示链接 ，无 href 属性但有 name 属性表示锚点 em,strong em 表示句意强调 ，加与不加会引起语义变化 ，可用于表示不同的心情或语调 ， strong 表示重要性强调 ，可用于局部或全局 ， strong 强调的是重要性, 不会改变句意 abbr 表示缩写 sub,sup 主要用于数学和化学公式 ，sup还可用于脚注 span 本身无特殊含义 ins,del 分别表示从文档中增加(插入)和删除 媒体元素 img 请勿将img元素作为定位布局的工具, 不要用他显示空白图片 必要时给img元素增加alt属性 列表元素 dl 表示关联列表, dd是对dt的解释 dt和dd的对应关系比较随意 ：一个dt对应多个dd、多个dt对应