整合营销服务商

电脑端+手机端+微信端=数据同步管理

免费咨询热线:

前端编码规范手册 学前端开发看这个就够了

前端编码规范手册 学前端开发看这个就够了

码规范---潜规则

黄金定律:不管有多少人共同参与一个项目,一定要确保每一行像是一个人编写的

HTML

html语法

  • 用两个空格来代替制表符(tab) -- 这是唯一能保证在所有环境下获得一致展现的方法。

  • 嵌套元素应当缩进一次(即两个空格)。

  • 对于属性的定义,确保全部使用双引号,绝不要使用单引号。

  • 不要在自闭合(self-closing)元素的尾部添加斜线 -- HTML5 规范中明确说明这是可选的。

  • 不要省略可选的结束标签(closing tag)(例如,</li> 或 </body>)。

HTML DOCTYPE

为每个 HTML 页面的第一行添加标准模式(standard mode)的声明,这样能够确保在每个浏览器中拥有一致的展现。

  • ie兼容模式

    <meta http-equiv="X-UA-Compatible" content="IE=Edge">

    字符编码

    通过明确声明字符编码,能够确保浏览器快速并容易的判断页面内容的渲染方式。这样做的好处是,可以避免在 HTML 中使用字符实体标记(character entity),从而全部与文档编码一致(一般采用 UTF-8 编码)。

引入文件

根据 HTML5 规范,在引入 CSS 和 JavaScript 文件时一般不需要指定 type 属性,因为 text/css 和 text/javascript 分别是它们的默认值。

实用为王

尽量遵循 HTML 标准和语义,但是不要以牺牲实用性为代价。任何时候都要尽量使用最少的标签并保持最小的复杂度。

属性顺序

HTML 属性应当按照以下给出的顺序依次排列,确保代码的易读性。

  • class

  • id,name

  • data-*

  • src,for,type,href,value

  • title

  • role,aria- *class 用于标识高度可复用组件,因此应该排在首位。id 用于标识具体组件,应当谨慎使用(例如,页面内的书签),因此排在第二位。

JavaScript 生成的标签

通过 JavaScript 生成的标签让内容变得不易查找、编辑,并且降低性能。能避免时尽量避免。

CSS

语法

  • 用两个空格来代替制表符(tab) -- 这是唯一能保证在所有环境下获得一致展现的方法。

  • 为选择器分组时,将单独的选择器单独放在一行。

  • 为了代码的易读性,在每个声明块的左花括号前添加一个空格。

  • 声明块的右花括号应当单独成行。

  • 每条声明语句的 : 后应该插入一个空格。

  • 为了获得更准确的错误报告,每条声明都应该独占一行。

  • 所有声明语句都应当以分号结尾。最后一条声明语句后面的分号是可选的,但是,如果省略这个分号,你的代码可能更易出错。

  • 对于以逗号分隔的属性值,每个逗号后面都应该插入一个空格(例如,box-shadow)。

  • 不要在 rgb()、rgba()、hsl()、hsla() 或 rect() 值的内部的逗号后面插入空格。这样利于从多个属性值(既加逗号也加空格)中区分多个颜色值(只加逗号,不加空格)。

  • 对于属性值或颜色参数,省略小于 1 的小数前面的 0 (例如,.5 代替 0.5;-.5px 代替 -0.5px)。

  • 十六进制值应该全部小写,例如,#fff。在扫描文档时,小写字符易于分辨,因为他们的形式更易于区分。

  • 尽量使用简写形式的十六进制值,例如,用 #fff 代替 #ffffff。

  • 为选择器中的属性添加双引号,例如,input[type="text"]。只有在某些情况下是可选的,但是,为了代码的一致性,建议都加上双引号。

  • 避免为 0 值指定单位,例如,用 margin: 0; 代替 margin: 0px;。

声明顺序

相关的属性声明应当归为一组,并按照下面的顺序排列:

Positioning Box model Typographic Visual

媒体查询(Media query)的位置 将媒体查询放在尽可能相关规则的附近。不要将他们打包放在一个单一样式文件中或者放在文档底部。如果你把他们分开了,将来只会被大家遗忘。下面给出一个典型的实例。

单行规则声明

对于只包含一条声明的样式,为了易读性和便于快速编辑,建议将语句放在同一行。对于带有多条声明的样式,还是应当将声明分为多行。

这样做的关键因素是为了错误检测 -- 例如,CSS 校验器指出在 183 行有语法错误。如果是单行单条声明,你就不会忽略这个错误;如果是单行多条声明的话,你就要仔细分析避免漏掉错误了

