中国 帮助

组件使用

项目主要有两种组件使用方式:自动导入使用、手动导入使用。 补充说明: 项目已经通过 unpluginvuecomponents 自动导入 Element Plus 组件 @/components 下的业务组件是否能直接使用,取

组件使用
封面

> 本文整理自平台文档 docs/wujies/5.x/plus-ui/component_use.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-aec70b83e8cb-cover.svg)

  • - -

项目主要有两种组件使用方式:自动导入使用、手动导入使用。

  • 项目已经通过 unplugin-vue-components 自动导入 Element Plus 组件
  • @/components 下的业务组件是否能直接使用,取决于当前是否被自动扫描或是否手动引入
  • 不确定时,优先显式 import,可读性更强,也更方便排查类型问题

### 局部注册

script setup 中直接导入后即可在模板使用:

<script setup lang=ts>
</script>

<template>
</template>

### 全局注册 可以使用 [Vue 应用实例](https://cn.vuejs.org/guide/essentials/application.html) 的 .component() 方法全局注册组件。


const app = createApp({})

app.component(
  // 注册的名字
  'MyComponent',
  // 组件的实现
  {
    /* ... */
  }
)

如果使用单文件组件,你可以注册被导入的 .vue 文件:


app.component('MyComponent', MyComponent)

.component() 方法可以被链式调用:

app
  .component('ComponentA', ComponentA)
  .component('ComponentB', ComponentB)
  .component('ComponentC', ComponentC)
  • Element Plus 组件通常无需手写注册
  • @element-plus/icons-vue 图标已在启动时全局注册
  • 业务组件如 SvgIcon、Pagination、DictTag 等,使用前建议先确认项目中是否已有自动导入或统一导出约定

全局注册后的组件可以在任意模板中直接使用:

// 这在当前应用的任意组件中都可用

所有子组件也都可以继续使用这些全局组件。

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-aec70b83e8cb-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容