Vue 组件规格
*.vue
文件是用户用 HTML-like 的语法编写的 Vue 组件。每个 *.vue
文件都包括三部分 <template>
, <script>
和 <style>
:
<template>
<div class="example">{{ msg }}</div>
</template>
<script>
export default {
data () {
return {
msg: 'Hello world!'
}
}
}
</script>
<style>
.example {
color: red;
}
</style>
vue-loader
解析文件,提取每个语言块,让他们通过需要的其他 loaders ,最后组装起来,放回 CommonJS 的模块,此模块的 module.exports
就是个 Vue.js 组件对象。
vue-loader
默认用没有用语言编译器,想CSS 预编译和HTML模板编译语言等,如果想用这些功能,需要设置 lang
属性的来实现。例如,你可以在组件的样式中这样用 SASS :
<style lang="sass">
/* 编写 SASS! */
</style>
更多细节查看 [使用预编译器]。
语言块
<template>
默认语言:
html
。每个
*.vue
文件几乎都包含一个<template>
块。<template>
内的内容字符串会被提取出来,用来编译进 Vue 组件内的template
选项。
<script>
默认语言:
js
(默认ES2015也会通过Babel支持)。每个
*.vue
文件几乎都包含一个<script>
块。脚本就像在CommonJS的环境中一样被执行(就像通过WebPACK中捆绑一个正常的.js模块)。就是说你可以
require()
其他的依赖项。由于默认支持 ES2015 ,你也可以用import
和export
语法。该脚本必须导出一个 Vue.js 组件选项对象,也支持导出一个用
Vue.extend()
创建的扩展构造函数,但首先是导出普通对象。
<style>
默认语言:
css
。每个
*.vue
文件支持多个<style>
标签。默认,会通过
style-loader
把内容提取并加载到文档的<head>
内的<style>
标签内。这也是可以[通过配置 Webpack 使组件内所有样式提取到一个单一的CSS文件]。
Src Imports
如果你喜欢把你的 *.vue
组件拆分成多个文件,那么你可以用 src
属性导入外部文件,代码如下:
<template src="./template.html"></template>
<style src="./style.css"></style>
<script src="./script.js"></script>
需要注意的是 src
导入要遵循和 CommonJS 的 require()
调用一样的路径解析规则,这就是说你需要用以 ./
开头的相对路径,并且你可以直接从已安装的 NPM 包内导入资源,例如:
<!-- 从已安装的 "todomvc-app-css" NPM 包内导入文件 -->
<style src="todomvc-app-css/index.css">
语法高亮显示
开发中的第一件事,你可能想让 *.vue
组件能高亮显示。现阶段,在 Sublime Text , Atom , Vim , Visual Studio Code , Brackets ,和 JetBrains products (WebStorm,PhpStorm,等)都有支持语法高亮显示的插件。如果在 Vue 组件内没有使用任何预编译器,那么编辑器就把 *.vue
文件当成普通的 HTML 文件一样。
注释
在每个代码块内,注释的时候,需要使用各自语言的注释语法去注释(HTML、CSS、JavaScript、Jade 等)。在文件最顶部注释的时候用HTML的注释语法:<!— 在这里写注释的内容 -->
。