css BEM 编写规范
[规范]css BEM书写规范
BEM是基于组件的web开发方法。其思想是将用户界面分隔为独立的块,从而使开发复杂的UI界面变得更简单和快,且不需要粘贴复制便可复用现有代码。 BEM由Block、Element、Modifier组成。 选择器里用以下连接符扩展他们的关系:
- `__:双下划线用来连接块和块的子元素
- `- :仅作为连字符使用,连接块或元素或修饰符的多个单词(也可以直接写成驼峰式)
- --:双中划线用来连接块或元素的状态(也可使用‘_’单下划线表示,本文以'--'方式介绍)
示例: block-name_modifier-name block-name__element-name--modifier-name block-name_modifier-name--modifier-value block-name__element-name--modifier-name--modifier-value 代码里能出现的样式组合只能是B B__E B--M B__E--M B__E--M--M,
基本概念
Block(块)
代码片段可能被复用且这段代码不依赖其他组件即可用Block。块可以互相嵌套,可以嵌套任意多层。
特点:
- 块的名称用于描述它的目的。如 menu、button(而不是它的状态,如:red、big)
- 块不能影响所在环境。这意味着不能为块设置margin或position
- 只能使用class命名选择器,而不能使用标签或id选择器
- 不依赖于页面内其他块或元素
Element(元素)
Element是Block的一部分,没有独立存在的意义。任何一个Element语义上是和Block绑定的。
特点:
- 与块使用'__'连接。 如: block__item
- 用于描述它的目的。如:item、text
- 元素可以彼此嵌套,可以嵌套任意多层
- 元素总是属于块的一部分。所以类似于block__item1__item2的命名是不合法的
Modifier(修饰符)
定义Block或Element的外观、状态、或行为的标记。
特点:
- 与块或元素连接符为'--'
- Modifier描述的是它的外观(如”什么尺寸“或”什么主题“等,如size_s或theme——islands),状态(”它与其他的哪里不同“,如disabled,focused等)以及它的行为(”它有怎么样的行为“或”它是怎么对用户响应“,如directions_left-top)
Modifiers分类
Modifiers可以看成是2种类型,key:true;key:value;即某个状态,或某个状态是什么值。
Boolean:
- 只有当Modifiers的存在与否很重要时使用,这里它的值默认是true。例如,disabled、active、clickable。
- 这种类型下样式的结构是:
- block-name--modifier-name
- block-name__element-name--modifier-name
例如:
<form class="search-form search-form--focused">
<input class="search-form__input">
<!-- The `button` element has the `disabled` Boolean modifier -->
<button class="search-form__button search-formbutton__button--disabled">Search</button>
</form>
key-value:
- 当Modifiers的value才能描述完整一个状态时,需要使用key-value.例如: ”一个以islands为主题的菜单“,menu--theme--islands。
- 这种类型下样式的结构是:
- block-name_modifier-name--modifier-value
- block-name__element-name--modifier-name--modifier-value 例如:
<!-- The `search-form` block has the `theme` modifier with the value `islands` -->
<form class="search-form search-form--theme--islands">
<input class="search-form__input">
<!-- The `button` element has the `size` modifier with the value `m` -->
<button class="search-form__button search-form__button--size--m">Search</button>
</form>
</form>
Mix
一种在一个DOM节点上使用不同BEM的方法。 Mixes能够做到:
- 组合不同实体的行为和样式,而不需要复制代码
- 基于现有的组件组合创造出新的组件 例如:
<!-- `header` block -->
<div class="header">
<!--
The `search-form` block is mixed with the `search-form` element
from the `header` block
-->
<div class="search-form header__search-form"></div>
</div>
通过在search-form Block本身是不能设置position或margin,放在header里后,可以作为header的元素,我们在header__search-form上可以设置它的位置信息。所以写组件的时候,可以为组件预留一个className props。
应用
相对另外的Blocks定位Block
最好的方式是混合使用block和element。解决block上不能设置margin、position。 例:
<body class="page">
<!-- header and navigation-->
<header class="header page__header">...</header>
<!-- footer -->
<footer class="footer page__footer">...</footer>
</body>
.page__header {
padding: 20px;
}
.page__footer {
padding: 50px;
}
Block内定位Elements
通过额外创建Block的子Element来定位嵌套。 例:
<body class="page">
<div class="page__inner">
<!-- header and navigation-->
<header class="header">...</header>
<!-- footer -->
<footer class="footer">...</footer>
</div>
</body>
.page__inner {
margin-right: auto;
margin-left: auto;
width: 960px;
}
关于命名
选择器的命名必须完整且精确地描述它代表的BEM实体。 例:
.button {}
.button__icon {}
.button__text {}
.button--theme--islands {}
我们可直接指导我们在处理一个块元素。在html使用如:
<button class="button button_theme_islands">
<span class="button__icon"></span>
<span class="button__text">...</span>
</button>
而下面的css就很难让我们做出相同的判断:
.button {}
.icon {}
.text {}
.theme--islands {}
一些问题
- 最小化选择器的嵌套(建议不超过2级)。嵌套的场景可以出现在有modifier时,Block或Element需要修改样式
- BEM本身是可以写成B__E__E的格式,但如果出现这种嵌套很深的情况,说明组件化设计有问题,所以代码开发中,要求不能写这种格式代码
- 不要使用id选择器或tag选择器
- 不要在Block中设置position、margin等位置布局相关设置。把可能发生变化的css属性放到Modifiers上
- 从使用角度,小图标使用
icon-
做前缀,不需使用BEM - 命名空间问题。目前我们要求页面以
page-
作为Block,组件以组名名作为Block。css-guidelines中提出类似BEM命名的方式,以一些前缀作为标识。
注意: 1、BEM中的命名嵌套和DOM不是严格绑定的,命名上不要使用B__E__E,但是写DOM时和样式没有关系。B__E下的DOM里仍然可以有B__E样式的DOM.命名规范是用于识别顶层块组件之间的关系。 例如:
<div class="menu">
<div class="menu__header">
<h2 class="menu__title">Title text here</h2>
</div>
<div class="menu__body">
<img class="menu__img" src="img.png" alt="description" />
<p class="menu__text">text</p>
<p class="menu__text">
<a href="test.html" class="menu__link">link</a>
</p>
</div>
</div>
参考: en.bem.info
上一篇: 干货BEM 的 CSS 编写策略
下一篇: js 选择结束-小节
推荐阅读
-
css BEM 编写规范
-
干货BEM 的 CSS 编写策略
-
关于 CSS 编码规范的思考
-
35 岁实现财务*,腾讯程序员手握2300万提前退休?-1000万房产、1000万腾讯股票、加上300万的现金,一共2300万的财产。有网友算了一笔账,假设1000万的房产用于自住,剩下1300万资产按照平均税后20-50万不等进行计算,大约花上26-60年左右的时间才能赚到这笔钱。也就是说,普通人可能奋斗一辈子,才能赚到这笔钱。在很多人还在为中年危机而惶惶不可终日的时候,有的人的35岁,就已经安全着陆,试问哪个打工人不羡慕?但问题是有这样财富积累必然有像样的实力做靠山。没有人可以不劳而获。 看到这里,肯定有人说,那么对于普通人来说,卷可能真就成了唯一的出路。但是卷也有轻松的卷,“偷懒”的卷法,对于程序员而言,刨除掉一时无法改掉的开会传统占用的大部分时间,如何把有限的时间和精力放在真正重要的架构设计、需求设计上,而不是重复的造*,编码、改bug、手动测试。因此在科技改变生活的今天,学会使用AI工具成为程序员们的必备技能。 以全栈式全自动的软件开发工具飞算SoFlu软件机器人为例,作为全球首款面向微服务架构设计和最佳实践的软件机器人,SoFlu软件机器人改变了原来手工编码的作业模式,通过可视化拖拽方式以及参数配置就能实现等同于编写复杂代码的业务逻辑,在设计业务逻辑时就完成了微服务应用开发,做到“业务即图,图即代码”,实现“软件开发,十倍提效”。 而作为飞算SoFlu软件机器人的一个重要组成部分,FuncGPT(慧函数)支持所有类型函数创建。通过自然语言描述Java函数需求,实时生成高质量、高可读性的Java函数代码。生成代码可直接复制到IDEA,或一键导入Java全自动开发工具函数库。 FuncGPT(慧函数)具有五大核心能力: ● 自然语言:通过自然语言即可生成函数,降低软件开发门槛。 ● 秒级函数开发:全自动秒级开发函数,秒级完成,效率千倍提升。 ● 一站式函数开发应用:函数生成即可直接应用,效率、安全有保障。 ● 质量可靠:生成的函数代码符合业界规范、具备良好的可读性,符合最优解。 ● 灵活生成:可以根据开发人员的具体需求生成并支持调整和修改。 以“将文件流转换为File对象”这个需求为例,以下是FuncGPT(慧函数)秒级生成的代码: / 类名:FileConverter // 函数名:convertStreamToFile // 函数功能:将文件流转换为File对象 // POM依赖包:无 import java.io.File; import java.io.FileOutputStream; import java.io.IOException; import java.io.InputStream; public class FileConverter { /** * 将文件流转换为File对象 * @param inputStream 文件流 * @param filePath 文件路径 * @param fileName 文件名 * @return 转换后的File对象 * @throws IOException 如果发生I/O异常 */ public static File convertStreamToFile(InputStream inputStream, String filePath, String fileName) throws IOException { File file = new File(filePath + File.separator + fileName); // 创建File对象 try (FileOutputStream outputStream = new FileOutputStream(file)) { // 创建文件输出流 byte buffer = new byte[1024]; int bytesRead; while ((bytesRead = inputStream.read(buffer)) != -1) { // 从文件流读取数据并写入文件 outputStream.write(buffer, 0, bytesRead); } } return file; // 返回转换后的File对象 } } // 函数示例 // 将文件流转换为File对象示例 // 入参:inputStream,文件流 // 入参:filePath,文件路径 // 入参:fileName,文件名 // 出参:file,转换后的File对象 // 调用示例: // InputStream inputStream = new FileInputStream("example.txt"); // String filePath = "C:\\Users\\User\\Documents"; // String fileName = "example.txt"; // File file = FileConverter.convertStreamToFile(inputStream, filePath, fileName); // System.out.println(file.getAbsolutePath); // 输出结果:例如,将文件流转换为File对象后,文件的绝对路径为:C:\Users\User\Documents\example.txt // 则输出结果为:C:\Users\User\Documents\example.txt 通过分析,不难发现以上代码:
-
对模块接口、本地数据结构、路径、边界条件、错误处理、代码编写规范进行单元测试
-
为个人电脑、手机和平板电脑编写自适应 CSS(媒体查询)
-
css 如何编写六边形 - 教您使用 CSS 绘制正六边形
-
如何编写规范的 JavaScript URL
-
Bootstrap CSS 编码规范
-
谷歌 HTML/CSS 规范