Skip to content

Latest commit

 

History

History
249 lines (189 loc) · 5.98 KB

options.md

File metadata and controls

249 lines (189 loc) · 5.98 KB

选项参考

Webpack 1 和 2 之间的使用差异

Webpack 2：配置直接放到 loader rule 中。

module.exports = {
  // ...
  module: {
    rules: [
      {
        test: /\.vue$/,
        loader: 'vue-loader',
        options: {
          // vue-loader options
        }
      }
    ]
  }
}

Webpack 1.x：在 Webpack 配置中添加根节点 vue 块。

module.exports = {
  // ...
  vue: {
    // vue-loader options
  }
}

loaders

  • 类型： { [lang: string]: string }

    指定 Webpack loader 对象覆盖用于 *.vue 文件内的语言块的默认 loader。如果指定，该键对应于语言块的 lang 属性。 每种类型的默认 lang 是：

    • <template>: html
    • <script>: js
    • <style>: css

    例如，使用 babel-loader 和 eslint-loader 处理所有的 <script> 块：

    // Webpack 2.x config
module: {
  rules: [
    {
      test: /\.vue$/,
      loader: 'vue-loader',
      options: {
        loaders: {
          js: 'babel-loader!eslint-loader'
        }
      }
    }
  ]
}

preLoaders

  • 类型： { [lang: string]: string }

  • 仅在 >=10.3.0 版本中支持

    配置格式和 loaders 相同，但是 preLoaders 会在默认 loaders 之前处理。你可以用来预处理语言块 - 一个常见用例是用来处理构建时的 i18n。

postLoaders

  • 类型： { [lang: string]: string }

  • 仅在 >=10.3.0 版本中支持

    配置格式和 loaders 相同，但是 postLoaders 会在默认 loaders 之后处理。你可以用来后处理语言块。注意这会有些复杂：

    • 对于 html，默认 loader 返回结果会被编译为 JavaScript 渲染函数。

    • 对于 css，由vue-style-loader 返回的结果通常不太有用。使用 postcss 插件将会是更好的选择。

postcss

注意： 在 >=11.0.0 版本中，推荐使用 PostCSS 配置文件代替. The usage is the same as postcss-loader.

  • 类型： Array or Function or Object

    指定要应用于 .vue 文件中 CSS 的自定义 PostCSS 插件。如果使用函数，函数将使用相同的 loader 上下文调用，并返回一个插件数组。

    // ...
{
  loader: 'vue-loader',
  options: {
    // 注意：不要在 `loader` 下嵌入 `postcss` 选项
    postcss: [require('postcss-cssnext')()],
    loaders: {
      // ...
    }
  }
}

    这个配置选项也可以是一个对象，这在使用依赖于自定义 parser/stringifiers 的项目会非常有用：

    postcss: {
  plugins: [...], // list of plugins
  options: {
    parser: sugarss // use sugarss parser
  }
}

cssSourceMap

  • 类型: Boolean

  • 默认值: true

    是否开启 CSS 的 source maps，关闭可以避免 css-loader 的 some relative path related bugs 同时可以加快构建速度。

    注意，这个值会在 Webpack 配置中没有 devtool 的情况下自动设置为 false。

esModule

  • 类型: Boolean

  • 默认值: undefined

    是否导出兼容 esModule 的代码，默认情况下 vue-loader 会导出 commonjs 格式，像 module.exports = ....。当 esModule 设置为 true 的情况下，导出会变为 exports.__esModule = true; exports = ...。适用于与 Babel 以外的 transpiler 互操作，比如 TypeScript。

preserveWhitespace

  • 类型: Boolean

  • 默认值: true

    如果设置为 false，模版中 HTML 标签之前的空格将会被忽略。

transformToRequire

  • 类型: { [tag: string]: string | Array<string> }

  • 默认值: { img: 'src', image: 'xlink:href' }

    在模版编译过程中，编译器可以将某些属性，如 src 路径，转换为 require 调用，以便目标资源可以由 Webpack 处理。 默认配置会转换 <img> 标签上的 src 属性和 SVG 的 <image> 标签上的 xlink：href 属性。

buble

  • 类型: Object

  • 默认值: {}

    配置 buble-loader 的选项（如果存在），并且 buble 编译传递模板渲染函数。

    版本警告：在 9.x 版本中，模板表达式通过现在已经删除的 templateBuble 选项单独配置。

    模板渲染函数编译支持一个特殊的变换 stripWith（默认启用），它删除生成的渲染函数中的 with 用法，使它们兼容严格模式。

    配置例子：

    // webpack 1
vue: {
  buble: {
    // 启用对象扩展运算符
    // 注意：你需要自己提供 Object.assign polyfill！
    objectAssign: 'Object.assign',

    // turn off the `with` removal
    transforms: {
      stripWith: false
    }
  }
}

// webpack 2
module: {
  rules: [
    {
      test: /\.vue$/,
      loader: 'vue-loader',
      options: {
        buble: {
          // same options
        }
      }
    }
  ]
}

extractCSS

12.0.0 新增

使用 extract-text-webpack-plugin 自动提取 CSS。 适用于大多数预处理器，且也可在生产环境进行压缩。

传入的值可以是 true，也可以是插件的一个实例（这样可以为多个提取的文件使用多个提取插件的实例）。

这应当只用于生产环境，以便可以在开发过程中使用热重载。

示例:

// webpack.config.js
var ExtractTextPlugin = require("extract-text-webpack-plugin")

module.exports = {
  // other options...
  module: {
    rules: [
      {
        test: /\.vue$/,
        loader: 'vue-loader',
        options: {
          extractCSS: true
        }
      }
    ]
  },
  plugins: [
    new ExtractTextPlugin("style.css")
  ]
}

或者传递插件的一个实例：

// webpack.config.js
var ExtractTextPlugin = require("extract-text-webpack-plugin")
var plugin = new ExtractTextPlugin("style.css")

module.exports = {
  // other options...
  module: {
    rules: [
      {
        test: /\.vue$/,
        loader: 'vue-loader',
        options: {
          extractCSS: plugin
        }
      }
    ]
  },
  plugins: [
    plugin
  ]
}