JunCai He

# 组件基础用法

前面的话

  • 组件(Component)是Vue.js最强大的功能之一。
  • 组件可以扩展HTML元素，封装可重用的代码。根据项目需求，抽象出一些组件，每个组件里包含了展现、功能和样式。每个页面，根据自己所需，使用不同的组件来拼接页面。
  • 组件化开发模式使前端页面易于扩展，且灵活性高，而且组件之间也实现了解耦。

# 概述

在 Vue 里，一个组件本质上是一个拥有预定义选项的一个 Vue 实例

组件是一个自定义元素或称为一个模块，包括所需的模板、逻辑和样式。在HTML模板中，组件以一个自定义标签的形式存在，起到占位符的功能。通过Vue.js的声明式渲染后，占位符将会被替换为实际的内容。

Vue.component('hello', {
   template: '<h1>hello</h1>'
})

<div id="app">
    <hello></hello>
</div>

// 占位符会被解析替换成如下内容

<div id="app">
    <h1>hello</h1>
</div>

# 组件注册

# 全局注册

要注册一个全局组件，可以使用 Vue.component(tagName, options)

// my-componment 自定义组件名称 【按照一定的规则：下面会提到】
Vue.component('my-componment', {
    template:'<div></div>',
    data:{},
    methods:{}
    // ...
})

组件在注册之后，便可以在父实例的模块中以自定义元素 <my-component></my-component> 的形式使用

[注意]

要确保在初始化根实例之前注册了组件

# 局部注册

通过使用组件实例选项components注册，可以使组件仅在另一个实例/组件的作用域中可用。

<div id="app">
  <my-component></my-component>
</div>

<script>
// 注册
var Child = {
  template: '<div>A custom component!</div>'
};
// 创建根实例
new Vue({
  el: '#app',
    components: {
    // <my-component> 将只在父模板可用
    'my-component': Child
  }  
})
</script>

// 渲染为以下内容
<div id="app">
    <div>A custom component!</div>
</div>

# 组件树

使用组件实例选项components注册，可以实现组件树的效果

<div id="app">
  <my-component></my-component>
</div>

let headerTile = {
    template:'<h2>我是标题</h2>'
}
let headerContent = {
    template: '<p>我是内容</p>',
};

let header = {
  template: `
      <div class="header">
            <header-title></header-title>
            <header-content></header-content>
      </div>
  `,
    components: {
    'header-title': headerTitle,
    'header-content': headerContent
  }   
};

// 创建实例
new Vue({
  el: '#app',
    components: {
    'my-component': header
  }  
})

// 渲染为
<div id = "app">
    <div class="header">
        <h2>我是标题</h2>
        <p>我是内容</p>
    </div>
</div>

TIP

对于大型应用来说，有必要将整个应用程序划分为组件，以使开发可管理。

<div id="app">
  <app-nav></app-nav>
  <app-view>
    <app-sidebar></app-sidebar>
    <app-content></app-content>
  </app-view>
</div>

【v-once】 尽管在 Vue 中渲染 HTML 很快，不过当组件中包含大量静态内容时，可以考虑使用 v-once 将渲染结果缓存起来

Vue.component('my-component', {
  template: '<div v-once>hello world!...</div>'
})

# 模板分离

在组件注册中，使用template选项中拼接HTML元素比较麻烦，这也导致了HTML和JS的高耦合性。

庆幸的是，Vue.js提供了两种方式将定义在JS中的HTML模板分离出来

# 【script】

在script标签里使用 text/x-template 类型，并且指定一个 id

<script type="text/x-template" id="hello-world-template">
  <p>Hello hello hello</p>
</script>

Vue.component('hello-world', {
  template: '#hello-world-template'  // 使用script标签里面指定的id属性值
})

# 【template】

如果使用<template>标签，则不需要指定type属性

<div id="app">
  <my-component></my-component>
</div>

<template id="hello-world-template">
  <div>hello world!</div>  
</template>

<script>
Vue.component('my-component', {
  template: '#hello-world-template'
})
// 创建根实例
new Vue({
  el: '#app'
})
</script>

如果使用SFC方式结构固定：template、script、style开发 ,template 里面的id也是可以省略的。

<template>
  <div>Hello World</div>
</template>

<script setup lang="ts">
</script>

<style lang='scss' scope>
</style>

# 命名约定

对于组件的命名，W3C规范是字母小写且包含一个中划线(-)，虽然Vue没有强制要求，但最好遵循规范

<!-- 在HTML模版中始终使用 kebab-case -->
<kebab-cased-component></kebab-cased-component>
<camel-cased-component></camel-cased-component>
<pascal-cased-component></pascal-cased-component>

当注册组件时，使用中划线、小驼峰、大驼峰这三种任意一种都可以

// 在组件定义中
components: {
  // 使用 中划线 形式注册
  'kebab-cased-component': { /* ... */ },
  // 使用 小驼峰 形式注册
  'camelCasedComponent': { /* ... */ },
  // 使用 大驼峰 形式注册
  'PascalCasedComponent': { /* ... */ }
}

# 嵌套限制

【注意】

并不是所有的元素都可以嵌套模板，因为要受到HTML元素嵌套规则的限制，尤其像<ul>，<ol>，<table>，<select> 限制了能被它包裹的元素，而一些像 <option>这样的元素只能出现在某些其它元素内部

HTML标签的详细嵌套规则🔎 在自定义组件中使用这些受限制的元素时会导致一些问题，例如

<table id="example">
  <my-row>...</my-row>
</table>

自定义组件 <my-row> 被认为是无效的内容，因此在渲染的时候会导致错误

<script>
// 注册
var header = {
  template: '<div class="hd">我是标题</div>'  
};
// 创建实例
new Vue({
  el: '#example',
    components: {
    'my-row': header
  }  
})
</script>

# 【is属性】

变通的方案是使用特殊的 is 属性

<table id="example">
  <tr is="my-row"></tr>
</table>

<script>
// 注册
var header = {
  template: '<div class="hd">我是标题</div>'
};
// 创建实例
new Vue({
  el: '#example',
    components: {
    'my-row': header
  }  
})
</script>

# 根原素

Vue强制要求每一个Vue实例(组件本质上就是一个Vue实例)需要有一个根元素

否则会报错

# data数据

一般地，在Vue实例对象或Vue组件对象中，我们通过data来传递数据

<div id="example">
  <my-component></my-component>
  <my-component></my-component>
  <my-component></my-component>
</div>

<script>
// 注册
Vue.component('my-component', {
  template: '<div>{{message}}</div>',
  data:{
      message: 'hello'
  }
})
// 创建根实例
new Vue({
  el: '#example'
})
</script>

DANGER

运行上面的代码，会使Vue停止执行，并在控制台发出错误提示，告诉你在组件中 data 必须是一个函数

为什么data选项必须是一个函数？❗

# 原生事件

有时候，可能想在某个组件的根元素上监听一个原生事件。直接使用v-bind指令是不生效的

<div id="app">
  <my-component @click="doTheThing"></my-component>
  <p>{{ message }}</p>
</div>

<script>
Vue.component('my-component', {
  template: '<button>按钮</button>',
})

new Vue({
  el: '#app',
  data:{
    message:0
  },
  methods:{
    doTheThing(){
      this.message++;
    }
  }
})
</script>

可以使用 .native 修饰 v-on指令即可

<my-component @click.native="doTheThing"></my-component>
Last Updated: 12/27/2022, 11:34:16 PM

← Vue动态组件 →