码规范---潜规则
黄金定律:不管有多少人共同参与一个项目,一定要确保每一行像是一个人编写的
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”即可获取下载链接
*请认真填写需求信息,我们会在24小时内与您取得联系。