Web前端开发规范手册

合集下载

thinkadmin开发手册

thinkadmin开发手册

thinkadmin开发手册

ThinkAdmin是一个基于ThinkPHP5框架的后台管理系统开源项目,该项目的出现给web开发人员带来了更加便捷的工作流程和更加高效的开发方式。如果你想要学习thinkadmin的开发方法以及掌握基本的使用技巧,那么本文将会为你提供一份完整的“ThinkAdmin开发手册”。

第一步:安装thinkadmin

在开始任何的开发工作之前,我们首先需要在本地安装ThinkAdmin环境。具体步骤如下:

1. 下载thinkadmin

2. 解压到本地web目录

3. 通过命令行进行目录安装操作

4. 访问index.php进行安装

第二步:学习ThinkAdmin基本知识

在掌握基本的thinkadmin安装技术之后,我们需要进一步了解thinkadmin的基本知识。以下是一些最主要的内容:

1. thinkadmin的基本框架结构

2. thinkadmin的配置文件

3. thinkadmin的主要目录结构

4. thinkadmin的认证、权限、日志、文件上传等基本模块

第三步:学习ThinkPHP5框架

thinkadmin是基于thinkphp5框架的一个开源项目,因此,在学习thinkadmin之前,我们需要掌握thinkphp5框架的基本知识,这是后续学习的基础。以下是一些最常见的内容:

1. thinkphp5的MVC模式

2. thinkphp5的路由

3. thinkphp5的模板引擎

4. thinkphp5的数据库操作等基本功能

第四步:开发一个简单的项目

在了解了thinkadmin和thinkphp5框架之后,我们可以开始动手开发一个完整的项目。

codemirror vue使用手册

codemirror vue使用手册

CodeMirror Vue 使用手册

CodeMirror 是一个功能强大的上线代码编辑器,它支持多种编程语言,并且提供了丰富的API 和样式定制选项。Vue 是一个流行的前端框架,它可以帮助开发者构建高效的 Web 应用程序。在本文中,我们将介绍如何在Vue 项目中使用CodeMirror,并探讨一些常见的用法和技巧。

1. 安装 CodeMirror

在使用 CodeMirror 之前,首先需要在 Vue 项目中安装 CodeMirror。可以通过 npm 或 yarn 进行安装,命令如下:

```bash

npm install codemirror

```

或者

```bash

yarn add codemirror

```

安装完毕后,可以在 Vue 组件中引入 CodeMirror:

```javascript

import CodeMirror from 'codemirror'

```

2. 在 Vue 组件中使用 CodeMirror

在 Vue 组件中使用 CodeMirror 需要做一些配置和初始化工作。首先需要在模板中创建一个 textarea 元素,用来显示代码编辑器的输入和输出。然后在 mounted 阶段初始化 CodeMirror 实例,并设置一些参数和样式:

