uni-app自定义组件详细代码示例

 更新时间:2024年02月22日 09:12:52   作者:TIGA|迪迦  
组件是vue技术中非常重要的部分,组件使得与ui相关的轮子可以方便的制造和共享,进而使得vue使用者的开发效率大幅提升,这篇文章主要给大家介绍了关于uni-app自定义组件的相关资料,需要的朋友可以参考下

前言

在uni-app中,我们可以使用Vue的组件语法来自定义组件,其中包括组件的数据、属性、事件以及方法等。自定义组件可以让我们在不同的项目中很方便地重用和修改组件,同时可以提高组件库的扩展性和应用的灵活性。

在uni-app中,我们可以在项目的component目录下存放组件,uni-app只支持vue单文件组件(.vue)。

一、注册

1、全局注册

  uni-app 支持配置全局组件,需在 main.js 里进行全局注册,注册后就可在所有页面里使用该组件。 

//main.js 里进行全局导入和注册
import Vue from 'vue'
import pageHead from './components/page-head.vue'
Vue.component('page-head',pageHead)

//index.vue 里可直接使用组件
<template>
	<view>
		<page-head></page-head>
	</view>
</template>

2、局部注册

页面引入组件有两种方式,推荐使用 easycom 方式引入。

1.传统vue规范 

在 index.vue 页面中,通过 import 方式引入组件 ,在 components 选项中定义你想要使用的组件。

	<!-- 在index.vue引入 uni-badge 组件-->
	<template>
		<view>
            <!-- 3.使用组件 -->
			<uni-badge text="1"></uni-badge>
		</view>
	</template>
	<script>
        //1.导入组件(这步属于传统vue规范,但在uni-app的easycom下可以省略这步)
		import uniBadge from '@/components/uni-badge/uni-badge.vue';
		export default {
            //2.注册组件(这步属于传统vue规范,但在uni-app的easycom下可以省略这步) 
			components:{uniBadge }
		}
	</script>

 2.easycom 方式

将组件引入精简为一步。只要组件安装在项目的 components 目录下,并符合 components/组件名称/组件名称.vue 目录结构。就可以不用引用、注册,直接在页面中使用。

	<!-- 在index.vue引入 uni-badge 组件-->
	<template>
		<view>
            <!-- 直接使用组件 -->
			<uni-badge text="1"></uni-badge>
		</view>
	</template>
	<script>
		// 这里不用import引入,也不需要在components内注册uni-badge组件。template里就可以直接用
		export default {
			data() {
				return {
				}
			}
		}
	</script>

二、父子组件通信

父子组件之间的通信有两种方式:父传子和子传父。其中,父传子的方式是通过props来实现的,子组件通过props来接收外界传递到组件内部的值。而子传父的方式则是通过$emit触发事件进行传递参数,父组件通过监听这个事件来接收子组件传递过来的数据 。

父传子组件的示例代码:

父组件通过props属性将message传递给子组件。子组件则通过props接收这个值并在模板中显示出来。

<!-- 父组件 -->
<template>
  <div>
    <child-component :message="parentMessage"></child-component>
  </div>
</template>

<script>
import ChildComponent from './ChildComponent.vue';
export default {
  components: {
    ChildComponent,
  },
  data() {
    return {
      parentMessage: 'Hello from parent!',
    };
  },
};
</script>


<!-- 子组件 -->
<template>
  <div>
    {{ message }}
  </div>
</template>

<script>
export default {
  props: ['message'],
};
</script>

子传父组件的示例代码:

子组件通过$emit触发了一个名为childEvent的事件,并将数据作为参数传递给父组件。父组件则通过监听这个事件来接收子组件传递过来的数据,并在handleChildEvent方法中进行处理。

<!-- 父组件 -->
<template>
  <div>
    <child-component @childEvent="handleChildEvent"></child-component>
  </div>
</template>

<script>
import ChildComponent from './ChildComponent.vue';
export default {
  components: {
    ChildComponent,
  },
  methods: {
    handleChildEvent(data) {
      console.log('Received data from child component:', data);
    },
  },
};
</script>

<!-- 子组件 -->
<template>
  <div>
    <button @click="sendDataToParent">Send data to parent</button>
  </div>
</template>

<script>
export default {
  methods: {
    sendDataToParent() {
      const data = 'Hello from child!';
      this.$emit('childEvent', data);
    },
  },
};
</script>

三、uni.$on与uni.$emit

uni.$on是uni-app中的一个全局事件监听方法,用于在页面或组件外部监听指定事件的触发。当事件被触发时,会执行传入的回调函数。使用uni.$on方法可以避免在每个页面或组件中都手动注册和注销事件监听器的问题,提高了代码的复用性和可维护性。

uni.$emit是一个全局事件触发器,用于向父组件或全局事件触发器发送事件。

示例代码:

//子组件触发自定义事件
<template>
  <div>
    <button @click="sendDataToParent">Send data to parent</button>
  </div>
</template>

<script>
export default {
  methods: {
    sendDataToParent() {
      const data = 'Hello from child!';
      uni.$emit('childEvent', data); // 触发自定义事件
    },
  },
};
</script>

