Skip to contentpackage
posthtml-modules
v0.7.3Posthtml modules processing
node >=105 depscjsopen source
- license
- MIT
- deps
- 5
- unpacked
- 22.8 kB
- files
- 13
- node
- >=10
$npm install posthtml-modules@0.7.3 README
GitHub-flavored package documentation.
downloads
Across all versions, last 30 days.
1,175weekly+17.5%
4,589 in 30 days
Oct 16 → Nov 14hover or arrows
compatibility
Runtime metadata.
keywords
Tagged topics.
posthtmlposthtml-modulesparsertransformhtmlmodule
versions
Latest published Mar 2, 2023
maintainers
Registry package owners.
install size
Estimated unpacked size across 10 packages.
1.7 MB
Includes dependencies.
dependencies
5 direct · 2 outdated
canvaskisa
canvaskisa@gmail.com
Modules Plugin
Import and process HTML Modules with PostHTML
Install
npm i -D posthtml-modules
Example
<!-- index.html -->
<html>
<body>
<module href="./module.html">
title
</module>
</body>
</html>
<!-- module.html -->
<header>
<h1>
Test <content></content>
</h1>
</header>
const { readFileSync } = require('fs')
const posthtml = require('posthtml')
const options = { /* see available options below */ }
posthtml()
.use(require('posthtml-modules')(options))
.process(readFileSync('index.html', 'utf8'))
.then((result) => result)
});
<html>
<body>
<header>
<h1>Test title</h1>
</header>
</body>
</html>
Options
root
Root path for modules lookup.
plugins
Type: array | function
Default: []
PostHTML plugins to apply for every parsed module.
If a function provided, it will be called with module's file path.
from
Root filename for processing apply, needed for path resolving (it's better to always provide it).
initial
Type: boolean
Default: false
Apply plugins to root file after modules processing.
tag
Type: string
Default: module
attribute
Type: string
Default: href
Use a custom attribute name.
locals
If present, the JSON object from the locals="" attribute will be merged on top of this, overwriting any existing values.
attributeAsLocals
Type: boolean
Default: false
All attributes on <module></module> will be added to locals
parser
Options for the PostHTML parser.
expressions
Component options
locals
You can pass data to a module using a locals="" attribute.
Must be a valid JSON object.
<!-- module.html -->
<p>The foo is {{ foo }} in this one.</p>
<content></content>
<!-- index.html -->
<module href="./module.html" locals='{"foo": "strong"}'>
<p>Or so they say...</p>
</module>
Result
<p>The foo is strong in this one.</p>
<p>Or so they say...</p>
attributeAsLocals
All attributes on <module></module> will be added to locals
<!-- module.html -->
<div class="{{ class }}" id="{{ id }}" style="{{ style }}">
<content></content>
</div>
<!-- index.html -->
<module
href="module.html"
class="text-center uppercase"
id="example"
style="display: flex; gap: 2;"
>
Module content
</module>
Result
<div class="text-center uppercase" id="example" style="display: flex; gap: 2;">
Module content
</div>