VueJs3中能否将数组作为model传递给组件?求用户列表滑动组件实现示例
实现核心思路
这个需求实现难度很低,属于Vue3入门级组件开发范畴,不需要引入第三方动效库,用Vue3内置能力即可完整实现,核心逻辑拆分为三点:
- 通过
props接收父组件传入的用户数组,完成列表的基础结构渲染 - 借助Vue内置的
<Transition>组件配合原生CSS,实现列表从屏幕外滑入展示、点击按钮滑出屏幕的动效 - 在组件内部维护独立的显示状态变量,绑定给组件内置的控制按钮,点击即可切换状态触发对应动效
可直接复用的示例代码
代码分为父组件传参、UserList子组件实现两部分,完全适配Vue3的<script setup>写法,没有复杂逻辑:
父组件(
App.vue),负责传入用户数组<template> <!-- 传入用户数组给自定义用户列表组件 --> <UserList :user-list="testUsers" /> </template> <script setup> import { ref } from 'vue' import UserList from './components/UserList.vue' // 模拟业务场景里的用户数据 const testUsers = ref([ { id: 1, name: '张三', email: 'zhangsan@demo.com' }, { id: 2, name: '李四', email: 'lisi@demo.com' }, { id: 3, name: '王五', email: 'wangwu@demo.com' } ]) </script>核心UserList子组件(
components/UserList.vue),内置滑入滑出逻辑和控制按钮<template> <!-- 常驻的控制按钮,点击切换列表显示状态 --> <button class="toggle-btn" @click="isShowList = !isShowList"> {{ isShowList ? '收起列表' : '展开列表' }} </button> <!-- Transition组件包裹动效目标,name和CSS里的动画类名对应 --> <Transition name="slide"> <div v-if="isShowList" class="user-panel"> <div class="user-item" v-for="user in userList" :key="user.id"> <p>用户姓名:{{ user.name }}</p> <p>联系邮箱:{{ user.email }}</p> </div> </div> </Transition> </template> <script setup> import { ref } from 'vue' // 接收父组件传入的用户数组,加基础类型校验避免传参错误 const props = defineProps({ userList: { type: Array, required: true, default: () => [] } }) // 列表显示状态,默认值为true即页面加载完成自动滑入展示 const isShowList = ref(true) </script> <style scoped> .toggle-btn { padding: 8px 16px; margin: 24px; cursor: pointer; } .user-panel { /* 固定定位让列表悬浮在页面侧边,方便做滑入滑出效果 */ position: fixed; right: 0; top: 0; height: 100vh; width: 320px; background: #f5f5f5; padding: 24px; box-shadow: -2px 0 10px rgba(0, 0, 0, 0.1); } .user-item { padding: 12px 0; border-bottom: 1px solid #e5e5e5; } /* 定义滑入滑出的动画逻辑 */ .slide-enter-from, .slide-leave-to { transform: translateX(100%); /* 动画起点/终点:完全位于屏幕右侧外 */ } .slide-enter-active, .slide-leave-active { transition: all 0.3s ease; /* 动画时长和缓动曲线,可自行调整 */ } </style>
实现时的常见踩坑提醒
- 动效必须配合
v-if使用,不要替换成v-show,否则Vue的Transition组件无法正确识别元素的离开动画,会出现滑出失效的问题 - 动画的方向、速度、列表位置都可以通过修改CSS参数调整:比如要从屏幕左侧滑入,把transform的位移值改成
translateX(-100%)即可 - 如果需要页面加载完成后延迟一段时间再滑入列表,只需要把
isShowList的初始值改成ref(false),在onMounted钩子里搭配定时器,延迟指定时间后把值改为true即可
内容的提问来源于stack exchange,提问作者Doglas
相关产品推荐
相关产品推荐

