css module

通过命名规范来限制类名太过死板，而 css in js 虽然足够灵活，但是书写不便。 css module 开辟一种全新的思路来解决类名冲突的问题

思路

css module 遵循以下思路解决类名冲突问题：

css 的类名冲突往往发生在大型项目中
大型项目往往会使用构建工具（webpack 等）搭建工程
构建工具允许将 css 样式切分为更加精细的模块
同 JS 的变量一样，每个 css 模块文件中难以出现冲突的类名，冲突的类名往往发生在不同的 css 模块文件中
只需要保证构建工具在合并样式代码后不会出现类名冲突即可

实现原理

在 webpack 中，作为处理 css 的 css-loader，它实现了 css module 的思想，要启用 css module，需要将 css-loader 的配置modules设置为true。

css-loader 的实现方式如下：

原理极其简单，开启了 css module 后，css-loader 会将样式中的类名进行转换，转换为一个唯一的 hash 值。

由于 hash 值是根据模块路径和类名生成的，因此，不同的 css 模块，哪怕具有相同的类名，转换后的 hash 值也不一样。

如何应用样式

css module 带来了一个新的问题：源代码的类名和最终生成的类名是不一样的，而开发者只知道自己写的源代码中的类名，并不知道最终的类名是什么，那如何应用类名到元素上呢？

为了解决这个问题，css-loader 会导出原类名和最终类名的对应关系，该关系是通过一个对象描述的

这样一来，我们就可以在 js 代码中获取到 css 模块导出的结果，从而应用类名了

style-loader 为了我们更加方便的应用类名，会去除掉其他信息，仅暴露对应关系

其他操作

全局类名

某些类名是全局的、静态的，不需要进行转换，仅需要在类名位置使用一个特殊的语法即可：

css

:global(.main) {
  ...;
}

使用了 global 的类名不会进行转换，相反的，没有使用 global 的类名，表示默认使用了 local

css

:local(.main) {
  ...;
}

使用了 local 的类名表示局部类名，是可能会造成冲突的类名，会被 css module 进行转换

如何控制最终的类名

绝大部分情况下，我们都不需要控制最终的类名，因为控制它没有任何意义

如果一定要控制最终的类名，需要配置 css-loader 的localIdentName

其他注意事项

css module 往往配合构建工具使用
css module 仅处理顶级类名，尽量不要书写嵌套的类名，也没有这个必要
css module 仅处理类名，不处理其他选择器
css module 还会处理 id 选择器，不过任何时候都没有使用 id 选择器的理由
使用了 css module 后，只要能做到让类名望文知意即可，不需要遵守其他任何的命名规范

实践

html

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta http-equiv="X-UA-Compatible" content="ie=edge" />
    <title>Document</title>
  </head>

  <body>
    <div>asdfasdfasf</div>
    <div class="div1">Lorem ipsum dolor sit.</div>
  </body>
</html>

css

.c1 {
  color: red;
}

.c2 {
  font-size: 18px;
}

css

.c1 {
  color: #ccc;
}

.c2 {
  font-size: 20px;
}

const style1 = require("./assets/style1.css");
const style2 = require("./assets/style2.css");

/* 
对css module的使用很简单
1.css-loader内部实现了css module的规范,只需要给css-loader配置项开启modules选项
2.style-loader又对css-loader的返回做了处理,引入css模块的时候，会给出一个对应hash的配置对象
3.添加类名的时候使用即可。
*/
console.log(style1);
console.log(style2);
const div = document.querySelector(".div1");
div.className = `${style1.c1} ${style1.c2}`;

/* 
注意
1.只会对类名进行hash话，对id,标签选择器不会
2.我们写类名的时候不需要再使用嵌套了，只需要对起的类名望文生义即可
*/

const HtmlWebpackPlugin = require("html-webpack-plugin");

module.exports = {
  mode: "development",
  devtool: "source-map",
  devServer: {
    open: true,
  },
  //
  module: {
    //常用的是这种配置
    rules: [{ test: /\.css$/, use: ["style-loader", "css-loader?modules"] }],
    // rules: [
    //   {
    //     test: /\.css$/,
    //     use: [
    //       "style-loader",
    //       {
    //         loader: "css-loader",
    //         options: {
    //           modules: {
    //             // 控制输出的name格式
    //             localIdentName: "[local]-[hash:5]",
    //           },
    //         },
    //       },
    //     ],
    //   },
    // ],
  },
  //
  plugins: [
    new HtmlWebpackPlugin({
      template: "./public/index.html",
    }),
  ],
  //
  stats: {
    colors: true, //输出信息带颜色
    modules: false, //是否输出打包的文件
  },
};

css module ​

思路 ​

实现原理 ​

如何应用样式 ​

其他操作 ​

全局类名 ​

如何控制最终的类名 ​

其他注意事项 ​

实践 ​