diff --git a/docs/zh-cn/features/hot-reload.md b/docs/zh-cn/features/hot-reload.md index 1d5b8280f..b1601b854 100644 --- a/docs/zh-cn/features/hot-reload.md +++ b/docs/zh-cn/features/hot-reload.md @@ -19,3 +19,27 @@ 当手动设置你的工程时,热重载会在你启动 `webpack-dev-server --hot` 服务时自动开启。 高阶用户可能希望移步 `vue-loader` 内部使用的 [vue-hot-reload-api](https://github.com/vuejs/vue-hot-reload-api) 继续查阅。 + +## 关闭热重载 + +热重载默认是开启的,除非遇到以下情况: + + * webpack 的 `target` 的值是 `node` (服务端渲染) + * webpack 会压缩代码 + * `process.env.NODE_ENV === 'production'` + +你可以设置 `hotReload: false` 选项来显式关闭热重载: + +``` js +module: { + rules: [ + { + test: /\.vue$/, + loader: 'vue-loader', + options: { + hotReload: false // 关闭热重载 + } + } + ] +} +``` diff --git a/docs/zh-cn/features/postcss.md b/docs/zh-cn/features/postcss.md index 9807897de..bc63415e0 100644 --- a/docs/zh-cn/features/postcss.md +++ b/docs/zh-cn/features/postcss.md @@ -21,9 +21,9 @@ Webpack 1.x 例子: ``` js // webpack.config.js module.exports = { - // other configs... + // 其它配置…… vue: { - // use custom postcss plugins + // 使用自定义 postcss 插件 postcss: [require('postcss-cssnext')()] } } @@ -36,12 +36,12 @@ Webpack 2.x 例子: module.exports = { // other options... module: { - // `module.rules` is the same as `module.loaders` in 1.x + // `module.rules` 和 1.x 里的 `module.loaders` 相同 rules: [ { test: /\.vue$/, loader: 'vue-loader', - // `vue-loader` options goes here + // `vue-loader` 选项放这里 options: { // ... postcss: [require('postcss-cssnext')()] @@ -60,9 +60,9 @@ module.exports = { ``` js postcss: { - plugins: [...], // list of plugins + plugins: [...], // 插件列表 options: { - parser: sugarss // use sugarss parser + parser: 'sugarss' // 使用 sugarss 解析器 } } ``` diff --git a/docs/zh-cn/options.md b/docs/zh-cn/options.md index 9bf9404a5..6bbcdbea1 100644 --- a/docs/zh-cn/options.md +++ b/docs/zh-cn/options.md @@ -306,3 +306,14 @@ module.exports = { - 默认值:在开发环境下是 `true`,在生产环境下是 `false`。 是否通过给文件名后加哈希查询值来避免生成的 source map 被缓存。关掉这一选项有益于 source map 调试。 + +### hotReload + +> 13.5.0 新增 + +- 类型: `boolean` +- 默认值: 在开发环境下是 `true`,在生产环境下或 webpack 配置中有 `target: 'node'` 的时候是 `false`。 +- 允许的值: `false` (`true` 会强制热重载,即便是生产环境或 `target: 'node'` 时) + +是否使用 webpack 的[模块热替换](https://webpack.js.org/concepts/hot-module-replacement/)在浏览器中应用变更而**不重载整个页面**。 +用这个选项 (值设为 `false`) 在开发环境下关闭热重载特性。