webpack-context-vuex-hmr
tl;dr
This module makes it easy to setup dynamic imports of javascript modules using require.context
and removes the need for the extra boilerplate that is needed to make HMR work with them.
To see this plugin in action, clone, download and run: webpack-context-vuex-hmr-demo
Introduction
A nice way to organize Vuex code is to structure into getters, actions and mutations into a single module file. However, depending on the size of the project it might be a pain to import them all into main.js
.
Vue works very well with HMR using the vue-cli tempalte. But to make Vuex work with HMR, there is need for code duplication and some boring boilerplate to get the modules to be properly hot module replaced instead of live reloaded. This can be quite tedious for a large project.
This package uses Webpack's require.context
to dynamically load all Vuex modules using a preconfigured regexp and takes care of the necessary boilerplate to make HMR work with the dynamic context.
A more general version that will probably work frameworks other than Vuex can be found here: Webpack-context-hmr.
Nested Vuex modules:
When working with submodules/substores and Webpack 1
, this loader in needed: hmr-auto-accept-loader
This loader is not needed with Webpack 2
.
Usage
Require.context
cannot handle runtime input. It can however be configured by using the ContextReplacementPlugin
.
Configure the importer by adding the plugin to the webpack configuration:
plugins: new /webpack-context-vuex-hmr$/ // [leave me] this file path // [edit me] context root path true // [edit me] recursive search /-store.js$/ // [edit me] regexp to find modules
In this example the importer will look in <project-path>/src
using recursive search through folders, looking for files ending with -store.js
. This should be edited to match the projects naming conventions.
Then in main.js
:
// Import plugin;// Normal imports;;; // Get new importer instanceconst importer = contextHmr; // Import all modules and get `module.default` from each module// Edit moduleKey value as necessary, this example imports from modules using:// `export default { state, getters, actions, mutations };`const modules = importer; // Framework setup using the modulesconst store = modules ; // Setup HMR with a callbackimporter; // Create new vue instance like normal el: '#app' store ;
Read more
License
MIT