Vue 组件

什么是Vue组件

组件 (Component) 是 Vue.js 最强大的功能之一。组件可以扩展 HTML 元素,封装可重用的代码。在较高层面上,组件是自定义元素,Vue.js 的编译器为它添加特殊功能。在有些情况下,组件也可以是原生 HTML 元素的形式,以 is 特性扩展。

注册

vue.component全局注册

注册或获取全局组件。注册还会自动使用给定的id设置组件的名称

// 注册组件,传入一个扩展过的构造器
Vue.component('my-component', Vue.extend({ /* ... */ }))
// 注册组件,传入一个选项对象(自动调用 Vue.extend)
Vue.component('my-component', { /* ... */ })
// 获取注册的组件(始终返回构造器)
var MyComponent = Vue.component('my-component')

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


// 注册
Vue.component('my-component', {
  template: '
A custom component!
' }) // 创建根实例 new Vue({ el: '#example' })

components选项局部注册

不必在全局注册每个组件。通过使用组件实例选项注册,可以使组件仅在另一个实例/组件的作用域中可用:

 const MyComponent = Vue.extend({
   template: '
A custom component!
' }) new Vue({ el: '#app', components: { 'my-component': MyComponent }, //注册局部组件,传入一个选项对象(自动调用 Vue.extend) //components: { 'my-component': { template: '
A custom component!
' } } template: '' })

以is特性扩展

当使用 DOM 作为模版时 (例如,将 el 选项挂载到一个已存在的元素上), 你会受到 HTML 的一些限制,因为 Vue 只有在浏览器解析和标准化 HTML 后才能获取模版内容。尤其像这些元素

    自定义组件 被认为是无效的内容,因此在渲染的时候会导致错误。变通的方案是使用特殊的 is 属性:

    const MyComponent = Vue.extend({
      template: '
    Hello World!
    '
    })
    
    new Vue({
      el: '#app',
      components: {
        'my-row': MyComponent
      },
      template: `
    
    
    ` })

    data 选项

    通过 Vue 构造器传入的各种选项大多数都可以在组件构造器里用。但data 是一个例外,它必须是函数。
    实际上,如果你这么做:

    Vue.component('my-component', {
      template: '{{ message }}',
      data: {
        message: 'hello'
      }
    })
    

    那么 Vue 会停止,并在控制台发出警告,告诉你在组件中 data 必须是一个函数。理解这种规则的存在意义很有帮助,让我们假设用如下方式来绕开 Vue 的警告:

    
    
    var data = { counter: 0 } Vue.component('simple-counter', { template: '', // 技术上 data 的确是一个函数了,因此 Vue 不会警告, // 但是我们返回给每个组件的实例的却引用了同一个data对象 data: function () { return data } }) new Vue({ el: '#example-2' })

    由于data是一个对象,三个组件都保持同一个data的引用。我们可以通过函数为每个组件返回全新的 data 对象来解决这个问题。

    data: function () {
      return {
        counter: 0
      }
    }
    

    父子组件通信

    在 Vue 中,父子组件的关系可以总结为 props down, events up。父组件通过 props 向下传递数据给子组件,子组件通过 events 给父组件发送消息。

    props-events.png

    prop

    组件实例的作用域是孤立的。这意味着不能 (也不应该) 在子组件的模板内直接引用父组件的数据。要让子组件使用父组件的数据,我们需要通过子组件的 props 选项,暴露对外的接口。

    Vue.component('child', {
      // 声明 props
      props: ['message'],
      // 就像 data 一样,prop 可以用在模板内
      // 同样也可以在 vm 实例中像“this.message”这样使用
      template: '{{ message }}'
    })
    

    camelCase vs kebab-case

    HTML 特性是不区分大小写的。所以,当使用的不是字符串模版,camelCased (驼峰式) 命名的 prop 需要转换为相对应的 kebab-case (短横线隔开式) 命名:

    Vue.component('child', {
      // camelCase in JavaScript
      props: ['myMessage'],
      template: '{{ myMessage }}'
    })
    
    
    ```
    
    #### 动态prop
    在模板中,要动态地绑定父组件的数据到子模板的 props,与绑定到任何普通的HTML特性相类似,就是用 v-bind。每当父组件的数据变化时,该变化也会传导给子组件:
    ```
    
    

    字面量语法 vs 动态语法

    初学者常犯的一个错误是使用字面量语法传递数值:

    
    

    因为它是一个字面 prop,它的值是字符串 “1”
    而不是 number。如果想传递一个实际的 number,需要使用 v-bind
    ,从而让它的值被当作 JavaScript 表达式计算:

    
    

    单向数据流

    prop 是单向绑定的:当父组件的属性变化时,将传导给子组件,但是不会反过来。这是为了防止子组件无意修改了父组件的状态——这会让应用的数据流难以理解。

    注意在 JavaScript 中对象和数组是引用类型,指向同一个内存空间,如果 prop 是一个对象或数组,在子组件内部改变它会影响父组件的状态。

    我们应该制止这种情况发生:

    • 定义一个局部变量,并用 prop 的值初始化它:
    props: ['initialCounter'],
    data: function () {
      return { counter: this.initialCounter }
    }
    
    • 定义一个计算属性,处理 prop 的值并返回。
    props: ['size'],
    computed: {
      normalizedSize: function () {
        return this.size.trim().toLowerCase()
      }
    }
    

    prop验证

    为组件的 props 指定验证规格。如果传入的数据不符合规格,Vue 会发出警告。
    要指定验证规格,需要用对象的形式,而不能用字符串数组:

    Vue.component('example', {
      props: {
        // 基础类型检测 (`null` 意思是任何类型都可以)
        propA: Number,
        // 多种类型
        propB: [String, Number],
        // 必传且是字符串
        propC: {
          type: String,
          required: true
        },
        // 数字,有默认值
        propD: {
          type: Number,
          default: 100
        },
        // 数组/对象的默认值应当由一个工厂函数返回
        propE: {
          type: Object,
          default: function () {
            return { message: 'hello' }
          }
        },
        // 自定义验证函数
        propF: {
          validator: function (value) {
            return value > 10
          }
        }
      }
    })
    

    type 可以是下面原生构造器:

    String
    Number
    Boolean
    Function
    Object
    Array
    Symbol
    

    type 也可以是一个自定义构造器函数,使用 instanceof 检测。

    非prop

    所谓非 prop 属性,就是它可以直接传入组件,而不需要定义相应的 prop。
    明确给组件定义 prop 是传参的推荐方式,但组件的作者并不总能预见到组件被使用的场景。所以,组件可以接收任意传入的属性,这些属性都会被添加到组件的根元素上。

    自定义事件

    每个 Vue 实例都实现了事件接口 (Events interface),即:

    • 使用 $on(eventName)监听事件
    • 使用 $emit(eventName)触发事件

    使用 v-on 绑定事件

    父组件可以在使用子组件的地方直接用 v-on 来监听子组件触发的事件。
    不能用 $on 侦听子组件抛出的事件,而必须在模板里直接用 v-on 绑定。

    v-on 用在普通元素上时,只能监听 原生 DOM 事件。用在自定义元素组件上时,也可以监听子组件触发的自定义事件。

    给组件绑定原生事件

    有时候,你可能想在某个组件的根元素上监听一个原生事件。可以使用 .native 修饰 v-on。例如:

    v-on 监听组件上自定义事件,并不会绑定到其根元素

    .sync修饰符(在父子组件数据模型之间实现双向数据绑定)

    .sync 修饰符,只是作为一个编译时的语法糖存在。它会被扩展为一个自动更新父组件属性的 v-on 侦听器。
    如下代码

    会被扩展为:

     bar = val">

    当子组件需要更新 foo 的值时,它需要显式地触发一个更新事件

    this.$emit('update:foo', newValue)
    

    例如:

      const MyComponent = Vue.extend({
      template: `
    
    
    {{count}}
    `, props: ['count'], data: function (params) { return { counter: this.count } }, methods: { onClick: function () { this.counter += 1; //emit count更新事件 this.$emit('update:count', this.counter); } } }) new Vue({ el: '#app', components: { 'my-component': MyComponent }, template: `
    {{total}}
    `, data: { total: 0 } })

    使用 v-model 绑定自定义表单组件

    默认情况下,v-model 会绑定组件的 value 属性和监听 input 事件。
    所以要让自定义组件的 v-model 生效,它应该 (在 2.2.0+ 这是可配置的):

    • 接受一个 value 属性
    • 在有新的值时触发 input 事件

    自定义计数器组件例子:

    const MyCounter = Vue.extend({
      template: `
    
    {{count}}
    `, props: ['value'], data: function () { return { count: this.value } }, methods: { decreace: function () { this.count -= 1; this.$emit('input', this.count) }, increace: function () { this.count += 1; this.$emit('input', this.count) } } }) new Vue({ el: '#app', components: { 'my-counter': MyCounter }, template: `
    {{total}}
    `, data: { total: 0 } })

    但是诸如单选框、复选框之类的输入类型可能把 value 属性用作了别的目的。model 选项来重新包装v-model默认绑定接口,可以就回避这样的冲突:

    const SelectComp = Vue.extend({
      template: `
      
      `,
      data: function () {
        return {
          selected: ''
        }
      },
      //重新包装v-model绑定接口
      model: {
        prop: 'selected',
        event: 'select'
      },
      methods: {
        onSelect: function () {
          this.$emit('select', this.selected)
        }
      }
    })
    
    new Vue({
      el: '#app',
      components: {
        'my-select': SelectComp
      },
      template: `
    
    
    {{selected}}
    `, data: { selected: '' } })

    非父子组件通信

    在简单的场景下,可以使用一个空的 Vue 实例作为中央事件总线:

    var bus = new Vue()
    
    // 触发组件 A 中的事件
    bus.$emit('id-selected', 1)
    
    // 在组件 B 创建的钩子中监听事件
    bus.$on('id-selected', function (id) {
      // ...
    })
    

    使用Slot分发内容

    为了提高组件的可扩展性和组合组件,我们可以利用Vue提供Slot分发内容来实现。
    所谓的Slot内容分发就是把自定义元素内嵌的模板插入到子组件模板slot插座中。

    image.png

    实例代码:

    const MyChild = Vue.extend({
      template: `
    

    h1内容

    ` }) new Vue({ el: '#app', components: { 'my-child': MyChild }, template: `
    Hello world!
    ` })

    效果:

    image.png

    注意分发内容只在父作用域内编译(请看slot编译内容)

    多个slot

    当父模板中有多个内容要插入到子模板中不同位置时,我们可以:

    • 在父模板中内容根元素添加slot属性,属性值为slot别名
    • 子模板中slot标签添加name属性别名

    子模板:

    
    

    父模板:

    
    

    这里可能是一个页面标题

    主要内容的一个段落。 另一个主要段落。 这里有一些联系信息

    渲染结果:

    
    

    这里可能是一个页面标题

    主要内容的一个段落。 另一个主要段落。
    这里有一些联系信息

    作用域插槽

    作用域插槽,我的理解其实就是把子组件模板中的slot看作一个“组件”,所以子组件能够向slot传递数据,就像向组件绑定数据一样。而该slot“组件”的模板声明在父级中,是具有特殊属性 scope 的

    
    

    在子组件中,只需将数据传递到插槽,就像你将 props 传递给组件一样:

    
    

    渲染以上结果,得到的输出会是:

    
    
    hello from parent hello from child

    其他

    动态组件

    通过 Vue 内置组件 ,动态地绑定到它的 is 属性,依靠 is 值,来动态切换组件:

    var vm = new Vue({
      el: '#example',
      data: {
        currentView: 'home'
      },
      components: {
        home: { /* ... */ },
        posts: { /* ... */ },
        archive: { /* ... */ }
      }
    })
    

    keep-live 缓存组件避免重新渲染

    
    

    是用在其一个直属的子组件被开关的情形。如果你在其中有 v-if 则不会工作。如果有上述的多个条件性的子元素, 要求同时只有一个子元素被渲染。

    子组件引用

    使用 ref 为子组件指定一个索引 ID。这样就可以是用父实例属性refs访问子组。

    父模板:

    
    
    var parent = new Vue({ el: '#parent' })
    // 访问子组件
    var child = parent.$refs.profile
    

    X-Template

    另一种定义模版的方式是在 JavaScript 标签里使用 text/x-template 类型,并且指定一个 id。例如:

    Vue.component('hello-world', {
      template: '#hello-world-template'
    })
    

    这在有很多模版或者小的应用中有用,否则应该避免使用,因为它将模版和组件的其他定义隔离了。

    对低开销的静态组件使用 v-once

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

    Vue.component('terms-of-service', {
    template: '
    
    

    Terms of Service

    ... a lot of static content ...
    ' })

    推荐阅读更多精彩内容

    • Vue 组件
      此文基于官方文档,里面部分例子有改动,加上了一些自己的理解 什么是组件? 组件(Component)是 Vue.j…
      陆志均阅读 2,271评论 5赞 15
    • Vue.js 2.0 Official Guide Note
      这篇笔记主要包含 Vue 2 不同于 Vue 1 或者特有的内容,还有我对于 Vue 1.0 印象不深的内容。关于…
      云之外阅读 3,297评论 0赞 29
    • vue成长之路+实战+Vue2+VueRouter2+webpack(二)vue组件入门第一节
      推荐我的vue教程:VUE系列教程目录 上篇讲解了vue-router路由入门,现在讲讲关于vue组件的内容。如果…
      言墨儿阅读 1,818评论 6赞 19
    • Vue官方教程笔记(Vue 1.X)
      1.安装 可以简单地在页面引入Vue.js作为独立版本,Vue即被注册为全局变量,可以在页面使用了。 如果希望搭建…
      Awey阅读 8,078评论 5赞 127
    • Vue组件
      测试代码 创键组件 两种方式:方法一:使用Vue.extend({}) 方法二:使用字面量 注册组件 全局注册语法…
      放风筝的小小马阅读 127评论 0赞 0
    评论0
    1赞
    赞赏

 收藏 (0) 打赏

您可以选择一种方式赞助本站

支付宝扫一扫赞助

微信钱包扫描赞助

未经允许不得转载:青梅博客 » Vue 组件

分享到: 更多 (0)
avatar

评论 抢沙发

  • QQ号
  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址
切换注册

登录

忘记密码 ?

切换登录

注册

我们将发送一封验证邮件至你的邮箱, 请正确填写以完成账号注册和激活