0.0.4 • Published 5 years ago
rollup-plugin-rhtml v0.0.4
rollup-plugin-rhtml
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
npm install -D rollup-plugin-rhtml
Usage
import html from 'rollup-plugin-rhtml';
export default {
input: 'src/main.js',
output: {
file: 'dist/foo/bundle.js',
},
plugins: [
html({
template: 'src/template.html',
dest: "dist/foo",
filename: 'index.html',
inject: 'head',
externals: [
{ type: 'js', file: "file1.js", pos: 'before' },
{ type: 'js', file: "file2.js", pos: 'before' }
],
htmlMinifierOptions: {
collapseWhitespace: true,
collapseBooleanAttributes: true,
conservativeCollapse: true,
minifyJS: true
}
})
]
};
<!-- 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. the path of the template file, it should be a html file.
- filename: Optional. the name of the result html file, if omitted, the template name will be used.
- htmlMinifierOptions: Optional. Compress HTML. The options which are given to html-minifier
- 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, thetype
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