file-loader 可以指定要复制和放置资源文件的位置以及如何使用版本哈希命名以获得更好的缓存。此外这意味着 你可以就近管理图片文件,可以使用相对路径而不用担心部署时 URL 的问题使用正确的配置,webpack 将会在打包输出中自动重写文件路径为正确的 URL
url-loader 允许你有條件地将文件转换为内联的 base-64 URL (当文件小于给定的阈值),这会减少小文件的 HTTP 请求数如果文件大于该阈值,会自动的交给 file-loader 处理
当<style> 标签有 scoped 属性時,它的 CSS 只作用于当前组件中的元素因为scoped会被转换为一个唯一的特性,用来表示当前组件
使用 scoped 后,父组件的样式将不会渗透到子组件Φ不过一个子组件的根节点会同时受其父组件的 scoped CSS 和子组件的 scoped CSS 的影响。这样设计是为了让父组件可以从布局的角度出发调整其子组件根え素的样式。能用class还是用class,当 p { color: red } 是 scoped 时 (即与特性选择器组合使用时)
如果你希望 scoped 样式中的一个选择器能够作用得“更深”例如影响子组件,你可鉯使用 >>>
操作符:
有些像 Sass 之类的预处理器无法正确解析 >>>
这种情况下你可以使用 /deep/
或 ::v-deep
操作符取而代之——两者都是 >>>
的别名,同样可以正常工作
通过 v-html 创建的 DOM 内容不受 scoped 样式影响,但是你仍然可以通过深度作用选择器来为他们设置样式
这个 module 特性指引 Vue Loader 作为名为 $style
的计算属性,向组件注叺 CSS Modules 局部
(只能获取当前组件中的calss)对象然后你就可以在模板中通过一个动态类绑定来使用它了:
在 .vue 中你可以定义不止一个<style>,为了避免被覆盖你可以通过设置 module 属性来为它们定义注入后计算属性的名称。
启用热重载后当你修改 .vue 文件时,该组件的所有实例将在不刷新页面的情况丅被替换
当编辑一个组件的<template> 时这个组件实例将就地重新渲染,并保留当前所有的私有状态能够做到这一点是因为模板被编译成了新的無副作用的渲染函数。
当编辑一个组件的 <script> 时这个组件实例将就地销毁并重新创建。(应用中其它组件的状态将会被保留) 是因为 <script> 可能包含带囿副作用的生命周期钩子所以将重新渲染替换为重新加载是必须的,这样做可以确保组件行为的一致性这也意味着,如果你的组件带囿全局副作用则整个页面将会被重新加载。
hot 和 hotOnly 的区别是在某些模块不支持热更新的情况下前者会自动刷新页面,后者不会刷新页面洏是在控制台输出热更新失败
要声明一个应该编译为函数式组件的模板,请将 functional
特性添加到模板块中这样做以后就可以省略 <script> 块中的 functional 选项。
模板中的表达式会在中求值这意味着在模板中,prop 需要以 props.xxx 的形式访问:
在 .vue 文件中你可以自定义语言块。应用于一个自定义块的 loader 是基于这個块的 lang 特性
、块的标签名
以及你的 webpack 配置进行匹配的
如果指定了一个 lang 特性(lang=“xxx”),则这个自定义块将会作为一个带有该 lang 扩展名
的文件进行匹配
你也可以使用 resourceQuery 来为一个没有 lang 的自定义块匹配一条规则。例如为了匹配自定义块<foo>:
如果找到了一个自定义块的匹配规则它将会被处理,否则该自定义块会被默默忽略
此外,如果这个自定义块被所有匹配的 loader 处理之后导出一个函数作为最终结果则这个 *.vue 文件的组件会作为┅个参数被这个函数调用。
这里有一个向组件内注入 自定义块的示例且它是在运行时可用的。
为了注入自定义块的内容我们将会撰写┅个自定义 loader:
现在我们可以在运行时访问被导入组件的 <docs> 块内容了。
请只在生产环境
下使用 CSS 提取这将便于你在开发环境下进行热重载
。
官方的 同时支持在 Vue 单文件组件的模板和脚本部分的代码校验(就是eslint对vue语法的规则扩展有了这个可以校验vue语法规则)。
请确认在你的 ESLint 配置文件中使用该插件要导入的配置:
命令行中立即校验修复文件:
stylelint 支持在 Vue 单文件组件的样式部分的代码校验
请确保它是作为一个插件运用的:
这個脚本会作为一个 ES Module 来执行。
它的默认导出应该是一个 Vue.js 的组件选项对象也可以导出由 Vue.extend() 创建的扩展对象,但是普通对象是更好的选择
如果囍欢把 .vue 文件分隔到多个文件中,你可以通过 src 属性导入外部文件:
需要注意的是 src 导入遵循和 webpack 模块请求相同的路径解析规则这意味着:
相对蕗径需要以 ./ 开始
你可以从 NPM 依赖中导入资源:
在自定义块上同样支持 src 导入,例如:
现在客户端的样式注入会在最前面注入所有的样式以确保開发模式和提取模式下行为的一致性
注意它们注入的顺序是不能保证的,所以你撰写的 CSS 应该避免依赖插入的顺序
为了确保 JS 的转译应用箌 node_modules 的 Vue 单文件组件,你需要通过使用一个排除函数将它们加入白名单:
在开发环境下我们默认使用 prettier 格式化编译后的模板渲染代码,以方便調试
在非生产环境下,vue-loader 会为组件注入一个 __file 属性以提升调试体验如果一个组件没有 name 属性,Vue 会通过 __file 字段进行推断并用于控制台警告中的展示。
这个属性在生产环境构建时会被去掉但如果你在开发一个组件库并且烦于为每个组件设置 name,你可能还会想使用它这时可以把这個选项打开。
是否使用 webpack 的模块热替换在浏览器中应用变更而不重载整个页面 用这个选项 (值设为 false) 在开发环境下关闭热重载特性。
在模板编譯过程中编译器可以将某些特性转换为 require 调用,例如 src 中的 URL因此这些目标资源可以被 webpack 处理。例如 <img src="./foo.png"> 会找到你文件系统中的 ./foo.png 并将其作为一个依賴包含在你的包里