```html

<template>

<div>

<textarea ref="editor"></textarea>

</div>

</template>

<script>

WEB前端开发代码使用要求规范

WEB前端开发代码使用要求规范

WEB前端开发代码使用要求规范

1.编码规范

- 使用标准的HTML、CSS和JavaScript语法。

-使用缩进和空格来提高代码的可读性。

-使用注释来解释代码的目的和功能。

2.文件和目录结构规范

-使用有意义的文件和目录命名,方便其他开发人员寻找代码。

-在项目中使用统一的目录结构,例如将HTML文件存放在一个文件夹中,将样式文件存放在另一个文件夹中,以此类推。

3.HTML规范

- 避免在HTML中直接写入样式和脚本代码,应将样式和脚本代码分离到对应的CSS和JavaScript文件中。

4.CSS规范

-使用适当的选择器,避免过多的嵌套。

-避免使用内联样式,应将样式写在CSS文件中,以提高可维护性。

- 使用合适的样式命名规则,例如使用BEM(Block-Element-Modifier)命名规则,或其他约定俗成的命名规则。

5. JavaScript规范

-使用合适的变量和函数命名,提高代码的可读性。

-避免使用全局变量,应将变量和函数封装在模块中。

- 使用严格模式(`use strict`),避免不规范的语法和行为。

- 避免使用`eval`和`with`等不安全的代码。

-在循环中使用合适的终止条件,避免死循环。

6.代码结构规范

-代码应具有良好的组织结构,例如使用模块化的方式来组织代码。

-尽量遵循单一职责原则,每个函数和类应该只负责一件事情。

-提取重复的代码块,封装成函数或类,以提高代码的复用性。

-不要写过长的函数或类,应该根据需要进行拆分和重构。

7.注释规范

-使用注释来解释代码的目的和功能,特别是代码的复杂部分。

Web开发技术手册

Web开发技术手册

Web开发技术手册

Web开发已经成为了当今互联网时代的核心技术之一。无论是企业

网站、电子商务平台,还是个人博客、社交媒体,都离不开这门技术

的支持。本文将介绍一些常用的Web开发技术,帮助初学者和开发者

了解这个领域的基础知识和技术工具。以下是本手册中所包含的内容:

一、HTML(超文本标记语言)

HTML是Web页面的基础语言,用于描述文档的结构和内容。它

由一系列的标签(tag)组成,用于定义页面的标题、段落、列表、链

接等元素。本节将介绍HTML的基本语法和常用标签,以及如何使用CSS(层叠样式表)美化页面的外观。

二、CSS(层叠样式表)

CSS是用于控制页面样式和布局的语言。它可以将HTML元素与样式规则关联起来,以实现页面的美化和布局控制。本节将介绍CSS的

选择器、属性和常用样式规则,以及一些CSS框架和预处理器的使用

方法。

三、JavaScript

JavaScript是用于实现客户端交互和动态效果的脚本语言。它可以

在网页中嵌入脚本代码,使页面具有响应用户操作、修改页面内容和

样式的能力。本节将介绍JavaScript的基本语法、数据类型和常用的DOM(文档对象模型)操作,以及一些流行的JavaScript库和框架的

用法。

四、服务器端开发

服务器端开发用于处理与客户端的数据交互,并生成动态内容。本

节将介绍常用的服务器端开发语言和框架,如PHP、Java、Python和Node.js,以及与数据库的集成和API(应用程序接口)的设计。

五、数据库

数据库是用于存储和管理数据的软件系统。Web开发中常用的关系

WEB前端开发规范文档

WEB前端开发规范文档

WEB前端开发规范文档

目录

WEB前端开发规范文档 (1)

规范目的 (2)

基本准则 (2)

文件规范 (2)

html书写规范 (2)

html其他规范 (3)

css书写规范 (4)

JavaScript书写规范 (5)

jQuery部分 (5)

开发及测试工具约定 (6)

其他规范 (6)

规范目的

为提高团队协作效率, 便于后台人员添加功能及前端后期优化维护, 输出高质量的文档, 特制订此文档: 本规范文档一经确认, 前端开发人员必须按本文档规范进行前台页面开发: 本文档如有不对或者不合适的地方请及时提出, 经讨论决定后方可更改:

基本准则

1:符合web标准, 语义化html,遵循内容(HTML)、显示(CSS)、行为(JavaScript)分离的代码组织模式。

2:代码格式化,保持干净整洁。

3:换行必须缩进一个tab。

4:编写所有前台页面时,请使用已有模板进行复制,在模板的基础上进行开发。

5:每一个页面都必须有一个独立的css,js文件。

6:如果不是用HTML5编写的网站,请用IE7,IE8,IE9,火狐,谷歌,webkit,safari内核进行测试兼容性。7:如果是HTML5编写的网站,请用IE9,火狐,谷歌,webkit,safari内核进行测试兼容性。

文件规范

1: html, css, js, images文件均归档至<系统开发规范>约定的目录中;

2: html文件命名: 英文命名, 后缀:htm: 同时将对应界面稿放于同目录中, 若界面稿命名为中文, 请重命名与html文件同名, 以方便后端添加功能时查找对应页面;

web开发文档

web开发文档

Web前端开发工作交接文档

一、项目总体逻辑

本次项目主要是网站开发。开发中使用的语言包括html,css,css3。使用到的前端框架为

Vue.js+jquery。在整个开发过程中,主要是以.html和.css为页面展示,.js为逻辑以及接口的调用。具体代码含义,见于开发中注释(正在注释中,页面较多)。

代码运行可以直接在vscode里用live server插件在需要运行的页面右键然后”Open with live server”

目前工作完成进度:目前工作的基本框架已经完成。主页面、产品展示部分页面等页面的前端设计已经完成。

二、各文件具体含义说明

图 1:基本的项目结构

.vscode 可忽略,是vscode软件自带文件夹

css目录,为页面的样式文件。

fonts目录,为此次开发所需使用的字体文件。

images目录,为此次开发所需的图片文件。

js目录,为项目的js文件,逻辑和接口调用都在里。

pages目录,为项目的展示页面,大部分页面的展示都在此文件夹。

plugins目录,为项目的插件所在地。

enterprise.html,为项目的专业版。

index.html,为项目的首页。

login.html,为项目的登录页

三、各文件具体含义说明

(1)pages文件夹

图 2:pages文件夹里面的内容

Act文件夹: 1.askforprice.html 主要是IoT物联网市场模板,暂时未调用接口只有页面Cart文件夹:主要是购物车模块

1.cartbuy.html 是用来选择购买时支付的选择,选择支付宝支付或微信支付

Web前端开发规范手册

Web前端开发规范手册

Web前端开发规范手册

一、规范目的

1.1 概述 1

二、文件规范

2.1 文件命名规则 (1)

2.2 文件存放位置2

2.3 css 书写规范3

2.4 html书写规范7

2.5 JavaScript书写规范11

2.6 图片规范12

2.7 注释规范13

2.8 css 浏览器兼容13

一、规范目的

1.1 概述

为提高团队协作效率, 便于后台人员添加功能及前端后期优化维护, 输出高质量的文档, 特制订此文档. 本规范文档一经确认, 前端开发人员必须按本文档规范进行前台页面开发. 本文档如有不对或者不合适的地方请及时提出, 经讨论决定后可以更改此文档.

二、文件规范

2.1 文件命名规则

文件名称统一用小写的英文字母、数字和下划线的组合,其中不得包含汉字、空格和特殊字符;命名原则的指导思想一是使得你自己和工作组的每一个成员能够方便的理解每一个文件的意义,二是当我们在文件夹中使用“按

名称排例”的命令时,同一种大类的文件能够排列在一起,以便我们查找、修改、替换、计算负载量等等操作。

a. HTML的命名原则

引文件统一使用index.htm index.html index.asp文件名(小写)

各子页命名的原则首先应该以栏目名的英语翻译取单一单词为名称。例如:

关于我们\ aboutus

信息反馈\ feedback

产品\ product

如果栏目名称多而复杂并不好以英文单词命名,则统一使用该栏目名称拼音或拼音的首字母表示;

每一个目录中应该包含一个缺省的html 文件,文件名统一用index.htm index.html index.asp;

前端面试手册

前端面试手册

前端面试手册

一、前端基础知识

1.HTML/CSS

作为前端开发的基础,掌握HTML和CSS的语法、规范以及浏览器兼容性问题。了解盒模型、布局、样式优先级等概念,并能熟练使用常见的前端框架(如Bootstrap、Foundation等)进行页面搭建。

2.JavaScript

熟练掌握JavaScript基本语法、数据类型、运算符、流程控制、函数、事件处理、DOM操作等。了解闭包、原型链、异步编程等高级概念,并能运用ES6+的新特性进行开发。

3.前端框架

熟悉主流的前端框架,如React、Vue、Angular等,了解其原理和优势,能够使用框架快速搭建可复用的组件和页面。

4.网络协议

掌握HTTP、HTTPS等网络协议,了解请求与响应、状态码、Cookie、Session等概念。了解跨域原理及解决方案,如CORS、JSONP等。

5.浏览器兼容性

了解各种浏览器的内核差异,掌握浏览器兼容性问题的解决方法,如使用Polyfill、feature检测、条件注释等。

6.性能优化

熟悉前端性能优化的策略,如减少HTTP请求、图片优化、缓存策略、代

码压缩与合并、渲染优化等。

二、前端工程化

1.模块化

掌握模块化的概念,能够使用CommonJS、ES6模块、AMD等规范进行编程。了解模块化工具,如Webpack、Gulp等。

2.自动化构建

熟悉自动化构建工具,如Webpack、Gulp、Grunt等,了解其原理和配置方法。

3.版本控制

熟练使用版本控制工具,如Git、SVN等,了解分支策略、合并冲突解决等。

4.代码规范

erajs使用手册

erajs使用手册

erajs使用手册

erajs是一款轻量级的JavaScript框架,用于构建Web应用程序。它

提供了一套简单而灵活的工具和方法,使开发人员能够快速创建交互

式和响应式的前端界面。本使用手册将详细介绍erajs的基本概念、功

能和常用技巧,以帮助初学者快速上手并提高开发效率。

1. 安装与引入

要使用erajs,首先需要在项目中引入erajs库文件。可以通过以下

方式获取erajs:

- 从官方网站下载最新版本的erajs库文件

- 使用包管理工具(如npm)进行安装

引入erajs库文件后,在HTML文件中通过`<script>`标签将其导入。如下所示:

```html

