🌟
webpackというものを触ってみる - コンパイルにCSSを含める
はじめに
前回からの続きです。
今回はwebpackのコンパイルにCSSを含めてみたいと思います。
環境
- windows10 (wsl2)
- node(v16.18.0)
- yarn(1.22.19)
ディレクトリ構成やファイルの内容は前回の最後から引き続きです。
必要なモノをインストール
CSSを含める為に必要なツールをインストールします。
$ yarn add -D style-loader css-loader
各種設定
次に ./webpack.config.js
に設定を追加します。
./webpack.config.js
+ // モード
+ // development:ソースマップが有効
+ // production:コード圧縮
+ const MODE = "development";
+ // "development"の場合のみソースマップ有効
+ const enabledSourceMap = MODE === "development";
module.exports = {
- mode: "development",
+ mode: MODE,
devtool: "source-map",
// エントリーポイントのJs
entry: `./src/index.js`,
// コンパイルした結果を出力する先の設定
output: {
path: `${__dirname}/dist`,
filename: `main.js`
},
// webpack-dev-serverの設定
devServer: {
static: "dist", // 公開するルートディレクトリ
open: true, // サーバー起動後自動でブラウザ立ち上げ
// port: 8081 // ポートを指定したい場合に記述。 デフォルトは8080。
},
module: {
rules: [
{
test: /\.js$/,
use: [
{
// Babelの設定
loader: "babel-loader",
options: {
presets: [
"@babel/preset-env"
]
}
}
]
},
+ {
+ // CSSの設定
+ test: /\.css/,
+ use: [
+ "style-loader",
+ {
+ loader: "css-loader",
+ options: {
+ url: false,
+ sourceMap: enabledSourceMap
+ },
+ }
+ ]
+ }
]
},
// ES5(IE11等)向けにコンパイルする設定
target: ["web", "es5"]
}
CSSファイルを作成
次にCSSファイルを作成します。
./src/style/main.css
body {
background-color: #ddd;
color: #000;
}
ディレクトリ構成は以下となります。
$ tree -I node_modules
.
├── dist
│ ├── index.html
│ ├── main.js
│ ├── main.js.LICENSE.txt
│ └── main.js.map
├── package.json
├── src
│ ├── index.js
│ ├── js
│ │ ├── minus.js
│ │ └── sum.js
│ └── style
│ └── main.css
├── webpack.config.js
└── yarn.lock
4 directories, 11 files
./src/index.js
でCSSファイルをインポート
次に ./src/index.js
で用意したCSSファイルをインポートします。
./src/index.js
import { sum } from "./js/sum";
import { minus } from "./js/minus";
// jQueryをインポートして$で使える様にする。
import jQuery from "jquery";
const $ = jQuery;
+ // CSSファイルをインポートする。
+ // ※Jsのインポートとは異なり、拡張子も忘れずにつける。
+ import "./style/main.css"
sum();
sum(5, 4);
minus();
minus(4, 2);
$(() => {
$("#btn-alert").on("click", (e) => {
alert($("#message").val());
});
});
コンパイル
では、コンパイルしてみます。
コンパイル後のディレクトリ構成は以下となります。
$ tree -I node_modules
.
├── dist
│ ├── index.html
│ ├── main.js
│ ├── main.js.LICENSE.txt
│ └── main.js.map
├── package.json
├── src
│ ├── index.js
│ ├── js
│ │ ├── minus.js
│ │ └── sum.js
│ └── style
│ └── main.css
├── webpack.config.js
└── yarn.lock
4 directories, 11 files
CSSを含めたのにファイルが増えたりはしていませんが、 ./dist/main.js
の中に含まれています。
試しにファイルを開いて #ddd
で検索すると含まれている個所を確認する事ができるかと思います。
表示して確認
ローカルサーバーを起動しページの表示を確認して、背景色がグレー(#ddd)となっていれば用意したCSSファイルが反映されているという事になります。
開発者ツールで確認すると、 <style>
タグが追加され先程用意したCSSファイルの内容が記述されているのを見ることができます。
はじめに2つインストールしましたが以下の様な動きをしているそうです。
ツール | 役割 |
---|---|
style-loader | 画面表示時に <style> タグを埋め込む。 |
css-loader | コンパイル時にCSSファイルを読み込んでまとめる。 |
この時点でのディレクトリ構成等
$ tree -I node_modules
.
├── dist
│ ├── index.html
│ ├── main.js
│ ├── main.js.LICENSE.txt
│ └── main.js.map
├── package.json
├── src
│ ├── index.js
│ ├── js
│ │ ├── minus.js
│ │ └── sum.js
│ └── style
│ └── main.css
├── webpack.config.js
└── yarn.lock
4 directories, 11 files
package.json
{
"name": "20221014_webpack",
"version": "1.0.0",
"main": "index.js",
"license": "MIT",
"scripts": {
"build": "webpack",
"serve": "webpack serve"
},
"devDependencies": {
"@babel/core": "^7.19.3",
"@babel/preset-env": "^7.19.4",
"babel-loader": "^8.2.5",
"css-loader": "^6.7.1",
"style-loader": "^3.3.1",
"webpack": "^5.74.0",
"webpack-cli": "^4.10.0",
"webpack-dev-server": "^4.11.1"
},
"dependencies": {
"jquery": "^3.6.1"
}
}
webpack.config.js
// モード
// development:ソースマップが有効
// production:コード圧縮
const MODE = "development";
// "development"の場合のみソースマップ有効
const enabledSourceMap = MODE === "development";
module.exports = {
mode: MODE,
devtool: "source-map",
// エントリーポイントのJs
entry: `./src/index.js`,
// コンパイルした結果を出力する先の設定
output: {
path: `${__dirname}/dist`,
filename: `main.js`
},
// webpack-dev-serverの設定
devServer: {
static: "dist", // 公開するルートディレクトリ
open: true, // サーバー起動後自動でブラウザ立ち上げ
// port: 8081 // ポートを指定したい場合に記述。 デフォルトは8080。
},
module: {
rules: [
{
test: /\.js$/,
use: [
{
// Babelの設定
loader: "babel-loader",
options: {
presets: [
"@babel/preset-env"
]
}
}
]
},
{
// CSSの設定
test: /\.css/,
use: [
"style-loader",
{
loader: "css-loader",
options: {
url: false,
sourceMap: enabledSourceMap
},
}
]
}
]
},
// ES5(IE11等)向けにコンパイルする設定
target: ["web", "es5"]
}
おわりに
今回の作業でCSSファイルをJsファイルにまとめる事ができました。
これにより、画面を表示する際にCSSファイルをリクエストする必要がなくなります。
次回は、CSSのFWを導入してみたいと思います。
参考
Discussion