【Webpack2+Django】使用extract-text-webpack-plugin分离样式文件

优化前

webpack配置了两个入口,一个是app.js,一个是vendors(包括 react 等第三方插件)。打包生成的JS文件对应有两个:app-[hash].jsvendors.js

这种情况下,样式文件都被打包到了 app-[hash].js里面。而且这时候我们还没有做按需加载,所以这个文件会比较大,网页初次加载的时候花的时间很长。

优化后

使用插件 extract-text-webpack-plugin把样式从JS文件中分离出来,生成一个单独的CSS文件(竟然快1Mb了...),再引入到 HTML 中。打开页面的时候,app-[hash].jsvendors.js和这个CSS文件会被异步加载,节省时间。

优化过程

首先安装插件:
npm install --save-dev extract-text-webpack-plugin
修改 webpack 配置文件,先添加plugin

const ExtractTextPlugin = require('extract-text-webpack-plugin');
module.exports = {
... ...
  plugins: [
      ... ...
      new ExtractTextPlugin({ //样式文件单独打包
        filename: "app.css",  //指定生成的文件名称
        disable: false,  //是否禁用此插件
        allChunks: true
      })
   ],
}

注意,如果是 Django 项目,样式名称需要跟打包生成的其中一个模块名一样,这样才能在 templates中引入。比如这里我们命名为app.css
然后修改CSS和LESS文件的loader

module: {
    rules:[
        {
          test: /\.css$/, 
          use: ExtractTextPlugin.extract({
            fallback:'style-loader',
            use:['css-loader', 'postcss-loader'],
          })
        },
        {
          test: /\.less$/i,
          use: ExtractTextPlugin.extract({
            fallback:'style-loader',
            use:['css-loader', 'less-loader'],
          })
        },
        ... ...
    ] // add all common loaders here
},

这是 Webpack 2 的配置了。Webpack 1 的 loader 格式跟上面的有一点区别。
配置修改完成了,再打包就会出现一个 app.css的文件。

接下来只需要在HTML头部引入(如果不在意引入css的位置可以忽略以下的步骤)。

我们后端使用的Django框架,所以需要在templates中引入。
修改前的 template

{% load render_bundle from webpack_loader %}
<!doctype html>
<html lang="en">
<head>
    ......
</head>
<body>
......
{% render_bundle 'vendors' %}
{% render_bundle 'app' %}
</body>
</html>

修改后:

{% load render_bundle from webpack_loader %}
<!doctype html>
<html lang="en">
<head>
    {% render_bundle 'app' 'css' %}
</head>
<body>
<div id="app"></div>
{% render_bundle 'vendors' %}
{% render_bundle 'app' 'js' %}
</body>
</html>

具体修改:先指定在<body>中只引入app bundle 的 js 文件:
{% render_bundle 'app' 'js' %}
然后在head中引入app bundle对应的 css 文件:
{% render_bundle 'app' 'css' %}

到这就ok了。

django-webpack-loader的使用说明中写到了这个用法:

render_bundle will render the proper <script> and <link> tags needed in your template.
render_bundle also takes a second argument which can be a file extension to match. This is useful when you want to render different types for files in separately.

也就是说, render_bundle会在template中生成与bundle对应的 js 和 css 文件的 <script><link> 标签。

而第二个可选参数用于指定引入的文件类型,如果不指定的话,默认两个都会在指定位置生成。比如在分离CSS文件之后,如果不修改templates,生成的HTML部分如下图:

不指定文件类型参数时,在<body>末尾引入

踩过的坑

  1. 注意CSS文件的名称

在这种情况下,只能是app.cssvendors.css。也就是必须跟打包输出的bundle中的其中一个同名。否则在打开页面时会提示找到不到名称为XXX的bundle之类的错误。

  1. 不要在template中直接用<link>标签引入导出的样式文件

一开始我尝试直接用<link>标签引入导出的样式文件,但是这样没有成功,因为webpack开发模式和生产模式请求静态文件的路径不同。而django-webpack-loader会帮我们根据配置生成不同的路径。
比如{% render_bundle 'app' 'css' %}在开发模式时会生成如下内容:

<link type="text/css" href="http://localhost:3000/assets/bundles/app.css" rel="stylesheet"/>

而在生产模式时会生成:

<link type="text/css" href="/static/bundles/prod/app.css" rel="stylesheet"/>

这些路径对应开发模式的webpack配置:

config.output.publicPath = 'http://' + ip + ':3000' + '/assets/bundles/';

和 Django 配置文件中指定的静态文件目录STATICFILES_DIRS,和bundle目录WEBPACK_LOADER

WEBPACK_LOADER = {
    'DEFAULT': {
        'BUNDLE_DIR_NAME': 'bundles/prod/',  # change when production
        'STATS_FILE': os.path.join(BASE_DIR, 'webpack-stats-prod.json'),  # change when production
    }
}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,884评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,755评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,369评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,799评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,910评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,096评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,159评论 3 411
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,917评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,360评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,673评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,814评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,509评论 4 334
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,156评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,882评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,123评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,641评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,728评论 2 351

推荐阅读更多精彩内容

  • 无意中看到zhangwnag大佬分享的webpack教程感觉受益匪浅,特此分享以备自己日后查看,也希望更多的人看到...
    小小字符阅读 8,147评论 7 35
  • 学习流程 参考文档:入门Webpack,看这篇就够了Webpack for React 一. 简单使用webpac...
    Jason_Zeng阅读 3,123评论 2 16
  • 目录第1章 webpack简介 11.1 webpack是什么? 11.2 官网地址 21.3 为什么使用 web...
    lemonzoey阅读 1,731评论 0 1
  • 白鹤不亮翅阅读 443评论 0 1
  • 大一 大一的生活很轻松,开始去参加各种活动,去挑战各种自我,那时候还挺开心的,也开始发现自己的各种缺点。还记得去社...
    Grea阅读 230评论 0 0