compile-include-html
v2.2.13
Published
Small parser that allows including multiple html files in one using an `<include>` tag and a `<for>` tag.
Downloads
35
Readme
compile-include-html
Small parser that allows including multiple html files in one using an <include>
tag and a <for>
tag.
Installation
npm i compile-include-html
Example
Simple include
<!-- main.html -->
<div class="container">
<include src="card.html" with="text: hello world" />
</div>
<!-- card.html -->
<div class="card">{text}</div>
<!-- main.html after compilation -->
<div class="container">
<div class="card">hello world</div>
</div>
Simple for loop
// javascript file where the context is defined
import { HtmlParser } from "compile-include-html";
const source = `
<div class="container">
<for condition="const user of array">
<span>Firstname: {user.firstName}, lastname: {user.lastName}</span>
</for>
</div>`;
const context = {
array: [
{ firstName: "john", lastName: "doe" },
{ firstName: "jannet", lastName: "foe" },
],
};
const htmlParser = new HtmlParser({
globalContext: context,
});
const output = htmlParser.transform(source);
<!-- output -->
<div class="container">
<span>Firstname: john, lastname: doe</span>
<span>Firstname: jannet, lastname: foe</span>
</div>
Context replacement
// javascript file where the context is defined
import { HtmlParser } from "compile-include-html";
const source = `<a href="{link.href}">{link.name}</a>`;
const parser = new HtmlParser({
globalContext: {
link: {
href: "https://example.com",
name: "link to example",
},
},
});
const output = htmlParser.transform(source);
<!-- output -->
<a href="https://example.com">link to example</a>
Usage
Create a new HtmlParser with:
import { HtmlParser } from "compile-include-html";
const htmlParser = new HtmlParser();
Options
You can pass an option object to your parser.
type options = {
indent?: number;
inputIsDocument?: boolean;
globalContext?: TContext;
basePath?: string;
};
indent
: You can set the indentation of your generated html with theindent
property.inputIsDocument
: determines whether the input is an entire document with<DOCTYPE>
,<head>
and<body>
tags or just a fragment. It will allow the parser to correctly manage both cases.globalContext
: allows you to pass a context object to the parser. It will be used to replace values wrapped in{
and}
. Brackets values only work on attributes values and text nodes, for example:
<!-- will work -->
<p class="{className}">{paragraph}</p>
<!-- will not work -->
<p {classAttr}="px-4">{paragraph}</p>
basePath
: allows you to pass a basePath to your parser, for example you can do
import { HtmlParser } from "compile-include-html";
const htmlParser = new HtmlParser({ basePath: "pages/about" });
<!-- main.html -->
<div class="container">
<include src="card.html" with="text: hello world" />
</div>
instead of
<!-- main.html -->
<div class="container">
<include src="pages/about/card.html" with="text: hello world" />
</div>
Methods
readFile(path: string): string
Use it to read a file and retrieve a string of the file's content.
transform(source: string): string
Use it to transform a string using the include or for tag into its compiled version.
outputNewFile(inputPath: string, outputPath: string): void
Use it to compile an input file located at inputPath
and create an output file located at outputPath
.