Vue 组件基础用法

在 Vue.js 开发中,组件是构建大型应用的核心概念之一。通过将页面拆分成一个个独立的、可复用的组件,我们可以提高代码的可维护性和可扩展性。本文将详细介绍 Vue 组件的基础用法,包括组件的定义、注册、使用以及一些常见的实践和最佳实践。

目录#

  1. 组件的定义
  2. 组件的注册
    • 全局注册
    • 局部注册
  3. 组件的使用
  4. 组件的 props
    • props 的定义
    • props 的验证
  5. 组件的事件
    • 自定义事件
    • 事件修饰符
  6. 组件的插槽
    • 匿名插槽
    • 具名插槽
    • 作用域插槽
  7. 常见实践与最佳实践
  8. 参考

1. 组件的定义#

在 Vue 中,组件可以通过 Vue.component 方法(全局注册)或在 components 选项中(局部注册)来定义。一个基本的组件定义包含模板(template)、数据(data,必须是一个函数)、方法(methods)等部分。

// 全局注册组件示例
Vue.component('my-component', {
  template: '<div>这是一个自定义组件</div>',
  data() {
    return {
      message: 'Hello from component'
    };
  },
  methods: {
    sayHello() {
      console.log(this.message);
    }
  }
});

2. 组件的注册#

全局注册#

使用 Vue.component 方法进行全局注册后,该组件在整个 Vue 应用中都可以使用。

// 全局注册
Vue.component('global-component', {
  template: '<div>我是全局组件</div>'
});

局部注册#

在某个 Vue 实例的 components 选项中注册,仅在该实例及其子组件中可用。

new Vue({
  el: '#app',
  components: {
    'local-component': {
      template: '<div>我是局部组件</div>'
    }
  }
});

3. 组件的使用#

在模板中,直接使用注册好的组件标签即可。

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

4. 组件的 props#

props 的定义#

组件通过 props 接收父组件传递的数据。

Vue.component('props-component', {
  props: ['name'],
  template: '<div>你好,{{ name }}</div>'
});

在父组件中使用:

<div id="app">
  <props-component name="Vue 学习者"></props-component>
</div>

props 的验证#

可以对 props 的类型、是否必需等进行验证。

Vue.component('validated-props-component', {
  props: {
    age: {
      type: Number,
      required: true,
      default: 18 // 可选默认值
    }
  },
  template: '<div>年龄:{{ age }}</div>'
});

5. 组件的事件#

自定义事件#

子组件通过 $emit 触发自定义事件,父组件通过 v-on 监听。

子组件:

Vue.component('event-component', {
  methods: {
    sendEvent() {
      this.$emit('custom-event', '事件数据');
    }
  },
  template: '<button @click="sendEvent">触发事件</button>'
});

父组件:

<div id="app">
  <event-component @custom-event="handleEvent"></event-component>
</div>
<script>
new Vue({
  el: '#app',
  methods: {
    handleEvent(data) {
      console.log('接收到事件数据:', data);
    }
  }
});
</script>

事件修饰符#

如 .stop(阻止事件冒泡)、.prevent(阻止默认行为)等。

<button @click.stop="doSomething">点击我阻止冒泡</button>

6. 组件的插槽#

匿名插槽#

父组件可以向子组件的插槽插入内容。

子组件:

Vue.component('slot-component', {
  template: `
    <div>
      <slot></slot>
    </div>
  `
});

父组件:

<div id="app">
  <slot-component>
    <p>这是插入到插槽的内容</p>
  </slot-component>
</div>

具名插槽#

给插槽命名,方便父组件更精准地插入内容。

子组件:

Vue.component('named-slot-component', {
  template: `
    <div>
      <slot name="header"></slot>
      <slot></slot>
      <slot name="footer"></slot>
    </div>
  `
});

父组件:

<div id="app">
  <named-slot-component>
    <template v-slot:header>
      <h1>标题</h1>
    </template>
    <p>主体内容</p>
    <template v-slot:footer>
      <p>页脚</p>
    </template>
  </named-slot-component>
</div>

作用域插槽#

子组件可以将数据传递给插槽,让父组件决定如何渲染。

子组件:

Vue.component('scope-slot-component', {
  data() {
    return {
      items: [1, 2, 3]
    };
  },
  template: `
    <div>
      <slot v-for="item in items" :item="item">{{ item }}</slot>
    </div>
  `
});

父组件:

<div id="app">
  <scope-slot-component>
    <template v-slot:default="slotProps">
      <span>{{ slotProps.item * 2 }}</span>
    </template>
  </scope-slot-component>
</div>

7. 常见实践与最佳实践#

  • 组件拆分:将复杂页面拆分成多个小而功能单一的组件,提高复用性。
  • props 验证:始终对 props 进行验证,确保数据的正确性。
  • 事件命名规范:自定义事件名采用小写加 - 形式(如 custom - event)。
  • 插槽合理使用:根据需求选择合适的插槽类型,避免过度复杂。

8. 参考#