# @teskon/vite-plugin-ejs-engine
[](https://www.npmjs.com/package/@teskon/vite-plugin-ejs-engine)
Thiis is a fork of [vite-plugin-ejs-engine](https://www.npmjs.com/package/vite-plugin-ejs-engine)
[Vite](https://github.com/vitejs/vite) plugin for [Ejs](https://ejs.co/).
Supports:
- [Templates, Partials, variable declarations...](https://ejs.co/#features)
## Install
**Yarn**
```
yarn add @teskon/vite-plugin-ejs-engine -D
```
or **npm**
```
npm i @teskon/vite-plugin-ejs-engine --save-dev
```
## Usage
### Configuration
Use plugin in your Vite config (`vite.config.ts`)
```JavaScript
import ejs from '@teskon/vite-plugin-ejs-engine'
export default {
plugins: [
ejs(),
]
}
```
If you're not using typescript you can enable the plugin by calling the method `ejs.default` in the `vite.config.js` file, as such:
```js
import ejs from '@teskon/vite-plugin-ejs-engine'
export default {
plugins: [
ejs.default(),
],
};
```
### Options
This fork enables injection of variables by passing the variables into the `ejs` method, for example:
```js
import ejs from '@teskon/vite-plugin-ejs-engine'
export default {
plugins: [
ejs.default({
inject: {
title: 'Hello world',
},
}),
],
};
```
You will then be able to use that variable in your template files as such:
```html
<%= title %>
Hello world
```
Below you can see all available options that you can apply to this plugin.
| property | default | description |
| ------------ | ------------- | --------------------------------------------------------------------------------------------------------------- |
| `inject` | - | Data injected into HTML. |
| `ejsOptions` | - | `ejs` options, [@See](https://github.com/mde/ejs#options) |
### Example
Input (`src/index.html`):
```html
Document
Hello world
<% var users = [{name: 'Jose'}, {name: 'Pedro'}]; %>
<% users.forEach(function(user){ %>
<%- include('user/show', {user: user}); %>
<% }); %>
```
Template (`src/user/show.ejs`):
```html
<%= user.name %>
```
**Output** (`dist/index.html`)
```html
Document
Hello world
```