当前位置: 首页 > article >正文

亿坊软件前端命名规范

在前端开发中,文件命名的重要性不言而喻。由于历史原因和个人习惯,不同的开发者在命名DOM结构、图片和CSS文件时,可能会产生不一致的情况。这不仅会导致维护成本增加,还会降低团队协作效率。因此,制定一套统一的命名规范至关重要!
本文长期更新,请亿坊同事收藏好

需要注意的几点
1.尽量考虑为元素命名其本身的作用或”用意”,达到语义化。不要使用表面形式的命名.
如:red/left/big等。
2.组合命名规则:
[元素类型]-[元素作用/内容]
如:搜索按钮: btn-search
登录表单:form-login
新闻列表:list-news
3.涉及到交互行为的元素命名:
凡涉及交互行为的元素通常会有正常、悬停、点击和已浏览等不同样式,命名可参考以下规则:
鼠标悬停::hover 点击:click 已浏览:visited
如:搜索按钮: btn-search、btn-search-hover、btn-search-visited

目录命名
首先,目录的命名要清晰、简洁。通常,我们会按照业务模块来划分目录,例如“products”、“users”等。这样不仅方便管理,还能快速定位到相应的文件。
样式文件夹:css
脚本文件夹:js
样式类图片文件夹:img
图片命名
图片的命名同样重要。建议按照一定的顺序来命名,例如“product_1.jpg”、“product_2.jpg”,这样可以避免混乱。另外,如果图片涉及到不同的业务模块,可以在命名中加入相应的标识,例如“users_avatar.jpg”。
图片命名建议以下顺序命名
图片业务(可选)+ (mod_)图片功能类别(必选) + 图片模块名称(可选)+ 图片精度(可选)
图片功能类别:
mod_:是否公共,可选
icon:模块类固化的图标
logo:LOGO类
spr:但页面各种元素合并集合
btn:按钮
bg:可平铺或者大背景
HTML/CSS文件命名
对于HTML和CSS文件,命名要遵循一定的规则。HTML文件通常以“.html”结尾,而CSS文件则以“.css”结尾。在命名时,可以按照业务模块来划分,例如“products.html”、“users.css”。
主要的 master.css
布局,版面 layout.css
专栏 columns.css
文字 font.css
打印样式 print.css
主题 themes.css
控件样式 controls.css
全局样式 global.css
网站样式 site.css
样式统一出口 style.css

(1)颜色:使用颜色的名称或者16进制代码,如
.red { color: red; }
.f60 { color: #f60; }
.ff8600 { color: #ff8600; }
(2)字体大小,直接使用’font+字体大小’作为名称,如
.font12px { font-size: 12px; }
.font9pt {font-size: 9pt; }
(3)对齐样式,使用对齐目标的英文名称,如
.left { float:left; }
.bottom { float:bottom; }

另外在编辑样式表时可用的注释可这样写:
<– Footer –>
内容区
<– End Footer –>

ClassName命名
最后,ClassName的命名也是关键。建议使用有意义的命名,避免使用过于简单或模糊的名称。例如,可以使用“product-name”来代替“p-name”,这样更有助于代码的可读性和维护性。

ClassName含义
关于about
页头header
登录条loginbar
标志logo
商标brand
侧栏sidebar
广告banner
导航nav
次级的,子级的sub
顶部导航topnav
主导航mainnav
迷你导航mininav
导航文本textnav
子导航/二级导航subnav
图标icon
菜单menu
子菜单submenu
搜索search
滚动scroll
页面主体warpper
内容content
皮肤skin
表单from
购物区shop
标签页tab
列表/清单list
新闻列表newslist
下载列表downloadlist
图片列表piclist
下拉菜单dropmenv
圆角cor/corner
首页homepage
指南guild
提示信息msg
小技巧tips
栏目标题title
服务service
热点hot
新闻news
下载download
状态status
按钮btn
投票vote
友情链接link
页脚footer
版权copyright
网站地图sitemap
会员卡card
头像face/avatar
关闭close
登陆login
注册register
密码password
布局layout
大divbigdiv
左分栏leftdiv
右分栏rightdiv
左浮动leftfloat
右浮动rightfloat
mainbox
子页面/二级页面subpage
错误error
描述description
帮助help
分享share
提交submit
略图thumb
时间time
视频video
容器,包,一般用于最外层wrap
容器,包,一般用于最外层wrapper
成功(提示)success
模块module
更多(展开)more
作者author
工具条toolbar

以上标签同时适用亿坊CMS - https://www.yifangcms.com/docs/9/


http://www.kler.cn/a/517965.html

相关文章:

  • Objective-C语言的计算机基础
  • Windows 靶机常见服务、端口及枚举工具与方法全解析:SMB、LDAP、NFS、RDP、WinRM、DNS
  • Day39:列表的索引
  • 可见光通信代码仿真
  • 攻防世界bad_python
  • @RabbitListener处理重试机制完成后的异常捕获
  • windows在命令行中切换盘符
  • springboot中DTO、VO、Entity相互转换
  • 低代码系统-产品架构案例介绍、得帆云(九)
  • 如何用VSCODE配置C++多文件编译
  • three.js+WebGL踩坑经验合集(2):3D场景被相机裁切后,被裁切的部分依然可以被鼠标碰撞检测得到(射线检测)
  • 豆包MarsCode:小C的类二进制拼图
  • ansible自动化运维实战--yaml的使用和配置(7)
  • http请求获取客户端ip
  • Flink(十一): DataStream API (八) Checkpointing
  • Arduino大师练成手册 -- 读取DS18B20
  • MacOS安装Docker battery-historian
  • 编译安装PaddleClas@openKylin(失败,安装好后报错缺scikit-learn)
  • 知识体系_统计学_03_描述性统计_概括性度量
  • 2025数学建模美赛|B题成品论文
  • GraphRAG 简介
  • 「全网最细 + 实战源码案例」设计模式——原型模式
  • 使用 Docker Compose 一键启动 Redis、MySQL 和 RabbitMQ
  • Linux 常用命令——软件篇(保姆级说明)
  • 13.快速构建领域知识库的完整指南:结合 ChatGPT 与 Python 提升效率
  • kafka-部署安装