// 在父组件中监听子组件触发的自定义事件
export default {
  onLoad() {
    uni.$on('childEvent', this.handleChildEvent); // 注册事件监听器
  },
  beforeDestroy() {
    uni.$off('childEvent', this.handleChildEvent); // 注销事件监听器
  },
  methods: {
    handleChildEvent(data) {
      console.log('Received data from child component:', data);
    },
  },
};

四、slot插槽

 插槽是一种用于向子组件传递内容的方式。插槽实质是对子组件的扩展,父组件通过slot插槽向子组件内部指定位置传递内容。插槽显不显示、怎样显示是由父组件来控制的,而插槽在哪里显示就由子组件来进行控制。

插槽的示例代码:

<!-- 子组件 -->
<template>
  <div>
    <slot name="header"></slot> <!-- 使用具名插槽 -->
    <slot></slot> <!-- 使用默认插槽 -->
    <slot name="footer"></slot> <!-- 使用具名插槽 -->
  </div>
</template>

<script>
export default {};
</script>

<!-- 父组件 -->
<template>
  <div>
    <child-component>
      <template v-slot:header>
        <h2>组件的头部</h2>
      </template>
      <p>组件的内容。</p>
      <template v-slot:footer>
        <button @click="handleClick">点击我</button>
      </template>
    </child-component>
  </div>
</template>

<script>
import ChildComponent from './ChildComponent.vue';
export default {
  components: {
    ChildComponent
  },
};
</script>

五、ref 

被用来给元素或子组件注册引用信息,引用信息将会注册在父组件的 $refs 对象上。

如果在普通的 DOM 元素上使用,引用指向的就是 DOM 元素;如果用在子组件上,引用就指向组件实例。在非H5端,只能用于获取自定义组件实例,不能用于获取内置组件实例(如:view、text)。

<!-- 非H5端不支持通过this.$refs.content来获取view实例 -->
<view ref="content">hello</view>

<!-- 支持通过this.$refs.child来获取child-component实例 -->
<child-component ref="child"></child-component>

代码示例:

<!-- base-input子组件页面 -->
<template>
	<view>
		<input :focus="isFocus" type="text" placeholder="请输入内容" />
	</view>
</template>
<script>
	export default {
		name:"base-input",
		data() {
			return {
				"isFocus":false
			};
		},
		methods:{
			focus(){
				this.isFocus = true
			}
		}
	}
</script>

<!-- index 父组件页面 -->
<template>
	<view>
		<base-input ref="usernameInput"></base-input>
		<button type="default" @click="getFocus">获取焦点</button> 
	</view>
</template>
<script>
	export default {
		methods:{
			getFocus(){
				//通过组件定义的ref调用focus方法
				this.$refs.usernameInput.focus()
			}
		}
	}
</script>

总结 

到此这篇关于uni-app自定义组件的文章就介绍到这了,更多相关uni-app自定义组件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • vue中的slot-scope及scope.row用法

    vue中的slot-scope及scope.row用法

    这篇文章主要介绍了vue中的slot-scope及scope.row用法,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-07-07
  • vue3集成Element-plus实现按需自动引入组件的方法总结

    vue3集成Element-plus实现按需自动引入组件的方法总结

    vue3出来一段时间了,element也更新了版本去兼容vue3,下面这篇文章主要给大家介绍了关于vue3集成Element-plus实现按需自动引入组件的相关资料,文中通过示例代码介绍的非常详细,需要的朋友可以参考下
    2022-07-07
  • vue项目实现中英文切换的详细步骤

    vue项目实现中英文切换的详细步骤

    这篇文章主要给大家介绍了关于vue项目实现中英文切换的详细步骤,项目中经常有中英文切换的功能,接下来就简单实现以下这个功能,文中通过代码介绍的非常详细,需要的朋友可以参考
    2023-11-11
  • Vue 数据绑定的原理分析

    Vue 数据绑定的原理分析

    这篇文章主要介绍了Vue 数据绑定的原理,帮助大家更好的理解和使用vue框架,感兴趣的朋友可以了解下
    2020-11-11
  • vuex如何修改状态state的方法

    vuex如何修改状态state的方法

    这篇文章主要介绍了vuex如何修改状态state的方法,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-08-08
  • Vue3使用ref与reactive创建响应式对象的示例代码

    Vue3使用ref与reactive创建响应式对象的示例代码

    这篇文章主要详细介绍了Vue3使用ref与reactive创建响应式对象的方法步骤,文中通过代码示例和图文结合的方式给大家介绍的非常详细,具有一定的参考价值,需要的朋友可以参考下
    2024-02-02
  • Vue实现todo应用的示例

    Vue实现todo应用的示例

    这篇文章主要介绍了Vue实现todo应用的示例,帮助大家更好的理解和学习使用vue框架,感兴趣的朋友可以了解下
    2021-02-02
  • vant使用datetime-picker组件设置maxDate和minDate的坑及解决

    vant使用datetime-picker组件设置maxDate和minDate的坑及解决

    这篇文章主要介绍了vant使用datetime-picker组件设置maxDate和minDate的坑及解决方案,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-12-12
  • 对Vue3中reactive的深入理解

    对Vue3中reactive的深入理解

    这篇文章主要介绍了对Vue3中reactive的深入理解,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-05-05
  • Vue中$refs的用法详解

    Vue中$refs的用法详解

    这篇文章主要介绍了Vue中$refs的用法,非常不错,具有一定的参考借鉴价值 ,需要的朋友可以参考下
    2018-06-06

最新评论