文件命名
文件建议使用小写字母,不用大写字母;文件名包含多个单词时,单词之间建议使用半角的连接线(-)分隔。
变量
小驼峰式命名方法
函数
小驼峰式命名方法(构造函数使用大驼峰命名法)
常量
全部大写
注释
单行注释:
-单独一行://(双斜线)与注释文字之间保留一个空格
-在代码后面添加注释://(双斜线)与代码之间保留一个空格,并且//(双斜线)与注释文字之间保留一个空格。
-注释代码://(双斜线)与代码之间保留一个空格。
// 调用了一个函数;1)单独在一行
setTitle();
var maxCount = 10; // 设置最大量;2)在代码后面注释
// setName(); // 3)注释代码
多行注释:
-若开始(/* 和结束 _/ )都在一行,推荐采用单行注释
-若至少三行注释时,第一行为/_,最后行为_/,其他行以_开始,并且注释文字与*保留一个空格。
/*
* 代码执行到这里后会调用setTitle()函数
* setTitle():设置title的值
*/
setTitle();
组件开发规范
1. 注册组件
注册组件的时候,全部使用 PascalCase 格式。import UserBook from './user/UserBook'
2. props 命名规范
在声明prop的时候,其命名应该始终使用camelCase,而在模板中应该始终使用kebab-case
<welcome-message greeting-text="hi"></welcome-message>
<script>
props: {
greetingText: String;
}</script>
3. methods 命名规范
驼峰式命名,统一使用动词或者动词+名词形式
尽量使用常用单词开头(set、get、go、can、has、is)
附: 函数方法常用的动词:
get 获取/set 设置,
add 增加/remove 删除
create 创建/destory 移除
start 启动/stop 停止
open 打开/close 关闭,read 读取/write 写入
load 载入/save 保存,
create 创建/destroy 销毁
begin 开始/end 结束,
backup 备份/restore 恢复
import 导入/export 导出,
split 分割/merge 合并
inject 注入/extract 提取,
attach 附着/detach 脱离bind 绑定/separate 分离,
view 查看/browse 浏览
edit 编辑/modify 修改,
select 选取/mark 标记
copy 复制/paste 粘贴,
undo 撤销/redo 重做
insert 插入/delete 移除,
add 加入/append 添加
clean 清理/clear 清除,
index 索引/sort 排序
find 查找/search 搜索,
increase 增加/decrease 减少
play 播放/pause 暂停,
launch 启动/run 运行
compile 编译/execute 执行,
debug 调试/trace 跟踪
observe 观察/listen 监听,
build 构建/publish 发布
input 输入/output 输出,
encode 编码/decode 解码
encrypt 加密/decrypt 解密,
compress 压缩/decompress 解压缩
pack 打包/unpack 解包,
parse 解析/emit 生成
connect 连接/disconnect 断开,
send 发送/receive 接收
download 下载/upload 上传,
refresh 刷新/synchronize 同步
update 更新/revert 复原,
lock 锁定/unlock 解锁
check out 签出/check in 签入,
submit 提交/commit 交付
push 推/pull 拉,
expand 展开/collapse 折叠
begin 起始/end 结束,
start 开始/finish 完成
enter 进入/exit 退出,
abort 放弃/quit 离开
obsolete 废弃/depreciate 废旧,
collect 收集/aggregate 聚集
4. 多个属性的html元素规范
多个特性的元素,占据一行过长时,应该分多行撰写,每个特性一行。(增强更易读)
5. 元素属性的顺序
原生属性放前面,指令放后面
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。