uni-app 组件创建、引入与使用完整指南

作者:组件花园时间:2026-10-30 23:27:50浏览:294

本文详细记录了 uni-app 中创建和使用组件的标准流程。涵盖从在 components 目录建立 .vue 文件,到通过 import 或 usingComponents 注册组件,再到页面中调用及传递 props 参数的具体操作。包含 HBuilderX 创建、全局/局部注册及 JSON 配置等多种方式,适用于初学者快速掌握 uni-app 组件化开发。

uni-app 组件创建与引入步骤

在 uni-app 开发中,组件化是构建应用的核心方式之一。

以下是使用组件的具体操作步骤:

第一步,在 uni-app 项目中创建所需的组件。

  • 通常可以在项目的 components 文件夹下新建一个 .vue 文件来定义组件。
  • 此外,开发者也可以利用 HBuilderX 提供的模板或向导功能来快速生成组件文件。

第二步,在需要调用该组件的页面或父组件中进行引入。

  • 可以使用 import 语句导入组件,例如:import componentName from '@/components/componentName.vue';

或者,也可以通过 usingComponents 选项来注册全局或局部组件,示例如下:

export default {
    usingComponents: {
        'component-name': '@/components/componentName.vue'
    }
}

第三步,在目标页面的模板中添加对应的组件标签,例如:

<template>
    <view>
        <component-name></component-name>
    </view>
</template>

完成上述配置后,运行 uni-app 应用即可在相应页面中渲染出该组件。

需要注意,组件标签的名称必须与导入或注册时的名称完全一致,且首字母需小写。同时,在组件内部可以通过 props 属性接收外部传递的数据,从而实现动态渲染不同内容的功能。

uni-app 自定义组件详细使用方法

附:uni-app 自定义组件的详细使用方法

Uni-app 支持创建和使用自定义组件,具体步骤如下:

  • 首先,在项目的 components 目录下新建一个自定义组件的文件夹,例如命名为 my-component。
  • 接着,在 my-component 文件夹内创建一个名为 my-component.vue 的文件,该文件即为自定义组件的代码载体。
  • 在 my-component.vue 文件中编写组件逻辑,可充分利用 Vue.js 的语法特性及组件化开发理念。
  • 在需要使用该自定义组件的页面中,可通过以下两种方式进行引入:
  • 方式一:在页面的 script 标签中使用 import 导入组件:
<template>
  <view>
    <my-component/>
  </view>
</template>
<script>
import MyComponent from '@/components/my-component/my-component.vue'
export default {
  components: {
    MyComponent
  }
}
</script>
  • 方式二:在页面的 json 配置文件中注册组件:
{
  "usingComponents": {
    "my-component": "@/components/my-component/my-component"
  }
}
  • 最后,在页面模板中使用 my-component 标签。根据实际需求,可以向组件传递 props 属性或监听其触发的事件。

总结

本文介绍了 uni-app 使用组件的相关步骤,更多相关内容可参考本站往期文章或继续浏览后续教程,感谢大家的支持!

作者最新文章