Skip to content

r0skar/rollup-plugin-bundle-html

 
 

Repository files navigation

rollup-plugin-bundle-html

This plugin inject the bundle js file as well as external js files to html template. This plugin extends from rollup-plugin-fill-html to provide more flexibility for injecting files.

Installation

yarn add --dev rollup-plugin-bundle-html

or

npm install -D rollup-plugin-bundle-html

Usage

import html from 'rollup-plugin-bundle-html';

export default {
  input: 'src/main.js',
  output: {
    file: 'dist/foo/bundle.js',
  },        
  plugins: [
    html({
        template: 'src/template.html',
        // or html code: '<html><head></head><body></body></html>'
        dest: "dist/foo",
        filename: 'index.html',
        inject: 'head',
        externals: [
            { type: 'js', file: "file1.js", pos: 'before' },
            { type: 'js', file: "file2.js", pos: 'before' }
        ]
    })
  ]
};
<!-- src/template.html -->
<html>
  <head>
  </head>
  <body>
  </body>
</html>

<!-- dist/foo/index.html -->
<html>
  <head>
    <script type="text/javascript" src="../../file1.js"></script>
    <script type="text/javascript" src="../../file2.js"></script>
    <script type="text/javascript" src="bundle.js"></script>
  </head>
  <body>
  </body>
</html>

Hash

You can set string '[hash]' for output file in rollup.config.js, and your bundle and source map (if you turned on sourcemap option) will have the string '[hash]' be replaced by its hash.

export default {
  input: 'src/main.js',
  output: {
    file: 'dist/foo/bundle-[hash].js',
    // Turn on sourcemap
    sourcemap: true  
  },        
  plugins: [
    ...
  ]
};

You will find both bundle and map files are hashed and placed in your dist/foo folder: bundle-76bf4fb5dbbd62f0fa3708aa3d8a9350.js, bundle-84e0f899735b1e320e625c9a5c7c49a7.js.map

Options

You can pass an option to the html() just like above, and there are some options:

  • template: Required. either path or code string of the template file, template should be a html file.
  • filename: Optional if 'template' is a path. the name of the result html file, if omitted, will use name in template as file name.
  • externals: Optional. a list of files which will be insert into the resule html. The file should be a valid url.
    • externals.file: file path.
    • externals.type: the type of file. can be 'js' or 'css'.
    • externals.pos: position where the file is inserted.
    • externals.timestamp: append timestamp as query string to file path.
  • inject: Optional. indicate where to insert files, it can be 'head' or 'body'. For default, the css files will be inserted into <head> and the js files will be inserted into <body>.
  • defaultmode: Optional. specify a value to use in the script type attribute. If no mode is specified, the type attribute is omitted. Externals can optionally override this per file.
  • dest: Optional. the folder in which js file is searched and be injected to html file.

License

MIT

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%