「译」- 使用Webpack更加智能的编译CSS

现在应该没人会把所有样式都写入一个超大的CSS里面了吧…

原文：Smarter CSS builds with Webpack

---

作为一个常常写CSS的开发人员，如果你接触过SMACSS、SUIT或BEM的话，应该会自然而然的将文件拆成更小更分散的模块。

stylesheets/
  config/
    colors.sass
    media_queries.sass
  modules/
    btn.sass
    dropdown.sass
    header.sass
  utilities/
    align.sass
    clearfix.sass

当你需要将这些编译成单个文件(如bundle.css)供用户下载时，你不得不手工指定应用需要哪些文件。

在SASS中，@import也许是这样的：

@import "vendor/normalize"

@import "config/colors"
@import "config/media_queries"

@import "modules/btn"
@import "modules/dropdown"
@import "modules/header"

@import "utilities/align"
@import "utilities/clearfix"

如果你使用过 Rail 或 Middleman，你一定对 Sprockets 的 //= require 语句不陌生:

//= require vendor/normalize
//= require_tree ./modules
//= require_tree ./utilities

或者可能你有自己的一套流水线，使用Gulp或Grunt去收集、处理与合并这些单独的文件：

gulp.task('styles', function () {
  gulp.src('styles/**/*.scss')
    .pipe(sass())
    .pipe(gulp.dest('./tmp'))
    .pipe(concat('bundle.css'))
    .pipe(autoprefixer())
    .pipe(gulp.dest('./build'));
});

所有的这些方式都有个前提，就是你需要知道哪些CSS是你的应用真正用到的，你不得不硬着头皮去维护一个无聊的依赖文件列表，或是干脆包含一整个目录的文件。

这样一来，你很有可能引入一些冗余的CSS，而且只能寄托于在偶尔编写HTML模板时候根据标签里的class name来发现并清理它们。（当然这里有一些很棒的工具可以帮到你，如：uncss）

无论如何，在HTML头部去维护一份CSS依赖，对于我来说，都是个无法忍受的事情。

不过不用担心，如果你使用Javascript模块来生成HTML，一切将迎刃而解（如果你还没这样做，不如趁早尝试这种来自未来的技术）。

使用Webpack引入UI依赖

用Webpack处理模块就像在耍瑞士军刀一样，一切都是为了让你在编写UI模块的时候能够更加精准的引入依赖。

或许你曾使用过CommonJS规范编写过模块：

var _ = require("underscore");

var findTastiestPizza = function (pizzas) {
  return _.find(pizzas, function (pizza) {
    return pizza === "hawaiian";
  });
};

module.exports = findTastiestPizza;

在NodeJS中用CommonJS依赖加载不是什么稀奇事，但是到了浏览器端，因为网络请求是异步的，所以比较麻烦，需要借助SeaJS、requireJS。

为了让我们的模块能跑在浏览器上，我们得使用Webpack或Browserify来将我们页面的所有依赖都打包成单个文件。

可是UI组件不仅仅包含JS，还有CSS、图片甚至字体，Webpack认识到了这点，得益于它的loader机制，使require语法强大到能够精准的引用你需要的任何依赖，而不仅仅是一个单纯的JS文件：

require("stylesheets/modules/btn");
var img = require("images/default_avatar.png");

嗯，让我们回到我们最初的问题，如何使用程序更加智能的生成bundle.css，一个基于HTML真正使用到的CSS，脱离之前手工维护列表的苦海。

所有你需要做的就是在模板视图中声明你的CSS和SASS依赖，就像声明JS依赖一样，Webpack将生成最终你需要的所有内容，当然，如果需要，还可以对内容进行预先处理或后置加工。

举个栗子，为我们的应用声明一个加载点：

// index.js
var React = require("react");
var Header = require("./header");
var Footer = require("./footer");

var Page = React.createClass({
  render () {
    return (
      <div>        <Header />        <Footer />      </div>    );
        <Header />
        <Footer />
      </div>
    )
  }
});

React.render(<Page />, document.querySelector("#main"));

…而那些引入的子模块，它们自身声明了自己所需的SASS依赖…

// header.js
var React = require("react");

require("stylesheets/modules/header");

var Header = React.createClass({
  render () {
    return (
      <div className="header">        Header      </div>    );
        Header
      </div>
    )
  }
});

module.exports = Header;

// footer.js
var React = require("react");

require("stylesheets/modules/footer");
require("stylesheets/utilities/clearfix");

var Footer = React.createClass({
  render () {
    return (
      <div className="footer u-clearfix">        Footer      </div>    );
        Footer
      </div>
    )
  }
});

module.exports = Footer;

…Webpack 最终将生成的像下面这样的CSS文件

.header { /* ... */ }
.footer { /* ... */ }
.u-clearfix { /* ... */ }

你看，是不是很神奇！

其它的一些秘密

不再依赖代码书写顺序

值得注意的是，使用这种方式你将无法像手动模式那样组织代码顺序，Webpack将以你指定的require顺序生成代码，就像叠叠乐一样。

所以当我们改变 header和footer 模块的依赖顺序…

// index.js
var Footer = require("footer");
var Header = require("header");

footer 模块的依赖的样式内容，以及footer中包含的.u-clearfix样式（clearfix），将首先生成出来：

.footer { /* ... */ }
.u-clearfix { /* ... */ }
.header { /* ... */ }

通常我们在手工维护一个CSS依赖列表时候会根据不同功能类型来进行特定排序，如：

• base
• modules
• utilities

这些顺序确保了样式间的相互覆写正常。

现在，你无法继续依赖手工排序了，所以你必须更加谨慎的书写你的样式。

我就从来都不喜欢被代码顺序牵着走，我通常会避免在不同的文件中声明相同一个HTML元素的样式，但是有些特殊情况会出现在几个class中都声明了相同的样式属性，不得已的时候你可能会写成这样：

<div class="footer u-clearfix">

这个例子中你需要对这些选择器的处理非常小心才行，SUIT 推荐使用 !important 来处理这种情况，或者你可以试试这种多重指定class的HACK方式来提高优先级。

关于SASS全局声明

如果你使用SASS的@import处理你的样式，你可能还需要在各个模块共享你的变量和mixin声明，那么你可能会写过这样的代码：

@import "config/variables"@import "mixins/vertical_align"@import "modules/header"@import "modules/footer"
@import "mixins/vertical_align"

@import "modules/header"
@import "modules/footer"

这样一来跟随在后面的模块都可以共享到config和mixins的内容。

在Webpack的世界里，每一个sass文件都是隔离编译的，这不无道理，但我觉得有个好的办法来处理这种事情，那就是在你需要引入变量和mixins的地方手动引入它们：

// header.sass
@import "config/colors"

.header
  color: $red

// footer.sass
@import "config/colors"

.footer
  color: $blue

各文件明确指定了自己要的依赖，在我看来，非常轻巧，非常棒！

最最有价值的留在最后

我在Github上创建了一个例子供大家把玩，当然别忘了Star一下 :)

---

译文之外

还有一篇不错的 Webpack for react 的book，其中也有关于sass、less的相关配置，可以参考一下 :)