jantimon/html-webpack-plugin
Html Webpack Plugin
This project is a Webpack HTML generator and template engine that creates HTML files and automatically injects compiled script and style bundles. It functions as an asset injection tool and build process minifier to automate the production of web pages.
The tool differentiates itself through a customizable template system that supports dynamic variable injection, programmatic content generation, and the ability to generate multiple distinct HTML entry points for multi-page applications. It also provides a hook-based lifecycle pipeline, allowing for the modification of assets and tags before the final output is written.
The software covers a broad range of asset management capabilities, including chunk filtering, sorting, and loading strategy configuration. It handles metadata injection for base URLs and meta tags, manages content hashing for browser caching, and provides options for inline asset embedding and path management.
The system produces optimized output by removing whitespace and comments through built-in HTML minification.
Features
- Build Automations - Automates the production of web pages by bundling and injecting scripts, styles, and metadata during the build process.
- Asset Injection - Provides a mechanism to control the placement and loading order of JavaScript and CSS chunks within generated HTML.
- Multi-Page Application Builders - Supports the creation of multiple distinct HTML entry points, each with its own required asset bundles, for multi-page applications.
- Webpack Asset Generators - Automatically creates HTML files and injects the script and style bundles produced by Webpack.
- Template Variable Injection - Supports the replacement of placeholders in HTML templates with dynamic build-time variables.
- Asset Graph Mapping - Analyzes the Webpack compilation state to identify and map the necessary script and style chunks for the output.
- HTML Markup Templates - Uses customizable HTML templates and strings to dynamically inject asset tags and metadata variables.
- Asset Injection Controls - The tool defines exactly where scripts and styles appear using template parameters to manually place tags.
- Bundle-to-HTML Integration - Automatically generates HTML files that link to the compiled JavaScript and CSS bundles produced by Webpack.
- Structure Definitions - Allows the definition of custom HTML structures and the injection of dynamic parameters using templates or functions.
- HTML Entry Point Generators - Automatically creates HTML entry files that include the necessary script and style tags for compiled assets.
- HTML Templating Engines - Functions as a template engine to process structured templates and generate the final HTML for web applications.
- Multi-Page Entry Point Generation - Enables the creation of separate HTML files by initializing multiple plugin instances with distinct configurations.
- Multiple Entrypoint Generation - Enables the generation of multiple distinct HTML entry points within a single build configuration.
- Script Loading Strategies - Implements configurable loading strategies for script and style tags, such as using defer or module attributes.
- Asset Chunk Selection - Allows specifying which asset chunks to include or exclude in a file to control page dependencies.
- Build Lifecycle Hooks - Exposes event hooks that allow developers to intervene and modify assets or tags during the build lifecycle.
- Asset Filename Hashing - Handles the generation of HTML files with hashed asset filenames to ensure browsers load the latest versions.
- Asset Minification - Provides automated minification of the generated HTML to remove whitespace and comments for reduced transfer size.
- Build Artifact Content Hashes - Adds unique content hashes to output filenames to enable long-term browser caching.
- Dependency-Based Asset Sorting - Determines the order in which asset chunks are injected based on their underlying dependency graphs.
- Pipeline Lifecycle Hooks - Provides a sequence of lifecycle hooks that allow external functions to modify assets and tags before the final file is written.
- External File Integrations - Injects assets into provided external files or strings using custom variables and template loaders.
- Programmatic Generation - Produces HTML content dynamically using JavaScript functions based on provided parameters.
- Meta Tag Managers - Includes utilities for adding custom meta tags, such as viewport and charset settings, to the generated HTML head.
- Asset Path Resolvers - Overrides default path generation using absolute or relative paths and placeholders for cache busting.
- HTML Output Optimizers - Minifies HTML output by removing redundant attributes, whitespace, and comments to improve performance.
- HTML Whitespace Minifiers - Reduces HTML file size by stripping unnecessary whitespace and comments during the build process.