<script src="path/to/erajs.js"></script>

```

2. 初始化一个erajs应用

在使用erajs构建应用之前,需要进行初始化设置。可以通过以下代码实现erajs应用的初始化:

```javascript

erajs.init({

// 配置项

});

```

在配置项中,可以设置一些全局参数,如路由模式、默认路由等。

根据实际需求进行配置。

3. 创建页面

erajs提供了一种组织代码的方式,通过创建页面来管理相关的组件、模板和样式。页面是erajs的核心概念之一,用于展示和控制具体的界面。

创建一个页面需要定义一个子类,继承自`erajs.Page`类。以下是一

个简单的页面示例:

```javascript

class MyPage extends erajs.Page {

constructor() {

typescript中文手册

typescript中文手册

typescript中文手册

Typescript中文手册

___________________

随着前端技术的发展,TypeScript已经成为前端开发的重要技术之一。它结合了面向对象编程和函数式编程,使得前端开发者能够更高效、简洁地开发出大型应用。本文就介绍TypeScript的一些基本概念,以及它的基本使用方法。

### 一、TypeScript简介

TypeScript 是一种由微软开发的开源语言,它是 JavaScript 的超集,它在 JavaScript 的基础上添加了可选的静态类型、类和模块,使得 JavaScript 具有更好的可维护性、可读性和性能。

TypeScript 是一种类型化的 JavaScript 语言,它具有 JavaScript 的所有功能,并且可以直接运行在浏览器和服务器端,它还可以将代码编译为可执行的 JavaScript 代码。

### 二、TypeScript与JavaScript的区别

TypeScript 和 JavaScript 有很多相似的地方,但也存在一些重要的差异。最明显的差异就是TypeScript 是一种带有静态类型的语言,而 JavaScript 是一种动态类型的语言。在 TypeScript 中,你必须在使用变量之前明确它的数据类型;而在 JavaScript 中,你只需要定义变量就可以使用它,不需要明确它的数据类型。

此外,TypeScript 还具有更丰富的特性,如泛型、接口、类、枚举、装饰器等,这些特性在JavaScript 中都不存在。因此,使用 TypeScript 可以让你更加容易地开发出大型应用,并且可以

WEB前端开发规范

WEB前端开发规范

WEB前端开发规范

WEB前端开发规范

WEB前端开发规范

目录

1、规范目的

2、基本准则

3、文件规范

4、文件规范

5、html书写规范

6、css书写规范

7、JavaScript书写规范8、图片规范9、注释规范

10、开发及测试工具约定11、其他规范12、CSSHack1

规范目的

为提高团队协作效率,便于后台人员添加功能及前端后期优化维护,输出高质量的文档,同是为网站有一个更好的前端架构,网站的发展及未来打好一个基础。本文档如有不对或者不合适的地方请提出来,

基本准则

符合web标准,语义化html,结构表现行为分离,兼容性优良.页面性能方面,代码要求简洁明了有序,尽可能的减小服务器负载,保证最快的解析速度.文件规范

3.1、html,css,js,images文件均归档至约定的目录中;

23 3.2、html文件命名:命名以中文命名,依实际模块命名,如果同一模块以_&title&_来组合命名,以方便添加功能时查找对应页面,团结里的相互理解。

例如:我的好股网里的TAB命名

大模块名称_小模块的titile.html我的好股网_关注的微博.html

3.3、css文件命名:英文命名,后缀.css.初始化样式reset.css,其他样式依实际模块页面需求命名,共用样式一般以模块考虑来划分命名,如有改版修改的css文件可以采用&_时间日期

例如:微博改版

版块名称_时间日期.cssnew_blog_1212.css

4.4、Js文件命名:英文命名,后缀.js.共用common.js,其他依实际模块需求命名.

5.5、图片命名:4

erajs使用手册

erajs使用手册

erajs使用手册

1. 简介

erajs是一种基于JavaScript的前端框架,旨在简化Web开发过程中的操作,并提供高效、可靠的解决方案。本篇文章将为您提供erajs的使用手册,以帮助您更好地了解和应用该框架。

2. 搭建环境

要使用erajs进行开发,首先需要搭建相应的开发环境。以下是一些常见的工具和软件,您可以根据自己的需求进行选择和安装:- 编辑器:VSCode、Sublime Text等。

- Node.js:运行erajs的开发服务器。

- NPM或Yarn:用于安装和管理erajs的依赖项。

- Git:版本控制工具,用于持续集成和开发过程中的代码管理。

3. 安装erajs

在搭建好开发环境后,可以通过以下命令安装erajs:

```

npm install erajs

```

或者

```

yarn add erajs

```

4. 创建项目

安装完erajs后,可以通过以下命令创建一个新的erajs项目:

```

erajs init my-project

```

此命令将在当前目录下创建一个名为“my-project”的文件夹,并初始化一个erajs项目。

5. 目录结构

erajs的项目一般具有以下的目录结构:

- assets:存放静态资源文件,如样式表、图像等。

- components:存放组件文件。

- pages:存放页面文件。

- services:存放服务文件,用于数据处理和网络请求等。

- utils:存放工具函数文件。

- app.js:erajs的主入口文件。

- index.html:项目的主页面。

(完整word版)WEB前端开发代码使用要求规范.docx

(完整word版)WEB前端开发代码使用要求规范.docx

实用文档

WEB前端代码规范

规范目的

为提高团队协作效率,便于后台人员添加功能及前端后期优化维护,输出高质量的文档,特制订此文档。本规范文档一经确认,前端开发人员必须按本文档规范进行前台页面开发。本文档如有不对或者不合适的地方请及时提出,经讨论决定后方可更改。

基本准则

符合 web标准;语义化 html ;结构、表现、行为分离;兼容性优良。页面性能方面,代

码要求简洁明了有序,尽可能的减小服务器负载,保证最快的解析速度。

文件规范

1.Html, css ,js ,images 文件均归档至相应约定的目录中。

css

images

backStage

js

后台模⋯⋯

css

WebRoot

images

frontStage

js

WEB-INF

前台模⋯⋯

全局公共模⋯⋯

2. html 文件命名:英文驼峰式命名,文件名.html 。按实际模块需求命名。

3.jsp 文件命名:英文峰式命名,文件名 .jsp 。按模需求命名。

4.css 文件命名:英文峰式命名,文件名 .css 。共用 base.css ,首 index.css ,其他面按模

需求命名。

5.js 文件命名:英文峰式命名,文件名 .js 。共用 common.js,其他依模需求命名。

html 书写规范

1. 文档型声明及:一html5的声明型;一

,写利用IDE 次分明的。

2.非特殊情况下 css 文件必在 ... 之引入, link 方式引入而非

@import 形式。

3.非特殊情况下 js 文件必在面底部引入。

4.引入式文件或 JavaScript 文件,略去默型声明,写法如下:

ecmascript中文手册

ecmascript中文手册

ecmascript中文手册

摘要:

一、ECMAScript 简介

1.发展历程

2.应用场景

二、ECMAScript 核心概念

1.变量和数据类型

2.运算符和表达式

3.语句和流程控制

三、ECMAScript 面向对象编程

1.原型和原型链

2.构造函数和实例

3.封装、继承和多态

四、ECMAScript 函数

1.函数声明和函数表达式

2.参数传递和返回值

3.闭包和事件处理

五、ECMAScript 异步编程

1.回调函数和Promise

2.async/await 语法

3.Web Workers

六、ECMAScript 模块化和工程化

1.模块定义和导入导出

monJS 和ES6 模块

3.构建工具和打包

七、ECMAScript 应用实例

1.DOM 操作

2.事件处理和触发

3.实际项目中的应用

正文:

ECMAScript(简称ES)是一种广泛应用于Web 开发的编程语言。自1997 年诞生以来,ECMAScript 经历了多个版本的发展,不断丰富和完善其功能。如今,ES 已经成为现代前端开发不可或缺的一部分。

一、ECMAScript 简介

1.发展历程

ECMAScript 最初由Netscape Communications 公司于1995 年创建,旨在为浏览器提供一种通用的脚本语言。随后,ECMA 国际组织将其标准化,并发布了ECMAScript 262 标准。至今,ECMAScript 已经发展到第十版(ES10)。

2.应用场景

ECMAScript 主要应用于Web 前端开发,用于编写浏览器端的脚本代码。除此之外,还可以在其他领域发挥作用,如服务器端(如Node.js)、移动端(如React Native)等。

Web前端开发参考手册

Web前端开发参考手册

Web前端开发参考手册

WEB前端开发参考手册

概况

一(

1.1 WEB 标准

实现WEB标准二(

2.1 XHTML、CSS介绍 2.2 XHTML书写规范

2.2.1 XHTML结构

2.2.2 标签规范

2.3 XHTML常用标签介绍 2.4 CSS书写规范

2.4.1 表命名参考

2.4.2 类/ID命名规范

2.4.3 样式调用

2.4.4 样式简写

2.5 CSS常用属性介绍

2.6 图片规范

2.7 注释规范

2.8 浏览器兼容

一(概况

1.1 WEB 标准

WEB 标准不是一个标准,而是一系列标准的集合。网页主要由三部分组成:结构、表现和行为。对应的标准也分三方面:结构化标准语言主要包括XHTML和XML,表现标准语言主要包括 CSS,行为标准主要包括对象模型(如 W3C DOM)、

ECMAScript 等。这些标准大部分由W3C起草和发布,也有一些是其他标准组织制订的标准,比如ECMA(European Computer Manufacturers

Association)的 ECMAScript 标准。

二、实现WEB标准

2.1 XHTML、CSS介绍

可扩展超文本置标语言(eXtensible HyperText Markup Language,XHTML),是一种置标语言,表现方式与超文本置标语言(HTML)类似,不过语法上更加严格。从继承关系上讲,HTML是一种基于标准通用置标语言(SGML)的应用,是一种非常灵活的置标语言,而XHTML则基于可扩展置标语言(XML),XML是SGML的一个子集。XHTML 1.0在2000年1月26日成为W3C的推荐标准。

(完整word版)WEB前端开发代码使用要求规范.docx

(完整word版)WEB前端开发代码使用要求规范.docx

实用文档

WEB前端代码规范

规范目的

为提高团队协作效率,便于后台人员添加功能及前端后期优化维护,输出高质量的文档,特制订此文档。本规范文档一经确认,前端开发人员必须按本文档规范进行前台页面开发。本文档如有不对或者不合适的地方请及时提出,经讨论决定后方可更改。

基本准则

符合 web标准;语义化 html ;结构、表现、行为分离;兼容性优良。页面性能方面,代

码要求简洁明了有序,尽可能的减小服务器负载,保证最快的解析速度。

文件规范

1.Html, css ,js ,images 文件均归档至相应约定的目录中。

css

images

backStage

js

后台模⋯⋯

css

WebRoot

images

frontStage

js

WEB-INF

前台模⋯⋯

全局公共模⋯⋯

2. html 文件命名:英文驼峰式命名,文件名.html 。按实际模块需求命名。

3.jsp 文件命名:英文峰式命名,文件名 .jsp 。按模需求命名。

4.css 文件命名:英文峰式命名,文件名 .css 。共用 base.css ,首 index.css ,其他面按模

需求命名。

5.js 文件命名:英文峰式命名,文件名 .js 。共用 common.js,其他依模需求命名。

html 书写规范

1. 文档型声明及:一html5的声明型<!DOCTYPE html>;一

<meta charset="utf-8"/>,写利用IDE 次分明的。

2.非特殊情况下 css 文件必在 <head>...</head> 之引入, link 方式引入而非

  1. 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
  2. 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
  3. 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。

Web前端开发规范手册

一、规范目的

1.1 概述 (1)

二、文件规范

2.1 文件命名规则 (1)

2.2 文件存放位置 (2)

2.3 css 书写规范 (3)

2.4 html书写规范 (7)

2.5 JavaScript书写规范 (11)

2.6 图片规范 (12)

2.7 注释规范 (13)

2.8 css 浏览器兼容 (13)

一、规范目的

1.1 概述

为提高团队协作效率, 便于后台人员添加功能及前端后期优化维护, 输出高质量的文档, 特制订此文档. 本规范文档一经确认, 前端开发人员必须按本文档规范进行前台页面开发. 本文档如有不对或者不合适的地方请及时提出, 经讨论决定后可以更改此文档.

二、文件规范

2.1 文件命名规则

文件名称统一用小写的英文字母、数字和下划线的组合,其中不得包含汉字、空格和特殊字符;命名原则的指导思想一是使得你自己和工作组的每一个成员能够方便的理解每一个文件的意义,二是当我们在文件夹中使用“按名称排例”的命令时,同一种大类的文件能够排列在一起,以便我们查找、修改、替换、计算负载量等等操作。

a. HTML的命名原则

引文件统一使用index.htm index.html index.asp文件名(小写)

各子页命名的原则首先应该以栏目名的英语翻译取单一单词为名称。例如:

关于我们\ aboutus

信息反馈\ feedback

产品\ product

如果栏目名称多而复杂并不好以英文单词命名,则统一使用该栏目名称拼音或拼音的首字母表示;

每一个目录中应该包含一个缺省的html 文件,文件名统一用index.htm index.html index.asp;

b. 图片的命名原则

图片的名称分为头尾两部分,用下划线隔开,头部分表示此图片的大类性质

例如:广告、标志、菜单、按钮等等。

放置在页面顶部的广告、装饰图案等长方形的图片取名:banner

标志性的图片取名为:logo

在页面上位置不固定并且带有链接的小图片我们取名为button

在页面上某一个位置连续出现,性质相同的链接栏目的图片我们取名:menu

装饰用的照片我们取名:pic

不带链接表示标题的图片我们取名:title

范例:banner_sohu.gif banner_sina.gif menu_aboutus.gif menu_job.gif title_news.gif logo_police.gif logo_national.gif pic_people.jpg

鼠标感应效果图片命名规范为"图片名+_+on/off"。

例如:menu1_on.gif menu1_off.gif

c. javascript的命名原则

例如:广告条的javascript文件名为ad.js 弹出窗口的javascript文件名为pop.js

d. 动态语言文件命名原则

以性质_描述,描述可以有多个单词,用“_”隔开,性质一般是该页面得概要。

范例:register_form.asp register_post.asp topic_lock.asp

2.2 文件存放位置规范

_Root

cn 存放中文HTML文件

en 存放英文HTML文件

flash 存放Flash文件

images 存放图片文件

imagestudio 存放PSD源文件

flashstudio 存放flash源文件

inc 存放include文件

library 存放DW库文件

media 存放多媒体文件

project 存放工程项目资料

temp 存放客户原始资料

js 存放JavaScript脚本

css 存放CSS文件

2.3 CSS 书写规范

基本原则:

CSS样式可细分为3类:自定义样式、重新定义HTML样式、链接状态样式。

1. 样式为设计师自定义的新CSS 样式,影响被使用本样式的区域,用于完成网页中局部的样式设定。样式名“.”+“相应样式效果描述的单词或缩写”例:“.shadow”

文字样式样式名“.no”+“字号”+“行距”+“颜色缩写”例:“.no12”、“.no12-24”

2. 义HTML样式为设计师重新定义已有的HTML标签样式,影响全部的被设定标签样式,用于统一网页中某一标签的样式定义。样式名“HTML标签”例:hr { border: 1px dotted #333333 }

3. 态样式为设计师对链接不同状态设定特殊样式,影响被使用本样式区域中的链接。

该样式写法有2种:a.nav:link nav.a:link 第一种只能修饰标签中;第二种可以修饰所有包含有标签的其他标签。

页面内的样式加载必须用链接方式

注意细则:

1. 协作开发及分工: i会根据各个模块, 同时根据页面相似程序, 事先写好大体框架文件, 分配给前端人员实现内部结构&表现&行为; 共用css文件base.css由i书写, 协作开发过程中, 每个页面请务必都要引入, 此文件包含reset及头部底部样式, 此文件不可随意修改;

2. class与id的使用: id是唯一的并是父级的, class是可以重复的并是子级的, 所以id仅使用在大的模块上, class可用在重复使用率高及子级中; id原则上都是由我分发框架文件时命名的, 为JavaScript预留钩子的除外;

3. 为JavaScript预留钩子的命名, 请以js_ 起始, 比如: js_hide, js_show;

4. class与id命名: 大的框架命名比如header/footer/wrapper/left/right之类的在2中由i统一命名.其他样式名称由小写英文& 数字& _ 来组合命名, 如i_comment, fontred, width200; 避免使用中文拼音, 尽量使用简易的单词组合; 总之, 命名要语义化, 简明化.

5. 规避class与id命名(此条重要, 若有不明白请及时与i沟通):

a, 通过从属写法规避, 示例见d;

b, 取父级元素id/class命名部分命名, 示例见d;

c, 重复使用率高的命名, 请以自己代号加下划线起始, 比如i_clear;

d, a,b两条, 适用于在2中已建好框架的页面, 如, 要在2中已建好框架的页面代码

中加入新的div元素,

按a命名法则:

,

样式写法: #mainnav .firstnav{.......}

按b命名法则:

,

样式写法: .main_firstnav{.......}

6. css属性书写顺序, 建议遵循布局定位属性-->自身属性-->文本属性-->其他属性. 此条可根据自身习惯书写, 但尽量保证同类属性写在一起. 属性列举: 布局定位属性主要包括: margin、padding、float(包括

相关文档
最新文档