vite-html-plugin
This package is a new feature version of vite-html
Features
- Support ejs template
- Html entry alias
- Inject js
Usage
Basic
import html from 'vite-html-plugin'
export default {
plugins: [
html(/* options | options[] */),
]
}Multi-Page
├─┬ public
│ ├── foo.html
│ └── bar.ejs.html
│
├─┬ src
│ ├── foo.js
│ └── bar.js
│
└── vite.config.js
html([
{
// Equivalent to
// { 'foo.html': 'public/foo.html' }
template: 'public/foo.html',
inject: '/src/foo.js',
},
{
template: {
// Alias
'bar.html': 'public/bar.ejs.html',
},
inject: '/src/bar.js',
transformIndexHtml: () => ({
templateData: {
// `ejs` template data
user: {
name: 'Kevin',
age: '25',
},
},
}),
},
])You can see
API
export interface Options {
/** Value of script src */
inject?: string
/**
* e.g.
*
* - 'public/index.html'
* - { 'index.html': 'public/index.html' }
*/
template?: string | { [entryAlias: string]: string }
transformIndexHtml?: (html: string, ctx: IndexHtmlTransformContext) => string | void | {
html?: string
/** Data of lodash.template */
templateData?: Record<string, any>
/**
* Options of lodash.template
* @see https://lodash.com/docs/4.17.15#template
*/
templateOptions?: TemplateOptions
}
}Limitation
ejs templates must end with .html. Any other file types will be considered static files by Vite.
You can see