Html-inline-css-webpack-plugin NPM

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 -D

Yarn

yarn add html-inline-css-webpack-plugin -D

Minimal 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
  styleTagFactory?: (params: { style: string }) => string
  leaveCSSFile?: boolean
  replace?: {
    target: string
    position?: 'before' | 'after'
    removeTarget?: boolean
  }
}

filter(optional)

filter?: (fileName: string) => boolean

Return true to make current file internal, otherwise ignore current file. Include both css file and html file name.

example

...
new HTMLInlineCSSWebpackPlugin({
  filter(fileName) {
    return fileName.includes('main');
  },
}),
...

styleTagFactory(optional)

styleTagFactory?: (params: { style: string }) => string

Used to customize the style tag.

example

...
  new HTMLInlineCSSWebpackPlugin({
    styleTagFactory({ style }) {
      return `<style type="text/css">${style}</style>`;
    },
  }),
...

leaveCSSFile(optional)

if true, it will leave CSS files where they are when inlining

replace(optional)

replace?: {
  target: string
  position?: 'before' | 'after' // default is 'before'
  removeTarget?: 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

Please note that HTML comment is removed by default by the html-webpack-plugin in production mode. #16
example
<head>
    
    <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>

webpack webpack4 webpack5 webpack-plugin inline internal embedded document css style stylesheet

lodash tslib

@vdjurdjevic/generator-react-app builder-webpack4-vue builder-webpack-fourtwo builder-webpack-ydd webpack-build-pengcjun rvg-cli builder-webpack-shuimu @everything-registry/sub-chunk-1867 gsn-builder-webpack learning-builder-webpack ku-builder-webpack lx-webpack learn-webpack-build matt-builder-webpack @bluescloud/webpack-builder-test @ar0/reactor @digabi/exam-engine-rendering @enhanced-dom/webpack @heibanfe/pack @feflow/feflow-devkit-example @journeyapps/pdf-cli easy-creator-kukuxi fox-webpack-builder full-webpack first-webpack feflow-devkit-ivweb feflow-devkit-ivweb-example feflow-devkit-qmh-webpack4 feflow-devkit-react-startkit feflow-devkit-test feflow-devkit-webpack4-react feflow-devkit-xbc-webpack4 feflow-devkit-xbc-webpack4-react feflow-devkit-xbc-webpack5 my-project-builder-webpack npm-sebi-test-package my-build-webpack photosynthesis-for-you photosynthesis-two project-webpack react-builder-library ry-builder-webpack rsme rreact-builder-library react-webpack-builder sty-builder study-build-webpack study-my-project smallker_webpack_config simple-webpack-builder yuewen-pack yijiahao-webpack vtex-email-framework webpack-build-lgy webpack-build-zqt webpack-builder-demo webpack-builder-pub webpack-builder-test-lyh webpack-builder-tools webpack-config-dev webpack-config-jaid webpack-demo-test webpack-project-builder webpack-ycx webpack-package-yt webpack-template-letttgaco webpack_build_react xiaofeng-builder-webpack zby-builder-webpack @2fn/toolkit @infinitebrahmanuniverse/nolb-html-i @rockpack/compiler @react-app/react-scripts @sot.app/builder-webpack @steinwei/builder-webpack-demo al-webpack-builder build-webpack-cf build-webpack-jie build-webpack-w buil-webpack builder-webpack-ppl builder-webpack-react builder-webpack-react-laoce builder-webpack-sj builder-webpack-tang builder-webpack-test builder-webpack-tim builder-webpack-tmp builder-webpack-xwy builder-webpack-zh builder-webpack-amber builder-webpack-benyi builder-webpack-config builder-webpack-crane0 builder-webpack-zn builder-webpack-zpc builder-webpack4 builder-webpack4-react builder-webpack4-test builder_webpack_demo_tsl

10 months ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

4 years ago

4 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago