html-inline-css-webpack-plugin-wilddog
v1.3.3
Published
☄️ A webpack plugin for convert external stylesheet to embedded stylesheet, aka document stylesheet
Downloads
16
Maintainers
jim-dogReadme
Fork of: https://github.com/Runjuu/html-inline-css-webpack-plugin
html-inline-css-webpack-plugin
Convert external stylesheet to embedded stylesheet, aka document stylesheet.
<link rel="stylesheet" /> => <style>...<style/>Require mini-css-extract-plugin and html-webpack-plugin
Install
NPM
npm i html-inline-css-webpack-plugin -DYarn
yarn add html-inline-css-webpack-plugin -DMinimal example
const MiniCssExtractPlugin = require("mini-css-extract-plugin");
const HtmlWebpackPlugin = require('html-webpack-plugin');
const HTMLInlineCSSWebpackPlugin = require("html-inline-css-webpack-plugin").default;
module.exports = {
plugins: [
new MiniCssExtractPlugin({
filename: "[name].css",
chunkFilename: "[id].css"
}),
new HtmlWebpackPlugin(),
new HTMLInlineCSSWebpackPlugin(),
],
module: {
rules: [
{
test: /\.css$/,
use: [
MiniCssExtractPlugin.loader,
"css-loader"
]
}
]
}
}Config
interface Config {
filter?(fileName: string): boolean
replace?: {
target: string
position?: 'before' | 'after'
removeTarget?: boolean
leaveCssFile?: boolean
}
}filter(optional)
filter?(fileName: string): booleanReturn true to make current file internal, otherwise ignore current file.
example
...
new HTMLInlineCSSWebpackPlugin({
filter(fileName) {
return fileName.includes('main');
},
}),
...replace(optional)
replace?: {
target: string
position?: 'before' | 'after' // default is 'before'
removeTarget?: boolean // default is false
leaveCssFile?: boolean // default is false
}A config for customizing the location of injection, default will add internal style sheet before the </head>
target
A target for adding the internal style sheet
position(optional)
Add internal style sheet before/after the target
removeTarget(optional)
if true, it will remove the target from the output HTML
leaveCssFile(optional)
if true, it will leave CSS files where they are when inlining
example
<head>
<!-- inline_css_plugin -->
<style>
/* some hard code style */
</style>
</head>...
new HTMLInlineCSSWebpackPlugin({
replace: {
removeTarget: true,
target: '<!-- inline_css_plugin -->',
},
}),
...output:
<head>
<style>
/* style from *.css files */
</style>
<style>
/* some hard code style */
</style>
</head>