简写属性的声明

在需要显示地设置所有值的情况下,应当尽量限制使用简写形式的属性声明。常见的滥用简写属性声明的情况如下:

  • padding

  • margin

  • font

  • background

  • border

  • border-radius

注释

代码是由人编写并维护的。请确保你的代码能够自描述、注释良好并且易于他人理解。好的代码注释能够传达上下文关系和代码目的。不要简单地重申组件或 class 名称。

对于较长的注释,务必书写完整的句子;对于一般性注解,可以书写简洁的短语。

class命名

  • class 名称中只能出现小写字符和破折号(dashe)(不是下划线,也不是驼峰命名法)。破折号应当用于相关 class 的命名(类似于命名空间)(例如,.btn 和 .btn-danger)。

  • 避免过度任意的简写。.btn 代表 button,但是 .s 不能表达任何意思。

  • class 名称应当尽可能短,并且意义明确。

  • 使用有意义的名称。使用有组织的或目的明确的名称,不要使用表现形式(presentational)的名称。

  • 基于最近的父 class 或基本(base) class 作为新 class 的前缀。

  • 使用 .js-* class 来标识行为(与样式相对),并且不要将这些 class 包含到 CSS 文件中。

js编码规范

命名规范

驼峰命名法

  • 大驼峰

小驼峰

文件资源命名法

  • 文件名不得使用空格

  • 文件名使用小写,不使用大写

  • 包含多个单词时候,单个单词之间建议使用-分割

  • 引入资源使用相对路径,不要指定资源所带的具体协议 ( http:,https: ) ,除非这两者协议都不可用。

变量命名

命名规则:小驼峰式

函数命名

命名规则:普通函数使用小驼峰式,构造函数使用大驼峰式

常量

命名规则:全部大写

类的成员

  • 公共属性和方法:同变量命名方式 -私有属性和方法:前缀为下划线_后面跟公共属性和方法一样的命名方式

注释规范

单行注释

  • 单独一行://与注释文字之间保留一个空格

  • 在代码后面注释: //与代码有一个空格

  • 注释代码://与代码之间保留一个空格

多行注释

/**

  • @param grid {Ext,Grid,Panel} 需要合并的Grid,合并Grid的行 -

  • @param cols {Array} 需要合并列的Index值,从0开始计数

  • @param isAllSome {Boolean} 是否两个tr完全一样才能合并true:完全一样,false:默认

  • @return volid

  • @author

  • @example

*/

写 全称 中 文

AC alternating current 交流电

AC automatic control 自动控制

ACA accident consequence assessment 事故后果评价

ACB air circuit breaker 空气断路器

ACC accident 故障、事故

ACCUM accumulate accumulate 累计、 蓄电池

ACDS acourtic crack detection system 声裂纹检测系统

ACT/S active side 带电部件、 有功部件

ACW anti-clockwise 反时针方向

ACW anti-clockwise 反时针方向

AD analog-digital 模拟-数字

AEOD analysis and evaluation of operational data 运行数据分析和管理

AFC automatic frequency control automatic following control 自动频率控制:自动跟踪控制

AI artificial intelligence 人工智能

ALT alternate 交变的、交替的

ALTNTR alternator 同步发电机

AM ammeter 电流表

AMP ampere 安培

AN air natural cooled 空气自然冷却

AOC automatic overload control 自动过载控制

APC automatic plant coordinate control automatic power control 机组自动协调控制:自动功率控制

APP appendix auxiliary power plant 附录:辅助电源设备

APS acessory power supply 辅助电源

APU auxiliary power unit 辅助动力装置:辅助电源设备

ARM armature 电枢、衔铁

ASR automatic speed run up 自动升速

ASU automatic synchronizing unit 自动同步系统

AT auxiliary transformer 辅助变压器

AUS auxiliary switch 辅助开关

AUX auxiliany 辅助、备用

AVL automatic voltage control 自动电压控制

AVR automatic voltage regulator 自动调压器

BAT battery 电池

BD block decrease 闭锁减

BDUC bus duct 母线导管 、母线沟

BDV blowdown voltage 击穿电压

BF back feed 反馈

BHP brake horse power 制动马力

BI block increase 闭锁增

BKR breaker 断路器

BOS back-out system 补偿系统

BOT build-operate-tranfer 建造-运行-移交

BR brush 电刷、刷子

