项目作者: KyLeoHC

项目描述 :
A webpack plugin to embed css/js resource in the html.
高级语言: JavaScript
项目地址: git://github.com/KyLeoHC/inline-source-webpack-plugin.git
创建时间: 2018-08-02T04:08:54Z
项目社区:https://github.com/KyLeoHC/inline-source-webpack-plugin

开源协议:MIT License

下载


npm Version
Build Status
Codecov

inline-source-webpack-plugin

A webpack plugin to embed css/js resource in the html with inline-source module(html-webpack-plugin is needed).

Install

  1. $ npm i inline-source-webpack-plugin -D

example

  1. <!-- ./demo/src/index.html -->
  2. <!DOCTYPE html>
  3. <html lang="en">
  4. <head>
  5. <meta charset="UTF-8">
  6. <title>test</title>
  7. <link href="inline.css" inline="true">
  8. <script src="inline.js" inline="true"></script>
  9. </head>
  10. <body>
  11. <div class="container">
  12. <h1>hello world!</h1>
  13. </div>
  14. <!-- 'inline-asset' attribute tell us to embed file that generated by webpack -->
  15. <script inline inline-asset="runtime\.\w+\.js$" inline-asset-delete></script>
  16. <script inline inline-asset="bundle\.\w+\.js$" inline-asset-delete></script>
  17. </body>
  18. </html>

You can find this demo in the demo directory and view the output:

  1. # install dependency
  2. npm i
  3. # build demo
  4. npm run build:demo

Usage

Available options include(refer to this for more options):

  • compress: enable/disable compression.(default false)
  • rootpath: path used for resolving inlineable paths.
  • noAssetMatchReplace: work with noAssetMatch option.(default <!-- -->)
  • noAssetMatch: define the behaviour while no asset match the value of inline-asset attribute.(default none)
    • none: do nothing and the tag is still reserved in the html.
    • warn: throw warning tips and replace the tag with the content of noAssetMatchReplace option.
    • error: throw error tips and replace the tag with the content of noAssetMatchReplace option(This level will affect the compilation of webpack).
  1. // webpack.config.js
  2. const HtmlWebpackPlugin = require('html-webpack-plugin');
  3. const InlineSourceWebpackPlugin = require('inline-source-webpack-plugin');
  4. module.exports = {
  5. ...,
  6. plugins: [
  7. new HtmlWebpackPlugin({
  8. ...
  9. }),
  10. new InlineSourceWebpackPlugin({
  11. compress: true,
  12. rootpath: './src',
  13. noAssetMatch: 'warn'
  14. })
  15. ]
  16. };

If you want to embed the files that generated by webpack or other plugin, you can use inline-asset attribute to filter the files(Please don’t try to use src or href).
Add inline-asset-delete attribute for deleting the asset after inline task.

  1. <script inline inline-asset-delete inline-asset="Your asset path/Your asset name"></script>

The value of inline-asset attribute is a regular expression.

Note: For inline-asset feature, you may notice the ‘no asset match’ warning or error in developement mode as you write the regular expression for the production mode.Just ignore the ‘no asset match’ warning or error while in developement mode.Or you can provide noAssetMatch option for ignoring the warning or error;

License

MIT License