BRKG breaking 断开

BYC battery charger 电池充电器

CA compressed air 压缩空气

CAOS completely automatic operate system 全自动操作系统

CAP capactty 电容、 出力、容量

CAP capacity 容量、功率

CATS computer-aided trouble-shooting 计算机辅助故障查寻

CB control buton circuit breaker circuit board 控制钮:线路断路器:电路板

CBL line circuit breaker 线路断路器

CC charactevistic curve 特性曲线

CCW counter-clockwise 反时针

CD control desk 控制台

CEMF cownta electromotive force 反电动势

CG center of gravity 重心

CHGR charger 充电器

CKT circuit 电路、线路

CKW clockwise 顺时针方向

CL center line 中心线

CLSG closing 关闭、合闸

CMR continuous maxinum rating 连续最大功率

CNDN condition 工况、参数

CO con-out 关闭、切断

COEF coefficient 系数

CONST constans construction 常数:构造、结构

CONT contact control 接点:调节、控制

CP control panel 控制板

CPD capacitor potential device 电容器分压器

CRT cathode-ray tube 阴极射线管

CRT circuit 回路

CS controlled switch controll signal 控制开关:控制信号

CT current transformer 电流互感器

CW clockwise 顺时针方向

CY cycle 循环、周期

DB distribution box 配电箱

DBMS data base management system 数据库管理系统

DC direct current 直流电

DCAS data collection and analysis system 数据收集分析系统

DE digital equipment display equipment 数字元件:显示设备

DELIV deliver 供给、供电/输出

DG diesel generator 柴油发电机

DG diesel generator 柴油发电机

DHP delivered horse power 输出功率

DI data input 数据输入

DISC disconnect 断开

DISC SW disconnect swtich 隔离开关

DISTR diatribution 分散、分配 、配电

DL data line 数据传输线

DMM digital multimeter 数字万用表

DMS data management system 数据管理系统

DO diesel oil 柴油

DO digital output 数字输入

DOS dosing 量

DPDT double-pole double-throw 双刀双掷开关

DPST double-pole sigle-throw 双刀单掷开关

DSCH discharge 放电

DSL diesel 柴油机

DSL line desconnect switch 隔离开关

DT dawn time 故障停机时间

DTS data transimission 数据传输系统

DYNA dynamic analysis 动态分析

E.U engineering units 工程单位

E/P electrical to pneumatic converter 电动气动转换器

EAF equivalent available factor 等效可运系数

ECR economical continuous rating 经济连续出力

EE electrical engineer 电气工程师

EFF efficiency 效率

EFFT effective 有效的

EHV extra-high voltage 超高压

ELEC electric 电气的

EMER emergency 紧急、事故

EMER emergency 事故保安

EMF inductive electromotive force 感应电动势

EMLON emergency condition 事故状态

EMP eletromechanical power 机电功率

EMS emergency switch 紧急开关、事故按钮

ENCL enclose 封闭、包围

ENER energize 励磁、 使带电

ENERD energized 已励磁的、已带电的

ENG engage 发动机

EP extreme power 极限功率

ESD emergency shutdown 事故停机

ESS essential service system 主要厂用系统

ETS electrical trip solenoid 电气跳闸线圈

EXC exciter 励磁机、 励磁

EXD external device 外部设备

EY voltage transducer 电压变送器

FB fuse block 保险盒

FC fast closing 快关

F-F flip-flop 触发器

FL full load 满负荷

FLF flip-flop 触发器

FME frequency measuring equipment 频率计

FP full power 满功率

FREQ frequency 频率

FU fuse 保险丝、 熔断器

FWR full-wave rectifier 全波整流器

GEN generator 发电机

GIS gas-insulated metal-enclosed switch gear 全封闭组合电器

GPT generator potential transformer 发电机电压互感器

GRD ground 接地

GRD FLT ground fault 接地故障

GT grounding transformer 接地变压器

HC holding coil 保持线圈

HF high frequency 高频

HG harmonic generator 谐波发生器

HIPOT high potential test 高电压实验

HLDG holding 保持

HP horse power 马力

HS hand switch 手动开关

HT high tension 高压

HTN high tension 高电压

HV high voltage 高电压

HV high voltage high velocity 高压:高速

HVDC high voltage direct current transmission system 高压直流输电系统

HVPC high voltage power supply 高电压源

I/O input/output 输入/输出

IC integrated circuit input circuit 集成电路:输入电路

ICL incoming line 引入线

IMP impedance 阻抗

IMPLS impulse 脉冲、冲动

INDN induction 感应

INIT initial 启动、励磁

INITD initiated 已励磁的、已启动的

INSUL insulate 绝缘、隔热

INTMT intermediate 间断的、间歇的

INVR inverter 逆变器、反相器

ISLN isolation 隔离开关

ISOL isolation 隔离的、绝缘的

JY watt transduce 有功变送器

K kilo 千

KW kilowatt 千瓦

KWH kilowatt-hour 度

L electrical power line 电线

LA lightening arrester 避雷器

LC load centre 负荷中心

LC load center 负荷中心

LDS line disconnecting switch 线路隔离开关、线路断路器

LN line 线路

LOC local 就地

LPC linear power controller 线性功率放大器

LR line relay 线性继电器

LSIC large scale integrated circuit 大规模集成电路

LV low voltage 低电压

MAG magnet 磁铁/磁场的

MAN manual 手动的

MC manual control magnet contactor 人工控制:磁铁开关

MCB molded case circuit breaker 模板式断路器

MCC motor control centre 马达控制中心

MCC motor control center 马达控制中心

MCR main control room maxium capacity rating maxium continuous rating 主控室:最大额定出力:最大连续出力

MDS motor disconnect switch 马达隔离开关

MG motor generator 电动发电机

ML mechanical loss 机械损失

MNXFMR main transformor 主变压器

MO motor 马达

MOD motor operated disconnect 电动断开

MPR motor protrelay 电机保护继电器

MSTR motor starter 马达启动器

MWE megawatt electric 兆瓦电

MWH megawatt-hour 兆瓦小时

NADVD not advanced 滞后

NEG negative 阴极的、负的

NET network 网络

NEUT neutral 中性的

NGT neutral groundong transformer 中性点接地变压器

NL noload 空载、无负荷

NOM nominal 额定的

NRP normal rated power 额定功率

O&R overhaul and repair 大小修

OA operator auto mode 运行人员监控下的自动控制运行方式

OL motor overload device 电机过负荷装置

OP output power operating procedure 输出功率:运行规程

OPER operating 操作

OR operating record 停运记录

OVHL overhaul 大修

P.O. power output 功率输出

P.U. per unit 标幺值

PA power amplifier 功率放大器

PAMS post-accident montoring instrumentation 事故后监测仪表

PB push button 按钮开关

PC power center 动力中心

PCB power circuit breaker 功率继电器

PCC power conditioning and control 电力调节与控制

PCM pulse-code modulation 脉冲编码调制

PD potenial difference power driven 电位差:电动的

PE power equipment 发电综合控制

PF power factor indicator 功率因数

PFI power factor indicator 功率因数表

PGCC power generation control complex 相位

PH phase 功率输入

PI power input 峰值负荷

PK peak 峰值

PL plate 板、极板

PL peak load 峰值负荷

PLD payload 有效负载

PM phase midulation 调相

PO power operator 电动操作

POH planned outage hours 计划停运小时

POOH planned overhaul outage hours 计划大修停运小时

POS positive 正的、正极的

POS position 位置

POT potential transformer 电势、电位计

PP peak power 峰值功率

PPS plant protective system primary protection system 电厂保护系统:一次保护系统

PS power station power supply power system 电站:电源:电力系统

PSS power support stabilizer 电力系统稳定器

PT potential transformer 电压互感器

PT potential transformer 电压互感器

PT pressure transducer 压力变送器

PWR power 功率

Q transistor 晶体管

QA quick acting 快速动作

QMQB quick-make quick-break 快通快断

R rate rotor ratio 速率:转子:比率系数

RA remote auto 远程自动

RAM repair and maintenance 检修与维护

RB run back 甩负荷

RD run down 降负荷

RF reserve free 备用

ROT rate of turn reserve oil tank 转动速度:备用油箱

RP rated power 额定功率

RPM revolution per minute 转/分

RPS revolution per second 转/秒

RS resistor 电阻器

RSV reserve 备用

RTD resistance temperature device 电阻测量计

RU run up 升负荷

RU run up 升负荷

S/C short circuit 短路

SC short circuit 短路

SC semi-conductor 半导体

SCR silicon-controlled rectifier 可控硅整流器

SECT sectional 等级、分级

SEN sensor 传感元件、传感器

SERV service 工作、厂用

SG standby generator 备用发电机

SO shut-off 停机、遮断

SOE sequence of events 事故顺序记录

SOH scheduled outage hours 计划停机时间

SOV solenoid -operated valve 电磁阀

SP single pole spare 单极:备用

SPC system power control 系统电源控制

SPDT single-pole double-throw 单刀双掷

SR speed reguletor standard rating silicon rectifier 调速器:额定容量:硅整流器

SS station service 厂用

SS stopping switch 停机开关

SST station service transformer 厂用变压器

ST starter startup transformer 启动器:启动变压器

STA stationary 固定的

STAT stator 定子

STBY standby 备用

STBY stand by 备用

STR reserve station service transformer 厂用备用变压器

SUBSTA substation 变点站

SUPL supervisory 供电、电源

SUR surge 冲击、波动

SV solenoid valve 电磁阀、滑阀

SW switch 开关

SW switch 开关、手把

SW short wave switch 短波:开关

SWBD switchboard 配电

SWBD switchboard 开关板、配电盘

SWC surge withstand capability 冲击电压承受能力

SWGR switchyard 配电装置

SWYD switchyard 开关场

SY synchroscope 同步指示器

SYM symmetrical system 对称系统

SYNC synchronize 使---同步

SYNCG synchronizing 同步

SYNSCP synchroscope 同步指示器

SYS system 系统

SYST system 系统

T&D transimission and distribution 输电与配电

T&M testing and maintenance electrical trip and monitoring 实验与维修:电电气跳闸与监视系统

TACH tachometer 转速表

TASS technique assembly 装配工艺

TB therminal board 端子板、终端板

TBO time between overhaul 大修间隔

TC thermocouple 热电偶

TD time delay 延时

TD technique data time delay 技术数据:时滞、延时

TDC time delay closing 延时闭合

TDD time delay on deenerization 延时失励

TDE time delay energization 延时激励

TDO time delay opening 延时打开

TE thermoelectric test equipment 热电的:测试设备

TH thermal element 热电偶、热偶元件

TIS test instrumentation system thermal insulation system 测试仪表系统:绝缘系统

TL total loss total load time limit 总 损失:总负荷:时间限制

TM time monitor 时间监视器

TOT total 总共

TP test point time pulse 实验点、测试点:时间脉冲

TPDT triple-pole double-throw 三刀双掷开关

TR test run transducer 试运行:变送器

TRANS transport 运输

TRC transmission and reception controller 传输及接收控制器

TRIAC triode altermating current switch 三极管交流开关

TRU transmit-receive unit 发送接收装置

TSI turbine supervisory instrument 汽轮机监视仪表

TVM transistor voltmeter 晶体管电压表

U unit 机组

UAT unit auxiliary transformer 厂用变压器

UDF unit derating factor 机组降低出力系数

UDG unit derating generation 机组降低出力少发电量

UDH unit derating hours 机组降低出力小时

UERS unusual event recording system 异常事故记录系统

UNDH unit derating hours 机组降低出力小时

UNIV universal 通用

UNLD unloading 无载的、空载的

UO unit operator 机组操作员

UOF unplanned outage factor 非计划停运系数

UOH unplanned outage hour 非计划停运小时

UOR unplanned outage rate 非计划停运率

UPS uninterrupted power supply 不停电电源

URT unit run time 设备运行时间

UST unit station service transformer 厂用变压器

UV under voltage 电压不足、低电压

UV 电压监察

VAR variable 变量

VARHM garhour meter 无功电度表

VC variable capacitor voltage comparator 可变电容:电压比较器

VCB vacuum circuit breaker 真空断路器

VCT voltage current transformer 电压电流互感器

VENT ventilator 通风

VF vriable frequency 可变频率

VOLTREG voltage regularor 电压调节器

VR variable resistor voltage regulator 可变电阻:稳压器

VT vibration testing 振动实验

VT voltage time to breakdown 击穿电压时间

VTVM vacuum-tube voltmeter 真空管电压表

W/O without 没有

WDG winding 绕组、线圈

WH watt-hour 瓦特小时

WHM watthour meter 有功电度表

WTR water 水

WV working voltage 工作电压

WZJ 绝缘监察

XDCR transducer 变送器

XFER transfer 转换

XFMR transfoormer 变压器

XMSN transmission 输电

XMTR transmitter 变送器

XS transfer switch 转换开关

YD yard 工作场

期资料目录

1、机械专业英语词汇完整版

2、机械图纸中英文翻译

3、工厂及设备常用英语

有需要下载的朋友请私信小编,回复“013”即可获取下载链接